8.6. Ensuring the presence of multiple CNAME records in IdM using Ansible

Procedure

1. Navigate to the /usr/share/ansible/collections/ansible_collections/freeipa/ansible_freeipa/playbooks/dnsrecord directory:

   $ cd /usr/share/ansible/collections/ansible_collections/freeipa/ansible_freeipa/playbooks/dnsrecord

2. Make a copy of the ensure-CNAME-record-is-present.yml Ansible playbook file. For example:

   $ cp ensure-CNAME-record-is-present.yml ensure-CNAME-record-is-present-copy.yml

3. Open the ensure-CNAME-record-is-present-copy.yml file for editing.

4. Adapt the file by setting the following variables in the freeipa.ansible_freeipa.ipadnsrecord task section:

   • Optional: Adapt the description provided by the name of the play.
   • Indicate that the value of the ipaadmin_password variable is defined in the secret.yml Ansible vault file.
   • Set the zone_name variable to idm.example.com.

   • In the records variable section, set the following variables and values:

     • Set the name variable to www.
     • Set the cname_hostname variable to host03.
     • Set the name variable to ftp.
     • Set the cname_hostname variable to host03.

     This is the modified Ansible playbook file for the current example:

   ---
   - name: Ensure that 'www.idm.example.com' and 'ftp.idm.example.com' CNAME records point to 'host03.idm.example.com'.
     hosts: ipaserver
     become: true
     gather_facts: false
   
     tasks:
     - freeipa.ansible_freeipa.ipadnsrecord:
         ipaadmin_password: "{{ ipaadmin_password }}"
         zone_name: idm.example.com
         records:
         - name: www
           cname_hostname: host03
         - name: ftp
           cname_hostname: host03

5. Save the file.

   For details about variables and example playbooks in the FreeIPA Ansible collection, see the /usr/share/ansible/collections/ansible_collections/freeipa/ansible_freeipa/README-dnsrecord.md file and the /usr/share/ansible/collections/ansible_collections/freeipa/ansible_freeipa/playbooks/dnsrecord directory on the control node.

6. Run the playbook:

   $ ansible-playbook --vault-password-file=password_file -v -i inventory.file ensure-CNAME-record-is-present.yml