community.general.nsupdate – Управление записями DNS.
Примечание
Этот плагин входит в состав коллекции community.general (версия 1.3.2).
Для его установки используйте: ansible-galaxy collection install community.general.
Для использования в плейбуке укажите: community.general.nsupdate.
Описание
- Создание, обновление и удаление записей DNS с помощью обновлений DDNS
Требования
Ниже перечислены требования к хосту, на котором будет выполняться данный модуль.
- dnspython
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| key_algorithm строка |
| Указывает алгоритм ключа, используемый key_secret. |
| key_name строка | Используйте имя ключа TSIG для аутентификации с DNS server
| |
| key_secret строка | Используйте секрет ключа TSIG, связанный с key_name, для аутентификации с server
| |
| port строка | По умолчанию: 53 | Используйте этот TCP-порт при подключении к server. |
| protocol строка |
| Устанавливает протокол передачи (TCP или UDP). TCP рекомендуется, как более надёжный вариант. |
| record строка / обязательно | Устанавливает изменяемую запись DNS. Если зона опущена, запись должна быть абсолютной (заканчиваться точкой). | |
| server строка / обязательно | Применяет изменение записи DNS на этом сервере, указанном по IPv4 или IPv6 адресу. | |
| 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"
community.general.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"
community.general.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
community.general.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
community.general.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
community.general.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. |
Авторы
- 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.10/collections/community/general/nsupdate_module.html
