nsupdate - Управление записями DNS.
Новая в версии 2.3.
Обзор
- Создание, обновление и удаление записей DNS с помощью обновлений DDNS
- DDNS хорошо работает как с bind, так и с Microsoft DNS (см. https://technet.microsoft.com/en-us/library/cc961412.aspx)
Требования (к хосту, на котором выполняется модуль)
- dnspython
Параметры
| параметр | обязательный | значение по умолчанию | варианты | комментарии |
|---|---|---|---|---|
| key_algorithm | нет | hmac-md5 |
| Укажите алгоритм ключа, используемый key_secret. |
| key_name | нет | Используйте имя ключа TSIG для аутентификации с DNS server
| ||
| key_secret | нет | Используйте секрет ключа TSIG, связанный с key_name, для аутентификации с server
| ||
| record | да | Устанавливает запись DNS для изменения. | ||
| server | да | Применить изменение DNS на этом сервере. | ||
| state | нет | present |
| Управление записью DNS. |
| ttl | нет | 3600 | Устанавливает TTL записи. | |
| type | нет | A | Устанавливает тип записи. | |
| value | нет | None | Устанавливает значение записи. | |
| 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: 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 и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/nsupdate_module.html