nsupdate – Управление записями DNS
Обзор
- Создание, обновление и удаление записей DNS с помощью обновлений DDNS
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- dnspython
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| key_algorithm - |
| Укажите алгоритм ключа, используемый 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 — рекомендуемый и более надежный вариант. |
| record - / обязательно | Устанавливает запись DNS для изменения. Если зона опущена, это должно быть абсолютное значение (заканчивается точкой). | |
| server - / обязательно | Применить изменения записи DNS на этом сервере. | |
| state - |
| Управлять записью 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
- name: Add 1.1.168.192.in-addr.arpa. PTR for ansible.example.org
nsupdate:
key_name: "nsupdate"
key_secret: "+bFQtBCta7j2vWkjPkAFtgA=="
server: "10.1.1.1"
record: "1.1.168.192.in-addr.arpa."
type: "PTR"
value: "ansible.example.org."
state: present
- name: Remove 1.1.168.192.in-addr.arpa. PTR
nsupdate:
key_name: "nsupdate"
key_secret: "+bFQtBCta7j2vWkjPkAFtgA=="
server: "10.1.1.1"
record: "1.1.168.192.in-addr.arpa."
type: "PTR"
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. [community]
Авторы
- 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.9/modules/nsupdate_module.html
