f5networks.f5_modules.bigip_dns_nameserver – Управление серверами DNS LTM на BIG-IP

Примечание

Этот плагин входит в коллекцию f5networks.f5_modules (версия 1.6.0).

Для его установки используйте: ansible-galaxy collection install f5networks.f5_modules.

Для использования в плейбуке укажите: f5networks.f5_modules.bigip_dns_nameserver.

Новое в версии 1.0.0: модуля f5networks.f5_modules

Обзор
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

Управляет серверами DNS LTM на BIG-IP. Эти серверы являются частью так называемого DNS Express на BIG-IP. Данный модуль не настраивает функциональность, связанную с GTM (модуль DNS), а также не настраивает системные DNS-серверы, влияющие на способность основной системы разрешать имена DNS.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
address строка			Указывает IP-адрес, на котором сервер DNS (клиент) или сервер авторитетного DNS-сервера (сервер DNS Express) прослушивает DNS-сообщения. При создании нового сервера, если это значение не указано, по умолчанию используется `127.0.0.1`.
name строка / обязательно			Указывает имя сервера DNS.
partition строка		По умолчанию: "Common"	Раздел устройства для управления ресурсами.
provider словарь добавлен в 1.0.0 f5networks.f5_modules			Объект словаря, содержащий данные подключения.
	auth_provider строка		Настраивает поставщика аутентификации для получения маркеров аутентификации от удаленного устройства. Этот параметр действительно используется при работе с устройствами BIG-IQ.
	no_f5_teem булево	Варианты: no yes	Если `yes`, данные телеметрии TEEM не отправляются в F5. Вы можете опустить этот параметр, задав переменную среды `F5_TEEM`.
	password строка / обязательно		Пароль учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, задав переменную среды `F5_PASSWORD`. псевдонимы: pass, pwd
	server строка / обязательно		Хост BIG-IP. Вы можете опустить этот параметр, задав переменную среды `F5_SERVER`.
	server_port целое число	По умолчанию: 443	Порт сервера BIG-IP. Вы можете опустить этот параметр, задав переменную среды `F5_SERVER_PORT`.
	timeout целое число		Указывает таймаут в секундах для связи с сетевым устройством для подключения или отправки команд. Если таймаут истекает до завершения операции, модуль выдаст ошибку.
	transport строка	Варианты: rest ←	Настраивает транспортное соединение для использования при подключении к удаленному устройству.
	user строка / обязательно		Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь права администратора на устройстве. Вы можете опустить этот параметр, задав переменную среды `F5_USER`.
	validate_certs булево	Варианты: no yes ←	Если `no`, сертификаты SSL не проверяются. Используйте только на контролируемых вами сайтах, использующих самозаверяющие сертификаты. Вы можете опустить этот параметр, задав переменную среды `F5_VALIDATE_CERTS`.
route_domain строка			Указывает локальную область маршрутизации, которую сервер DNS (клиент) или сервер авторитетного DNS-сервера (сервер DNS Express) использует для исходящего трафика. При создании нового сервера, если это значение не указано, по умолчанию используется `0`.
service_port строка			Указывает сервисный порт, на котором сервер DNS (клиент) или сервер авторитетного DNS-сервера (сервер DNS Express) прослушивает DNS-сообщения. При создании нового сервера, если это значение не указано, по умолчанию используется `53`.
state строка		Варианты: present ← absent	Когда `present`, гарантирует существование ресурса. Когда `absent`, гарантирует удаление ресурса.
tsig_key строка			Указывает ключ TSIG, который система использует для связи с этим сервером DNS (клиент) или сервером авторитетного DNS-сервера (сервер DNS Express) для передачи зон AXFR. Если сервер DNS — клиент, система использует этот ключ TSIG для проверки запроса и подписания ответа. Если этот сервер DNS — сервер DNS Express, этот ключ TSIG должен соответствовать ключу TSIG для зоны на сервере авторитетного DNS.

Примечания

Примечание

Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
Требуется версия программного обеспечения BIG-IP >= 12.
Модули F5 обрабатывают только текущую конфигурацию продукта F5. Чтобы убедиться, что конфигурация BIG-IP сохранится на диске, обязательно включите хотя бы одну задачу, использующую модуль f5networks.f5_modules.bigip_config для сохранения текущей конфигурации. Обратитесь к документации модуля для правильного использования модуля для сохранения текущей конфигурации.

Примеры

- name: Create a nameserver
  bigip_dns_nameserver:
    name: foo
    address: 10.10.10.10
    service_port: 53
    state: present
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

Возвращаемые значения

Общие возвращаемые значения описаны в этом разделе, ниже представлены поля, уникальные для этого модуля:

Ключ	Возвращаемое значение	Описание
address строка	changed	Адрес, на котором сервер DNS прослушивает DNS-сообщения. Пример: 127.0.0.1
service_port целое число	changed	Сервисный порт, на котором сервер DNS прослушивает DNS-сообщения. Пример: 53

Авторы

Tim Rupp (@caphrim007)

© 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/f5networks/f5_modules/bigip_dns_nameserver_module.html