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`.
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. [сообщество]

Авторы

Loic Blot (@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.7/modules/nsupdate_module.html