nsupdate — Управление записями DNS.
Новое в версии 2.3.
Описание
- Создание, обновление и удаление записей DNS с помощью обновлений DDNS
- DDNS хорошо работает как с bind, так и с Microsoft DNS (см. https://technet.microsoft.com/ru-ru/library/cc961412.aspx)
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- dnspython
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| key_algorithm |
|
Укажите алгоритм ключа, используемый
key_secret.
|
| key_name |
Используйте имя ключа TSIG для аутентификации по DNS
server.
|
|
| key_secret |
Используйте секрет ключа TSIG, связанный с
key_name, для аутентификации по server.
|
|
|
port
(добавлено в 2.5)
|
Значение по умолчанию:
53
|
Используйте этот TCP-порт при подключении к
server.
|
|
record
обязательно
|
Устанавливает запись DNS для изменения.
|
|
|
server
обязательно
|
Применить изменение DNS на этом сервере.
|
|
| state |
|
Управление записью DNS.
|
| ttl |
Значение по умолчанию:
3600
|
Устанавливает TTL записи.
|
| type |
Значение по умолчанию:
"A"
|
Устанавливает тип записи.
|
| value |
Устанавливает значение записи.
|
|
|
zone
обязательно
|
Запись DNS будет изменена на этой
zone.
|
Примеры
- 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
строка
|
success |
Если модуль изменил запись
|
|
dns_rc
целое число
|
всегда |
код возврата dnspython
Пример:
4
|
|
dns_rc_str
строка
|
всегда |
код возврата dnspython (строковое представление)
Пример:
REFUSED
|
|
record
строка
|
success |
Запись DNS
Пример:
ansible
|
|
ttl
целое число
|
success |
TTL записи DNS
Пример:
86400
|
|
type
строка
|
success |
Тип записи DNS
Пример:
CNAME
|
|
value
список
|
success |
Значение(я) записи DNS
Пример:
192.168.1.1
|
|
zone
строка
|
success |
Зона записи DNS
Пример:
example.org.
|
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что его поддерживает сообщество Ansible. См. Техническое обслуживание и поддержка модулей для получения дополнительной информации.
Список других модулей, поддерживаемых сообществом 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.6/modules/nsupdate_module.html
