theforeman.foreman.domains

This role creates and manages Domains.

Role Variables

This role supports the Common Role Variables.

The main data structure for this role is the list of foreman_domains. Each domain requires the following fields:

  • name: The name of the domain.

The following fields are optional and will be omitted by default:

  • description: Description of the domain.

  • dns_proxy: DNS proxy to use within this domain for managing A records.

  • parameters: Domain specific host parameters.

Example Playbook

Create a domain example.org.

- hosts: localhost
  roles:
    - role: theforeman.foreman.domains
      vars:
        foreman_server_url: https://foreman.example.com
        foreman_username: "admin"
        foreman_password: "changeme"
        foreman_domains:
          - name: "example.org"
            description: "Example Domain"
            locations:
              - "Uppsala"
            organizations:
              - "ACME"