Spec-Zone.ru › Ansible 2.4

nsupdate - Управление записями DNS.

Новая в версии 2.3.

  • Обзор
  • Требования (к хосту, на котором выполняется модуль)
  • Параметры
  • Примеры
  • Возвращаемые значения
    • Статус

Обзор

  • Создание, обновление и удаление записей DNS с помощью обновлений DDNS
  • DDNS хорошо работает как с bind, так и с Microsoft DNS (см. https://technet.microsoft.com/en-us/library/cc961412.aspx)

Требования (к хосту, на котором выполняется модуль)

  • dnspython

Параметры

параметр обязательный значение по умолчанию варианты комментарии
key_algorithm
нет hmac-md5
  • HMAC-MD5.SIG-ALG.REG.INT
  • hmac-md5
  • hmac-sha1
  • hmac-sha224
  • hmac-sha256
  • hamc-sha384
  • hmac-sha512
Укажите алгоритм ключа, используемый key_secret.
key_name
нет
Используйте имя ключа TSIG для аутентификации с DNS server
key_secret
нет
Используйте секрет ключа TSIG, связанный с key_name, для аутентификации с server
record
да
Устанавливает запись DNS для изменения.
server
да
Применить изменение DNS на этом сервере.
state
нет present
  • present
  • absent
Управление записью 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API