Spec-Zone.ru › Ansible

Модуль f5networks.f5_modules.bigip_dns_resolver — управление DNS-резолверами на BIG-IP

Примечание

Этот модуль входит в коллекцию f5networks.f5_modules (версия 1.39.0).

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

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

Чтобы использовать её в плейбуке, укажите: f5networks.f5_modules.bigip_dns_resolver.

Добавлено в f5networks.f5_modules 1.0.0

  • Краткое описание
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Краткое описание

  • Управление DNS-резолверами в системе BIG-IP.

Параметры

Параметр

Комментарии

answer_default_zones

boolean

Указывает, отвечает ли система на DNS-запросы для зон по умолчанию localhost, reverse 127.0.0.1 и ::1, а также AS112.

При создании нового резолвера, если этот параметр не указан, по умолчанию используется значение false, то есть система передаёт DNS-запросы для зон по умолчанию дальше.

Варианты:

  • false
  • true

cache_size

integer

Указывает размер внутреннего кэша DNS-резолвера.

При создании нового резолвера, если этот параметр не указан, по умолчанию используется размер 5767168 байт.

Когда размер кэша достигает этого значения и поступает новое или обновлённое содержимое, система удаляет устаревшее и более старое содержимое, а затем кэширует новое или обновлённое содержимое.

name

string / обязательный

Указывает имя DNS-резолвера.

partition

string

Раздел устройства, в котором следует управлять ресурсами.

По умолчанию: "Common"

provider

dictionary

добавлено в f5networks.f5_modules 1.0.0

Словарь с параметрами подключения.

auth_provider

string

Настраивает поставщика аутентификации, используемого для получения токенов аутентификации с удалённого устройства.

Этот параметр предназначен главным образом для работы с устройствами BIG-IQ.

no_f5_teem

boolean

Если задано yes, телеметрические данные TEEM не отправляются в F5.

Этот параметр можно не указывать, задав переменную окружения F5_TELEMETRY_OFF.

Ранее использовавшаяся переменная F5_TEEM объявлена устаревшей, поскольку её название было неоднозначным.

Варианты:

  • false ← (по умолчанию)
  • true

password

псевдонимы: pass, pwd

string / обязательный

Пароль учётной записи пользователя, используемой для подключения к BIG-IP или BIG-IQ.

Этот параметр можно не указывать, задав переменную окружения F5_PASSWORD.

server

string / обязательный

Узел BIG-IP или BIG-IQ.

Этот параметр можно не указывать, задав переменную окружения F5_SERVER.

server_port

integer

Порт сервера BIG-IP.

Этот параметр можно не указывать, задав переменную окружения F5_SERVER_PORT.

По умолчанию: 443

timeout

integer

Задаёт время ожидания в секундах при взаимодействии с сетевым устройством — для подключения или отправки команд. Если время ожидания истекает до завершения операции, модуль завершится с ошибкой.

transport

string

Настраивает транспортное соединение для подключения к удалённому устройству.

Варианты:

  • "rest" ← (по умолчанию)

user

string / обязательный

Имя пользователя для подключения к BIG-IP или BIG-IQ. У этого пользователя должны быть права администратора на устройстве.

Этот параметр можно не указывать, задав переменную окружения F5_USER.

validate_certs

boolean

Если задано no, SSL-сертификаты не проверяются. Используйте этот параметр только на контролируемых вами ресурсах с самоподписанными сертификатами.

Этот параметр можно не указывать, задав переменную окружения F5_VALIDATE_CERTS.

Варианты:

  • false
  • true ← (по умолчанию)

randomize_query_case

boolean

Если задано true, внутренний DNS-резолвер случайным образом меняет регистр символов в запросах доменных имён, отправляемых корневым DNS-серверам.

При создании нового резолвера, если этот параметр не указан, по умолчанию используется значение true.

Варианты:

  • false
  • true

route_domain

integer

Указывает домен маршрутизации, используемый резолвером для исходящего трафика.

state

string

Если задано present, обеспечивает наличие ресурса.

Если задано absent, обеспечивает удаление ресурса.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

use_ipv4

boolean

Указывает, может ли система использовать IPv4 для запросов к внутренним серверам имён.

Для успешной обработки таких запросов должны быть доступны Self IP IPv4 и маршрут по умолчанию.

При создании нового резолвера, если этот параметр не указан, по умолчанию используется значение true.

Варианты:

  • false
  • true

use_ipv6

boolean

Указывает, может ли система использовать IPv6 для запросов к внутренним серверам имён.

Для успешной обработки таких запросов должны быть доступны Self IP IPv6 и маршрут по умолчанию.

При создании нового резолвера, если этот параметр не указан, по умолчанию используется значение true.

Варианты:

  • false
  • true

use_tcp

boolean

Указывает, отвечает ли система на запросы в формате TCP и отправляет ли их.

При создании нового резолвера, если этот параметр не указан, по умолчанию используется значение true.

Варианты:

  • false
  • true

use_udp

boolean

Указывает, отвечает ли система на запросы в формате UDP и отправляет ли их.

При создании нового резолвера, если этот параметр не указан, по умолчанию используется значение true.

Варианты:

  • false
  • true

Примечания

Примечание

  • Дополнительные сведения об использовании 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 simple DNS responder for OCSP stapling
  bigip_dns_resolver:
    name: resolver1
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

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

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

Ключ

Описание

answer_default_zones

boolean

Новое значение параметра Answer Default Zones.

Возвращается: changed

Пример: true

cache_size

integer

Новый размер кэша ресурса.

Возвращается: changed

Пример: 50000

randomize_query_case

boolean

Новое значение параметра Randomize Query Character Case.

Возвращается: changed

Пример: false

route_domain

string

Новый домен маршрутизации ресурса.

Возвращается: changed

Пример: "/Common/0"

use_ipv4

boolean

Новое значение параметра Use IPv4.

Возвращается: changed

Пример: true

use_ipv6

boolean

Новое значение параметра Use IPv6.

Возвращается: changed

Пример: "default"

use_tcp

boolean

Новое значение параметра Use TCP.

Возвращается: changed

Пример: false

use_udp

boolean

Новое значение параметра Use UDP.

Возвращается: changed

Пример: true

Авторы

  • Tim Rupp (@caphrim007)

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

  • Отслеживание проблем
  • Домашняя страница
  • Репозиторий (исходный код)

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/f5networks/f5_modules/bigip_dns_resolver_module.html

Spec-Zone.ru

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