Spec-Zone.ru › Ansible

Модуль f5networks.f5_modules.bigip_profile_dns — управление профилями 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_profile_dns.

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

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

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

  • Управление профилями DNS на BIG-IP. Профили DNS имеют множество параметров, каждый из которых настраивает стандартный профиль dns. Пользователям этого модуля следует учитывать, что для многих настраиваемых параметров значения по умолчанию в модуле не заданы. Вместо этого значение по умолчанию назначает сама система BIG-IP, и в большинстве случаев оно является приемлемым.

Параметры

Параметр

Комментарии

cache_name

string

Указывает созданный пользователем кэш, который система использует для кэширования ответов DNS.

При выборе кэша для использования системой необходимо также задать для enable_dns_cache значение true

enable_cache

boolean

Указывает, кэширует ли система ответы DNS.

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

Если true, система BIG-IP кэширует ответы DNS, обработанные виртуальными серверами, связанными с этим профилем. При включении этого параметра необходимо также указать значение для cache_name.

Если false, система BIG-IP не кэширует ответы DNS, обработанные виртуальными серверами, связанными с этим профилем. Однако связь профиля с кэшем DNS сохраняется в параметре cache_name. Отключите этот параметр, если хотите отладить систему.

Варианты:

  • false
  • true

enable_dns_express

boolean

Указывает, включён ли механизм DNS Express.

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

Механизм DNS Express получает передачу зоны от авторитетного DNS-сервера для этой зоны. Если для этого профиля также включён параметр enable_zone_transfer со значением true, механизм DNS Express отвечает на запросы передачи зоны от серверов имён, настроенных как клиенты передачи зоны для зоны DNS Express.

Варианты:

  • false
  • true

enable_dns_firewall

boolean

Указывает, включён ли межсетевой экран DNS.

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

Варианты:

  • false
  • true

enable_dnssec

boolean

Указывает, подписывает ли система ответы ключами DNSSEC и отвечает ли на специальные запросы DNSSEC (например, запросы типа DNSKEY).

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

Варианты:

  • false
  • true

enable_gtm

boolean

Указывает, использует ли система Global Traffic Manager (теперь BIG-IP DNS) для управления ответом.

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

Варианты:

  • false
  • true

enable_zone_transfer

boolean

Указывает, отвечает ли система на запросы передачи зоны DNS, созданной в системе.

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

Параметры enable_dns_express и enable_zone_transfer в профиле DNS влияют на то, как система отвечает на запросы передачи зоны.

Если параметры enable_dns_express и enable_zone_transfer имеют значение true, DNS Express отвечает на запрос передачи зоны, если он соответствует зоне DNS Express.

Если параметр enable_dns_express имеет значение no, а параметр enable_zone_transfer — true, система BIG-IP обрабатывает запросы передачи зоны в соответствии с последним действием и отвечает на запрос с локального BIND или участника пула.

Варианты:

  • false
  • true

name

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

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

parent

string

Указывает профиль, от которого этот профиль наследует настройки.

При создании нового профиля, если этот параметр не указан, используется системный профиль dns.

partition

string

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

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

process_recursion_desired

boolean

Указывает, обрабатывать ли клиентские пакеты DNS с установленным в заголовке флагом Recursion Desired.

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

Если задано значение false, обработка пакета зависит от параметра unhandled-query-action.

Варианты:

  • false
  • true

provider

dictionary

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

Объект dict, содержащий сведения о подключении.

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 ← (по умолчанию)

state

string

Если present, обеспечивает существование профиля.

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

Варианты:

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

unhandled_query_action

string

Указывает действие, выполняемое, если запрос не соответствует Wide IP или зоне DNS Express.

Если allow, система BIG-IP перенаправляет запросы на DNS-сервер или участника пула. Если с прослушивателем не связан пул, а параметр Use BIND Server on BIG-IP включён, запросы перенаправляются на локальный сервер BIND.

Если drop, система BIG-IP не отвечает на запрос.

Если reject, система BIG-IP возвращает запрос с кодом ответа REFUSED.

Если hint, система BIG-IP возвращает запрос со списком корневых серверов имён.

Если no-error, система BIG-IP возвращает запрос с кодом ответа NOERROR.

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

Варианты:

  • "allow"
  • "drop"
  • "reject"
  • "hint"
  • "no-error"

use_local_bind

boolean

Указывает, перенаправляет ли система запросы, не относящиеся к Wide IP, на локальный сервер BIND в системе BIG-IP.

Для обеспечения наилучшей производительности отключите этот параметр при использовании кэша DNS.

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

Варианты:

  • 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 DNS profile
  bigip_profile_dns:
    name: foo
    enable_dns_express: false
    enable_dnssec: false
    enable_gtm: false
    process_recursion_desired: false
    use_local_bind: false
    enable_dns_firewall: true
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

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

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

Ключ

Описание

cache_name

string

Имя кэша, используемого DNS.

Возвращается: при изменении

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

enable_cache

boolean

Включено ли кэширование DNS.

Возвращается: при изменении

Пример: false

enable_dns_express

boolean

Включён ли DNS Express для ресурса.

Возвращается: при изменении

Пример: true

enable_dns_firewall

boolean

Включена ли функция межсетевого экрана DNS.

Возвращается: при изменении

Пример: false

enable_dnssec

boolean

Включён ли DNSSEC для ресурса.

Возвращается: при изменении

Пример: false

enable_gtm

boolean

Используется ли GTM для управления ресурсом.

Возвращается: при изменении

Пример: true

enable_zone_transfer

boolean

Включена ли передача зоны для ресурса.

Возвращается: при изменении

Пример: false

process_recursion_desired

boolean

Обрабатываются ли клиентские пакеты DNS с установленным флагом Recursion Desired.

Возвращается: при изменении

Пример: true

unhandled_query_action

string

Действие при необработанных запросах

Возвращается: при изменении

Пример: "allow"

use_local_bind

boolean

Перенаправляются ли запросы, не относящиеся к Wide IP, на локальный сервер BIND.

Возвращается: при изменении

Пример: false

Авторы

  • 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_profile_dns_module.html

Spec-Zone.ru

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