Spec-Zone.ru › Ansible 2.10

f5networks.f5_modules.bigip_profile_dns – Управление профилями DNS на BIG-IP

Примечание

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

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

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

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

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

Обзор

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

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
cache_name
строка
Указывает созданный пользователем кэш, используемый системой для кэширования ответов DNS.
При выборе кэша для использования системой, необходимо также установить enable_dns_cache на yes.
enable_cache
булево
    Варианты:
  • no
  • yes
Указывает, кэширует ли система ответы DNS.
При создании нового профиля, если этот параметр не указан, используется значение родительского профиля по умолчанию.
При yes, система BIG-IP кэширует ответы DNS, обрабатываемые виртуальными серверами, связанными с этим профилем. При включении этого параметра необходимо также указать значение для cache_name.
При no, система BIG-IP не кэширует ответы DNS, обрабатываемые виртуальными серверами, связанными с этим профилем. Однако профиль сохраняет связь с кэшем DNS в параметре cache_name. Отключите этот параметр, когда хотите отладить систему.
enable_dns_express
булево
    Варианты:
  • no
  • yes
Указывает, включён ли модуль DNS Express.
При создании нового профиля, если этот параметр не указан, используется значение родительского профиля по умолчанию.
Модуль DNS Express получает передачи зон от авторитетного сервера DNS для зоны. Если параметр enable_zone_transfer также yes в этом профиле, модуль DNS Express также отвечает на запросы передачи зон, отправленные серверами имен, настроенными как клиенты передачи зон для зоны DNS Express.
enable_dns_firewall
булево
    Варианты:
  • no
  • yes
Указывает, включён ли брандмауэр DNS.
При создании нового профиля, если этот параметр не указан, используется значение родительского профиля по умолчанию.
enable_dnssec
булево
    Варианты:
  • no
  • yes
Указывает, подписывает ли система ответы с ключами DNSSEC и отвечает на специфичные запросы DNSSEC (например, тип запроса DNSKEY).
При создании нового профиля, если этот параметр не указан, используется значение родительского профиля по умолчанию.
enable_gtm
булево
    Варианты:
  • no
  • yes
Указывает, использует ли система Global Traffic Manager (теперь BIG-IP DNS) для управления ответом.
При создании нового профиля, если этот параметр не указан, используется значение родительского профиля по умолчанию.
enable_zone_transfer
булево
    Варианты:
  • no
  • yes
Указывает, отвечает ли система на запросы передачи зон для зоны DNS, созданной в системе.
При создании нового профиля, если этот параметр не указан, используется значение родительского профиля по умолчанию.
Параметры enable_dns_express и enable_zone_transfer в профиле DNS влияют на то, как система отвечает на запросы передачи зон.
Когда параметры enable_dns_express и enable_zone_transfer оба равны yes, если запрос на передачу зоны соответствует зоне DNS Express, то DNS Express отвечает на запрос.
Когда параметр enable_dns_express равен no, а параметр enable_zone_transfer равен yes, система BIG-IP обрабатывает запросы на передачу зон, основываясь на последнем действии, и отвечает на запрос из локального BIND или члена пула.
name
строка / обязательно
Указывает имя профиля DNS.
parent
строка
Указывает профиль, из которого этот профиль наследует параметры.
При создании нового профиля, если этот параметр не указан, используется системный профиль dns по умолчанию.
partition
строка
Значение по умолчанию:
"Common"
Раздел устройства для управления ресурсами.
process_recursion_desired
булево
    Варианты:
  • no
  • yes
Указывает, обрабатывать ли пакеты DNS клиента с параметром Recursion Desired в заголовке.
При создании нового профиля, если этот параметр не указан, используется значение родительского профиля по умолчанию.
Если установлено значение no, обработка пакета подчиняется опции unhandled-query-action.
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.
state
строка
    Варианты:
  • present ←
  • absent
При present, гарантирует, что профиль существует.
При absent, гарантирует, что профиль удалён.
unhandled_query_action
строка
    Варианты:
  • allow
  • drop
  • reject
  • hint
  • no-error
Указывает действие, выполняемое при запросе, не соответствующем Wide IP или зоне DNS Express.
При allow, система BIG-IP перенаправляет запросы на сервер DNS или член пула. Если пул не связан с слушателем, и опция Use BIND Server on BIG-IP установлена в Enabled, запросы перенаправляются на локальный сервер BIND.
При drop, система BIG-IP не отвечает на запрос.
При reject, система BIG-IP возвращает запрос с кодом REFUSED.
При hint, система BIG-IP возвращает запрос со списком корневых серверов имен.
При no-error, система BIG-IP возвращает запрос с кодом NOERROR.
При создании нового профиля, если этот параметр не указан, используется значение родительского профиля по умолчанию.
use_local_bind
булево
    Варианты:
  • no
  • yes
Указывает, перенаправляет ли система не-Wide IP запросы на локальный сервер BIND на системе BIG-IP.
Для лучшей производительности отключите этот параметр при использовании кэша 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 DNS profile
  bigip_profile_dns:
    name: foo
    enable_dns_express: no
    enable_dnssec: no
    enable_gtm: no
    process_recursion_desired: no
    use_local_bind: no
    enable_dns_firewall: yes
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

Значения возврата

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

Ключ Возвращённое значение Описание
cache_name
строка
изменённое
Имя кэша, используемого DNS.

Пример:
/Common/cache1
enable_cache
булево
изменённое
Включен ли кэширование DNS или нет.
enable_dns_express
булево
изменённое
Включен ли DNS Express на ресурсе или нет.

Пример:
True
enable_dns_firewall
булево
изменённое
Включена ли возможность брандмауэра DNS или нет.
enable_dnssec
булево
изменённое
Включен ли DNSSEC на ресурсе или нет.
enable_gtm
булево
изменённое
Используется ли GTM для управления ресурсом или нет.

Пример:
True
enable_zone_transfer
булево
изменённое
Включены ли переводы зон на ресурсе или нет.
process_recursion_desired
булево
изменённое
Обрабатываются ли пакеты DNS клиента с установленным флагом Recursion Desired.

Пример:
True
unhandled_query_action
строка
изменённое
Что делать с необработанными запросами

Пример:
allow
use_local_bind
булево
изменённое
Перенаправляются ли запросы по IP-адресам, не относящимся к широкому диапазону, на локальный сервер BIND или нет.


Авторы

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

Spec-Zone.ru

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