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

Новое в версии 2.3.

Описание
Требования
Параметры
Примеры
Возвращаемые значения
Статус

Описание

Создание, обновление и удаление записей DNS с помощью обновлений DDNS
DDNS хорошо работает как с bind, так и с Microsoft DNS (см. https://technet.microsoft.com/ru-ru/library/cc961412.aspx)

Требования

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

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 - добавлено в 2.5	По умолчанию: 53	Используйте этот TCP порт при подключении к `server`.
protocol - добавлено в 2.8	Варианты: tcp ← udp	Устанавливает протокол передачи (TCP или UDP). TCP рекомендуется и является более надежным вариантом.
record - / обязательно		Устанавливает запись DNS для изменения. Если зона опущена, она должна быть абсолютной (заканчиваться точкой).
server - / обязательно		Применить изменение DNS на этом сервере.
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"
  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"
  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
  nsupdate:
    key_name: "nsupdate"
    key_secret: "+bFQtBCta7j2vWkjPkAFtgA=="
    server: "10.1.1.1"
    zone: "example.org"
    record: "puppet"
    type: "CNAME"
    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.

Статус

Гарантируется, что интерфейс этого модуля будет обратно совместим. [превью]
Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

Лоик Блот (@nerzhul)

Подсказка

Если вы обнаружите какие-либо проблемы в этой документации, вы можете изменить этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/nsupdate_module.html