theforeman.foreman.hostgroups

This role creates and manages Hostgroups.

Role Variables

This role supports the Common Role Variables.

  • foreman_hostgroups: List of hostgroups to manage that are each represented as a dictionary. See module documentation for a list of available options for each hostgroup. Hostgroups may have any set of fields defined on them and may optionally define a parent for nested hostgroups. A variety of examples are demonstrated in the data structure below:

foreman_hostgroups:
  - name: "Basic example"
    architecture: "x86_64"
    operatingsystem: "CentOS"
    medium: "media_name"
    ptable: "partition_table_name"
  - name: "Proxies hostgroup"
    environment: production
    puppet_proxy: puppet-proxy.example.com
    puppet_ca_proxy: puppet-proxy.example.com
    openscap_proxy: openscap-proxy.example.com
  - name: "CentOS 7"
    organization: "Default Organization"
    lifecycle_environment: "Production"
    content_view: "CentOS 7"
    activation_keys: centos-7
  - name: "Webserver"
    parent: "CentOS 7"
    environment: production
    puppet_proxy: puppet-proxy.example.com
    puppet_ca_proxy: puppet-proxy.example.com
    openscap_proxy: openscap-proxy.example.com

Example Playbooks

This example creates several hostgroups with some nested examples.

- hosts: localhost
  roles:
    - role: theforeman.foreman.hostgroups
      vars:
        foreman_server_url: https://foreman.example.com
        foreman_username: "admin"
        foreman_password: "changeme"
        foreman_hostgroups:
          - name: "Basic example"
            architecture: "x86_64"
            operatingsystem: "CentOS"
            medium: "media_name"
            ptable: "partition_table_name"
          - name: "Proxies hostgroup"
            environment: production
            puppet_proxy: puppet-proxy.example.com
            puppet_ca_proxy: puppet-proxy.example.com
            openscap_proxy: openscap-proxy.example.com
          - name: "CentOS 7"
            organization: "Default Organization"
            lifecycle_environment: "Production"
            content_view: "CentOS 7"
            activation_keys: centos-7
          - name: "Webserver"
            parent: "CentOS 7"
            environment: production
            puppet_proxy: puppet-proxy.example.com
            puppet_ca_proxy: puppet-proxy.example.com
            openscap_proxy: openscap-proxy.example.com