community.general.nsupdate – Управление записями DNS.

Примечание

Этот плагин входит в коллекцию community.general (версия 2.0.1).

Для его установки используйте: ansible-galaxy collection install community.general.

Для использования в книге задач укажите: community.general.nsupdate.

Обзор
Требования
Параметры
Примеры
Значения возврата

Обзор

Создание, обновление и удаление записей DNS с помощью обновлений DDNS

Требования

Ниже приведены требования к хосту, на котором выполняется этот модуль.

dnspython

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
key_algorithm строка	Варианты: HMAC-MD5.SIG-ALG.REG.INT hmac-md5 ← hmac-sha1 hmac-sha224 hmac-sha256 hmac-sha384 hmac-sha512	Укажите алгоритм ключа, используемый `key_secret`.
key_name строка		Используйте имя ключа TSIG для аутентификации против DNS `server`.
key_secret строка		Используйте секрет ключа TSIG, связанный с `key_name`, для аутентификации против `server`.
port строка	Значение по умолчанию: 53	Используйте этот TCP порт при подключении к `server`.
protocol строка	Варианты: tcp ← udp	Устанавливает транспортный протокол (TCP или UDP). TCP — рекомендуемый и более надежный вариант.
record строка / обязательно		Устанавливает запись DNS для изменения. При отсутствии зоны, она должна быть абсолютной (заканчиваться точкой).
server строка / обязательно		Применяйте изменения DNS на этом сервере, указанном по IPv4 или IPv6 адресу.
state строка	Варианты: present ← absent	Управление записью DNS.
ttl строка	Значение по умолчанию: 3600	Устанавливает TTL записи.
type строка	Значение по умолчанию: "A"	Устанавливает тип записи.
value строка		Устанавливает значение записи.
zone строка		Запись DNS будет изменена в этой `zone`. При отсутствии, DNS будет запрошен для поиска правильной зоны. Начиная с Ansible 2.7 этот параметр является необязательным.

Примеры

- name: Add or modify ansible.example.org A to 192.168.1.1"
  community.general.nsupdate:
    key_name: "nsupdate"
    key_secret: "+bFQtBCta7j2vWkjPkAFtgA=="
    server: "10.1.1.1"
    zone: "example.org"
    record: "ansible"
    value: "192.168.1.1"

- name: Add or modify ansible.example.org A to 192.168.1.1, 192.168.1.2 and 192.168.1.3"
  community.general.nsupdate:
    key_name: "nsupdate"
    key_secret: "+bFQtBCta7j2vWkjPkAFtgA=="
    server: "10.1.1.1"
    zone: "example.org"
    record: "ansible"
    value: ["192.168.1.1", "192.168.1.2", "192.168.1.3"]

- name: Remove puppet.example.org CNAME
  community.general.nsupdate:
    key_name: "nsupdate"
    key_secret: "+bFQtBCta7j2vWkjPkAFtgA=="
    server: "10.1.1.1"
    zone: "example.org"
    record: "puppet"
    type: "CNAME"
    state: absent

- name: Add 1.1.168.192.in-addr.arpa. PTR for ansible.example.org
  community.general.nsupdate:
    key_name: "nsupdate"
    key_secret: "+bFQtBCta7j2vWkjPkAFtgA=="
    server: "10.1.1.1"
    record: "1.1.168.192.in-addr.arpa."
    type: "PTR"
    value: "ansible.example.org."
    state: present

- name: Remove 1.1.168.192.in-addr.arpa. PTR
  community.general.nsupdate:
    key_name: "nsupdate"
    key_secret: "+bFQtBCta7j2vWkjPkAFtgA=="
    server: "10.1.1.1"
    record: "1.1.168.192.in-addr.arpa."
    type: "PTR"
    state: absent

Значения возврата

Общие значения возврата описаны здесь, следующие — поля, уникальные для этого модуля:

Ключ	Возвращаемое значение	Описание
changed строка	успех	Если модуль изменил запись
dns_rc целое число	всегда	код возврата dnspython Пример: 4
dns_rc_str строка	всегда	код возврата dnspython (строковое представление) Пример: REFUSED
record строка	успех	Запись DNS Пример: ansible
ttl целое число	успех	TTL записи DNS Пример: 86400
type строка	успех	Тип записи DNS Пример: CNAME
value список / элементы=строка	успех	Значение(я) записи DNS Пример: 192.168.1.1
zone строка	успех	Зона записи DNS Пример: example.org.

Авторы

Loic Blot (@nerzhul)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/nsupdate_module.html