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

Примечание

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

Для его установки используйте: 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.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
address строка			Указывает IP-адрес, на котором сервер DNS (клиент) или сервер авторитетных имен DNS (сервер DNS Express) прослушивает DNS-сообщения. При создании нового сервера, если это значение не указано, по умолчанию используется `127.0.0.1`.
name строка / обязательно			Указывает имя сервера.
partition строка		По умолчанию: "Общие"	Раздел устройства для управления ресурсами.
provider словарь добавлен в 1.0.0 f5networks.f5_modules			Объект словаря, содержащий данные подключения.
	auth_provider строка		Настраивает поставщика аутентификации для получения маркеров аутентификации с удаленного устройства. Этот параметр действительно используется при работе с устройствами BIG-IQ.
	no_f5_teem логическое	Варианты: нет да	Если `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`, сертификаты 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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/f5networks/f5_modules/bigip_dns_nameserver_module.html