f5networks.f5_modules.bigip_gtm_wide_ip – Управляет широким IP-адресом F5 BIG-IP GTM

Примечание

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

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

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

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

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

Описание

Управляет широким IP-адресом F5 BIG-IP GTM (теперь BIG-IP DNS).

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
aliases список / элементы=строка			Указывает альтернативные доменные имена для контента веб-сайта, который вы балансируете. Вы можете использовать те же символы подстановки, что и для фактических имен Wide IP.
irules список / элементы=строка			Список правил, которые будут применяться. Если вы хотите удалить все существующие iRules, укажите единственное пустое значение; `""`. См. документацию для примера.
last_resort_pool строка			Указывает, какой пул GTM система должна использовать в качестве пула по умолчанию для широкого IP-адреса. Допустимые пулы для этого параметра — те, у которых указано `type` в этом модуле.
name строка / обязательно			Имя широкого IP-адреса. Это имя должно быть отформатировано как полностью квалифицированное доменное имя (FQDN). Вы также можете использовать псевдоним `wide_ip`, но это устаревший метод и будет удален в будущей версии Ansible. aliases: wide_ip
partition строка		По умолчанию: "Common"	Раздел устройства для управления ресурсами.
persist_cidr_ipv4 целое число			Указывает маску, используемую для группировки адресов IPv4 LDNS. Эта функция позволяет одному записям сохранения разделяться между адресами LDNS, которые соответствуют этой маске.
persist_cidr_ipv6 целое число			Указывает маску, используемую для группировки адресов IPv6 LDNS. Эта функция позволяет одному записям сохранения разделяться между адресами LDNS, которые соответствуют этой маске.
persistence логическое значение		Варианты: нет да	При `yes`, гарантирует, что при многократных запросах локального DNS от имени клиента система переподключает клиента к тому же ресурсу, что и предыдущие запросы. При `no`, гарантирует, что многократные запросы не переподключают клиента к тому же ресурсу.
persistence_ttl целое число			Указывает время сохранения подключения между локальным DNS и конкретным виртуальным сервером.
pool_lb_method строка		Варианты: round-robin ratio topology global-availability	Указывает метод балансировки нагрузки, используемый для выбора пула в этом широком IP-адресе. Это значение актуально только при конфигурации нескольких пулов для широкого IP-адреса. aliases: lb_method
pools список / элементы=словарь			Пулы, которые вы хотите связать с широким IP-адресом. Если `ratio` не указан при создании нового широкого IP-адреса, он будет по умолчанию равен 1.
	name строка / обязательно		Имя пула для включения.
	order целое число		Порядок пула по отношению к другим пулам, подключенным к этому широкому IP-адресу. Порядок пулов важен, когда используется метод балансировки нагрузки «Глобальная доступность». Если `order` не указан, модуль присваивает ему значение `0`.
	ratio целое число		Соотношение для пула. Система использует это число с методом балансировки нагрузки «Соотношение». Если `ratio` не указан, модуль присваивает ему значение `0`.
