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 | По умолчанию: 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: 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. |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется обратной совместимости.
Автор
- 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.5/modules/nsupdate_module.html
