30.6. 使用 Ansible 确保在 IdM 中存在多个 CNAME 记录

规范名称记录（CNAME 记录）是域名系统(DNS)中的一种资源记录类型，其将域名、别名映射到另一个名称，即规范名称。

当从单个 IP 地址运行多个服务时，您可能会发现 CNAME 记录很有用：例如，FTP 服务和 Web 服务，每个服务在不同的端口上运行。

本节展示了身份管理(IdM)管理员如何使用 Ansible playbook 来确保 IdM DNS 中存在多个 CNAME 记录。在以下流程使用的示例中，host03 既是 HTTP 服务器又是 FTP 服务器。IdM 管理员确保在 idm.example.com 区域中存在 host03 A 记录的 www 和 ftp CNAME 记录。

先决条件

  • 您已配置了 Ansible 控制节点以满足以下要求：

    • 您使用 Ansible 版本 2.8 或更高版本。
    • 您已在 Ansible 控制器上安装了 ansible-freeipa 软件包。
    • 示例假定在 ~/MyPlaybooks/ 目录中，您已创建了一个带有 IdM 服务器的完全限定域名(FQDN)的 Ansible 清单文件。
    • 示例假定 secret.yml Ansible vault 存储了 ipaadmin_password。
  • 您知道 IdM 管理员密码。
  • idm.example.com 区域存在，并由 IdM DNS 管理。有关在 IdM DNS 中添加主 DNS 区域的更多信息，请参阅 使用 Ansible playbook 来管理 IdM DNS 区域。
  • host03 A 记录存在于 idm.example.com 区域中。

流程

  1. 导航到 /usr/share/doc/ansible-freeipa/playbooks/dnsrecord 目录： 

    $ cd /usr/share/doc/ansible-freeipa/playbooks/dnsrecord

  2. 打开清单文件，并确保 [ipaserver] 部分中列出了您要配置的 IdM 服务器。例如，要指示 Ansible 配置 server.idm.example.com，请输入： 

    [ipaserver]
server.idm.example.com

  3. 制作一份 ensure-CNAME-record-is-present.yml Ansible playbook 文件的副本。例如： 

    $ cp ensure-CNAME-record-is-present.yml ensure-CNAME-record-is-present-copy.yml
  4. 打开 ensure-CNAME-record-is-present-copy.yml 文件进行编辑。

  5. 通过在 ipadnsrecord 任务部分中设置以下变量来调整文件：

    • （可选）调整 play 的 name 提供的描述。
    • 将 ipaadmin_password 变量设为 IdM 管理员密码。
    • 将 zone_name 变量设为 idm.example.com。

    • 在 records 变量部分中，设置以下变量和值：

      • 将 name 变量设为 www。
      • 将 cname_hostname 变量设为 host03。
      • 将 name 变量设为 ftp。
      • 将 cname_hostname 变量设为 host03。

      这是当前示例修改的 Ansible playbook 文件： 

    ---
- 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:
  - ipadnsrecord:
      ipaadmin_password: "{{ ipaadmin_password }}"
      zone_name: idm.example.com
      records:
      - name: www
        cname_hostname: host03
      - name: ftp
        cname_hostname: host03
  6. 保存该文件。

  7. 运行 playbook: 

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

其它资源

  • 请参阅 /usr/share/doc/ansible-freeipa/ 目录中的 README-dnsrecord.md 文件。
  • 请参阅 /usr/share/doc/ansible-freeipa/playbooks/dnsrecord 目录中的 Ansible playbook 示例。