provider словарь добавлено в 1.0.0 f5networks.f5_modules			Объект словаря, содержащий данные подключения.
	auth_provider строка		Настраивает поставщик аутентификации для получения маркеров аутентификации с удаленного устройства. Этот параметр действительно используется при работе с устройствами BIG-IQ.
	no_f5_teem логическое значение	Варианты: нет да	Если `yes`, данные телеметрии TEEM не отправляются в F5. Вы можете опустить этот параметр, установив переменную окружения `F5_TEEM`.
	password строка / обязательно		Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, установив переменную окружения `F5_PASSWORD`. aliases: 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`, сертификаты SSL не проверяются. Используйте только на сайтах под вашим контролем, использующих самозаверяющие сертификаты. Вы можете опустить этот параметр, установив переменную окружения `F5_VALIDATE_CERTS`.
state строка		Варианты: present ← absent disabled enabled	Когда `present` или `enabled`, гарантирует, что широкий IP-адрес существует и включен. Когда `absent`, гарантирует, что широкий IP-адрес был удалён. Когда `disabled`, гарантирует, что широкий IP-адрес существует и отключён.
type строка		Варианты: a aaaa cname mx naptr srv	Указывает тип широкого IP-адреса. Широкие IP-адреса GTM должны быть привязаны к типу запроса, помимо имени, потому что членам пула требуются разные атрибуты в зависимости от RDATA ответа, который они должны предоставить. Это значение необходимо, если вы используете версии BIG-IP ≥ 12.0.0.

Примечания

Примечание

Поддержка версий TMOS ниже v12.x устарела для этого модуля и будет удалена в f5_modules 1.4.
Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
Требуется версия ПО BIG-IP ≥ 12.
Модули F5 изменяют только текущую конфигурацию продукта F5. Чтобы убедиться, что BIG-IP-специфичная конфигурация сохраняется на диске, обязательно включите по крайней мере одну задачу, использующую модуль f5networks.f5_modules.bigip_config, для сохранения текущей конфигурации. См. документацию по модулю для правильного использования, чтобы сохранить текущую конфигурацию.

Примеры

- name: Set lb method
  bigip_gtm_wide_ip:
    pool_lb_method: round-robin
    name: my-wide-ip.example.com
    provider:
      user: admin
      password: secret
      server: lb.mydomain.com
  delegate_to: localhost

- name: Add iRules to the Wide IP
  bigip_gtm_wide_ip:
    pool_lb_method: round-robin
    name: my-wide-ip.example.com
    irules:
      - irule1
      - irule2
    provider:
      user: admin
      password: secret
      server: lb.mydomain.com
  delegate_to: localhost

- name: Remove one iRule from the Virtual Server
  bigip_gtm_wide_ip:
    pool_lb_method: round-robin
    name: my-wide-ip.example.com
    irules:
      - irule1
    provider:
      user: admin
      password: secret
      server: lb.mydomain.com
  delegate_to: localhost

- name: Remove all iRules from the Virtual Server
  bigip_gtm_wide_ip:
    pool_lb_method: round-robin
    name: my-wide-ip.example.com
    irules: ""
    provider:
      user: admin
      password: secret
      server: lb.mydomain.com
  delegate_to: localhost

- name: Assign a pool with ratio to the Wide IP
  bigip_gtm_wide_ip:
    pool_lb_method: round-robin
    name: my-wide-ip.example.com
    pools:
      - name: pool1
        ratio: 100
        order: 2
      - name: pool1
        ratio: 100
        order: 1
    provider:
      user: admin
      password: secret
      server: lb.mydomain.com
  delegate_to: localhost

- name: Assign a pool with persistence to the Wide IP
  bigip_gtm_wide_ip:
    pool_lb_method: round-robin
    name: my-wide-ip.example.com
    pools:
      - name: pool1
        persistence: yes
        persist_cidr_ipv4: 24
        persist_cidr_ipv6: 120
        persistence_ttl: 3500
    provider:
      user: admin
      password: secret
      server: lb.mydomain.com
  delegate_to: localhost

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

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

Ключ	Возвращаемое значение	Описание
aliases список / элементы=строка	изменено	Псевдонимы, установленные на широком IP-адресе. Пример: ['alias1.foo.com', '*.wildcard.domain']
irules список / элементы=строка	изменено	Набор iRules, установленный на широком IP-адресе. Пример: ['/Common/irule1', '/Common/irule2']
lb_method строка	изменено	Новый метод балансировки нагрузки, используемый широким IP-адресом. Пример: topology
persist_cidr_ipv4 целое число	изменено	Определяет маску, используемую для группировки адресов IPv4 LDNS. Пример: 32
persist_cidr_ipv6 целое число	изменено	Определяет маску, используемую для группировки адресов IPv6 LDNS. Пример: 128
persistence булево	изменено	Определяет, будут ли сохраняться подключения к пулу.
persistence_ttl целое число	изменено	Определяет время жизни сохранения (TTL) между локальным DNS-сервером и конкретным виртуальным сервером. Пример: 3600
state строка	изменено	Новое состояние широкого IP-адреса. Пример: выключен

Авторы

Tim Rupp (@caphrim007)
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_wide_ip_module.html