Модуль community.general.nsupdate – Управление записями DNS

Примечание

Этот модуль входит в коллекцию community.general (версия 9.5.0).

У вас, возможно, уже установлена эта коллекция, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install community.general. Для использования этого модуля необходимы дополнительные требования, см. Требования для получения подробностей.

Чтобы использовать его в книге задач, укажите: community.general.nsupdate.

Описание
Требования
Параметры
Атрибуты
Примеры
Возвращаемые значения

Описание

Создание, обновление и удаление записей DNS с помощью обновлений DDNS

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

dnspython

Параметры

Параметр	Комментарии
key_algorithm строка	Укажите алгоритм ключа, используемый `key_secret`. Выбор: `"HMAC-MD5.SIG-ALG.REG.INT"` `"hmac-md5"` ← (по умолчанию) `"hmac-sha1"` `"hmac-sha224"` `"hmac-sha256"` `"hmac-sha384"` `"hmac-sha512"`
key_name строка	Используйте имя ключа TSIG для аутентификации с DNS `server`
key_secret строка	Используйте секрет ключа TSIG, связанный с `key_name`, для аутентификации с `server`
port целое число	Используйте этот TCP-порт при подключении к `server`. По умолчанию: `53`
protocol строка	Устанавливает протокол передачи (TCP или UDP). TCP рекомендуется и является более надёжным вариантом. Выбор: `"tcp"` ← (по умолчанию) `"udp"`
record строка / обязательно	Устанавливает запись DNS для изменения. Когда зона опущена, она должна быть абсолютной (заканчиваться точкой).
server строка / обязательно	Примените изменение DNS на этом сервере, указанном по IPv4 или IPv6 адресу.
state строка	Управление записью DNS. Выбор: `"present"` ← (по умолчанию) `"absent"`
ttl целое число	Устанавливает TTL записи. По умолчанию: `3600`
type строка	Устанавливает тип записи. По умолчанию: `"A"`
value список / элементы=строка	Устанавливает значение записи.
zone строка	Запись DNS будет изменена в этой `zone`. Если опущена, DNS будет запрошен для попытки определения правильной зоны.

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Может работать в режиме `check_mode` и возвращать прогноз статуса изменения без модификации целевого объекта.
diff_mode	Поддержка: нет	Вернёт детали изменений (или, возможно, необходимых изменений в `check_mode`), когда режим diff активен.

Примеры

- 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 строка	Если модуль изменил запись Возвращается: success
dns_rc целое число	Код возврата dnspython Возвращается: всегда Пример: `4`
dns_rc_str строка	Код возврата dnspython (строковое представление) Возвращается: всегда Пример: `"REFUSED"`
record строка	Запись DNS Возвращается: success Пример: `"ansible"`
ttl целое число	TTL записи DNS Возвращается: success Пример: `86400`
type строка	Тип записи DNS Возвращается: success Пример: `"CNAME"`
value список / элементы=строка	Значение(я) записи DNS Возвращается: success Пример: `["192.168.1.1"]`
zone строка	Зона записи DNS Возвращается: success Пример: `"example.org."`

Авторы

Loic Blot (@nerzhul)

Ссылки на коллекции

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/nsupdate_module.html