f5networks.f5_modules.bigip_gtm_topology_record – Управляет записями топологии GTM
Примечание
Этот плагин входит в коллекцию f5networks.f5_modules (версия 1.6.0).
Для его установки используйте: ansible-galaxy collection install f5networks.f5_modules.
Для использования в книге задач, укажите: f5networks.f5_modules.bigip_gtm_topology_record.
Добавлена в версии 1.0.0: модуля f5networks.f5_modules
Описание
- Управляет записями топологии GTM (сейчас BIG-IP DNS). После создания, можно изменить только запись топологии
weight.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| destination словарь / обязательно | Указывает, куда система направляет входящий DNS-запрос. | ||
| continent строка | Указывает один из семи континентов, наряду с параметром Unknown. Указание Unknown заставляет систему использовать значение по умолчанию для разрешения, если система не может определить расположение локального DNS-сервера, производящего запрос.Поддерживаются полные названия континентов и их сокращенные версии. | ||
| country строка | Указывает страну. Поддерживаются полные названия стран и их сокращенные версии. | ||
| datacenter строка | Указывает имя ГТМ-дата-центра, уже определённого в конфигурации. | ||
| geo_isp строка | Указывает геолокационную интернет-службу. | ||
| isp строка |
| Указывает интернет-провайдера. | |
| negate булево |
| При значении yes система выбирает эту запись топологии, когда место назначения запроса не совпадает. | |
| pool строка | Указывает имя ГТМ-пула, уже определённого в конфигурации. | ||
| region строка | Указывает имя региона, уже определённого в конфигурации. | ||
| state строка | Указывает штат в данной стране. Этот параметр требует опцию country. | ||
| subnet строка | IP-адрес и маска подсети в формате CIDR. | ||
| partition строка | По умолчанию: "Common" | Раздел устройства для управления ресурсами. Параметр раздела учитывается при использовании совместно с параметрами pool, data_center, и region, в противном случае он игнорируется. | |
| 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 строка |
| Настраивает транспортное соединение для использования при подключении к удалённому устройству. | |
| user строка / обязательно | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить эту опцию, установив переменную окружения F5_USER. | ||
| validate_certs булево |
| Если no, сертификаты SSL не будут проверены. Используйте только на контролируемых вами сайтах с самозаверенными сертификатами.Вы можете опустить эту опцию, установив переменную окружения F5_VALIDATE_CERTS. | |
| source словарь / обязательно | Указывает место происхождения входящего DNS-запроса. | ||
| continent строка | Указывает один из семи континентов, наряду с параметром Unknown. Указание Unknown заставляет систему использовать значение по умолчанию для разрешения, если система не может определить расположение локального DNS-сервера, производящего запрос.Поддерживаются полные названия континентов и их сокращенные версии. | ||
| country строка | Указывает страну. Помимо полных названий стран, вы также можете указать их сокращенные формы, например US, вместо United States. Список допустимых кодов стран можно найти здесь https://countrycode.org/. | ||
| geo_isp строка | Указывает геолокационную интернет-службу. | ||
| isp строка |
| Указывает интернет-провайдера. | |
| negate булево |
| При значении да система выбирает эту запись топологии, когда место происхождения запроса не совпадает. | |
| region строка | Указывает имя региона, уже определённого в конфигурации. | ||
| state строка | Указывает штат в данной стране. Этот параметр требует опцию country. | ||
| subnet строка | IP-адрес и маска подсети в формате CIDR. | ||
| state строка |
| Когда state равно present, гарантирует, что запись существует.Когда state равно absent, гарантирует удаление записи. | |
| weight целое число | Указывает вес записи топологии. Система находит вес первой записи топологии, которая соответствует объекту сервера (пулу или члену пула) и локальному DNS. Затем система присваивает этот вес как балл топологии для этого объекта сервера. Система балансирует нагрузку на объект сервера с наибольшим баллом топологии. Если система не находит запись топологии, которая соответствует как объекту сервера, так и локальному DNS, система присваивает этому объекту сервера ноль баллов. Если опция не указана при создании записи, система установит её по умолчанию в значение 1.
Допустимый диапазон значений: (0 - 4294967295) | ||
Примечания
Примечание
- Для получения дополнительной информации об использовании Ansible для управления устройствами F5 Networks см. https://www.ansible.com/integrations/networks/f5.
- Требуется версия ПО BIG-IP ≥ 12.
- Модули F5 изменяют только текущую конфигурацию продукта F5. Чтобы убедиться, что BIG-IP-специфическая конфигурация сохранится на диске, обязательно включите по крайней мере одну задачу, которая использует модуль f5networks.f5_modules.bigip_config для сохранения текущей конфигурации. Обратитесь к документации модуля для правильного использования модуля для сохранения текущей конфигурации.
Примеры
- name: Create an IP Subnet and an ISP based topology record
bigip_gtm_topology_record:
source:
- subnet: 192.168.1.0/24
destination:
- isp: AOL
weight: 10
provider:
password: secret
server: lb.mydomain.com
user: admin
delegate_to: localhost
- name: Create a region and a pool based topology record
bigip_gtm_topology_record:
source:
- region: Foo
destination:
- pool: FooPool
partition: FooBar
provider:
password: secret
server: lb.mydomain.com
user: admin
delegate_to: localhost
- name: Create a negative region and a negative data center based topology record
bigip_gtm_topology_record:
source:
- region: Baz
- negate: yes
destination:
- datacenter: Baz-DC
- negate: yes
provider:
password: secret
server: lb.mydomain.com
user: admin
delegate_to: localhost
Значения возврата
Общие значения возврата документированы здесь, следующие — поля, уникальные для этого модуля:
| Ключ | Возвращенное значение | Описание |
|---|---|---|
| weight целое число | изменённое | Вес записи топологии. Пример: 20 |
Авторы
- Wojciech Wypior (@wojtek0806)
© 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_gtm_topology_record_module.html
