f5networks.f5_modules.bigip_gtm_topology_region – Управляет регионами топологии GTM
Примечание
Этот плагин является частью коллекции f5networks.f5_modules (версия 1.7.1).
Для его установки используйте: ansible-galaxy collection install f5networks.f5_modules.
Для использования в плейбуке укажите: f5networks.f5_modules.bigip_gtm_topology_region.
Новое в версии 1.0.0: модуля f5networks.f5_modules
Обзор
- Управляет регионами топологии GTM (сейчас BIG-IP DNS).
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| name строка / обязательный | Указывает имя региона. | ||
| 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. | |
| region_members список / элементы=словарь | Указывает список членов региона. Этот список членов – все или ничего, чтобы добавить или удалить члена, вы должны указать весь список членов. Список переопределяет то, что есть на устройстве, если отличается. Если вы укажете пустой список, список членов региона удаляется. | ||
| continent строка | Указывает один из семи континентов вместе с настройкой Unknown. Указание Unknown принудительно заставляет систему использовать стандартное разрешение, если система не может определить местоположение локального DNS, производящего запрос.Поддерживаются полные имена континентов и их сокращенные версии. | ||
| country строка | Имя или код страны для использования. В дополнение к полным именам стран, вы также можете указать их сокращенные формы, такие как US, вместо United States. Действительные коды стран можно найти здесь https://countrycode.org/. | ||
| datacenter строка | Указывает имя ЦОД GTM, уже определённое в конфигурации. | ||
| geo_isp строка | Указывает геолокационного интернет-провайдера. | ||
| isp строка |
| Указывает интернет-провайдера. | |
| negate логическое значение |
| При установке в c(yes), система выбирает этот регион топологии, когда источник запроса не соответствует. Можно указать только один элемент списка вместе с negate. | |
| pool строка | Указывает имя пула GTM, уже определённого в конфигурации. | ||
| region строка | Указывает имя региона, уже определённого в конфигурации. | ||
| state строка | Указывает состояние в данной стране. | ||
| subnet строка | IP-адрес и маска подсети в формате CIDR. | ||
| state строка |
| Когда state равно present, гарантирует существование региона.Когда state равно absent, гарантирует удаление региона. | |
Примечания
Примечание
- Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на https://www.ansible.com/integrations/networks/f5.
- Требуется версия программного обеспечения BIG-IP >= 12.
- Модули F5 манипулируют только текущей конфигурацией продукта F5. Чтобы убедиться, что специфическая конфигурация BIG-IP сохраняется на диск, убедитесь, что включён хотя бы один этап, использующий модуль f5networks.f5_modules.bigip_config для сохранения текущей конфигурации. Обратитесь к документации модуля для правильного использования модуля для сохранения текущей конфигурации.
Примеры
- name: Create topology region
bigip_gtm_topology_region:
name: foobar
region_members:
- country: CN
negate: yes
- datacenter: baz
provider:
password: secret
server: lb.mydomain.com
user: admin
delegate_to: localhost
- name: Modify topology region
bigip_gtm_topology_region:
name: foobar
region_members:
- continent: EU
- country: PL
provider:
password: secret
server: lb.mydomain.com
user: admin
delegate_to: localhost
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие являются полями, уникальными для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| name строка | изменилось | Значение имени региона GTM. Пример: foobar |
| region_members список / элементы=строка | изменилось | Список членов региона GTM. Пример: [{'continent': 'EU'}, {'country': 'PL'}] |
Авторы
- Wojciech Wypior (@wojtek0806)
© 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_gtm_topology_region_module.html
