f5networks.f5_modules.bigip_selfip – Управление собственными IP-адресами на системе BIG-IP

Примечание

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

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

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

Новое в версии 1.0.0: of f5networks.f5_modules

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

Обзор

Управление адресами собственных IP в системе BIG-IP.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
address строка			IP-адреса нового собственного IP. Это значение игнорируется при обновлении, так как сами адреса изменить после создания нельзя. Это значение необходимо при создании новых собственных IP.
allow_service список / элементы=строка			Настройка блокировки портов для собственного IP. По умолчанию для собственного IP используется политика "отказ по умолчанию". Это можно изменить, разрешив порты TCP и UDP, а также определенные протоколы. Этот список должен содержать значения `protocol`:`port`.
description строка			Описание селектора трафика.
fw_enforced_policy строка добавлен в 1.1.0 f5networks.f5_modules			Указывает политику AFM для присоединения к собственному IP.
name строка / обязательно			Имя создаваемого собственного IP. Если этот параметр не указан, он принимает значение, заданное в параметре `address`.
netmask строка			Маска подсети для собственного IP. При создании нового собственного IP это значение требуется.
partition строка		По умолчанию: "Common"	Раздел устройства для управления ресурсами. Можно задавать разные разделы для собственных IP, но используемый адрес не должен совпадать ни с каким другим адресом, используемым другим собственным IP. Таким образом, собственные IP не изолированы разделами, как другие ресурсы BIG-IP.
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`.
route_domain целое число			Идентификатор домена маршрутизации системы. При создании нового собственного IP, если это значение не указано, по умолчанию используется значение `0`. Это значение нельзя изменить после его установки.
state строка		Варианты: absent present ←	Если `present`, гарантирует, что собственный IP существует с указанными атрибутами. Если `absent`, удаляет собственный IP из системы.
traffic_group строка			Группа трафика для адресов собственных IP в конфигурации актив-активный, резервируемого балансировщика нагрузки. При создании нового собственного IP, если это значение не указано, по умолчанию используется значение `/Common/traffic-group-local-only`.
vlan строка			VLAN для новых собственных IP. При создании нового собственного IP это значение требуется.

Примечания

Примечание

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

Примеры

- name: Create Self IP
  bigip_selfip:
    address: 10.10.10.10
    name: self1
    netmask: 255.255.255.0
    vlan: vlan1
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

- name: Create Self IP with a Route Domain
  bigip_selfip:
    name: self1
    address: 10.10.10.10
    netmask: 255.255.255.0
    vlan: vlan1
    route_domain: 10
    allow_service: default
    provider:
      server: lb.mydomain.com
      user: admin
      password: secret
  delegate_to: localhost

- name: Delete Self IP
  bigip_selfip:
    name: self1
    state: absent
    provider:
      user: admin
      password: secret
      server: lb.mydomain.com
  delegate_to: localhost

- name: Allow management web UI to be accessed on this Self IP
  bigip_selfip:
    name: self1
    state: absent
    allow_service:
      - tcp:443
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

- name: Allow HTTPS and SSH access to this Self IP
  bigip_selfip:
    name: self1
    state: absent
    allow_service:
      - tcp:443
      - tcp:22
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

- name: Allow all services access to this Self IP
  bigip_selfip:
    name: self1
    state: absent
    allow_service:
      - all
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

- name: Allow only GRE and IGMP protocols access to this Self IP
  bigip_selfip:
    name: self1
    state: absent
    allow_service:
      - gre:0
      - igmp:0
    provider:
      user: admin
      password: secret
      server: lb.mydomain.com
  delegate_to: localhost

- name: Allow all TCP, but no other protocols access to this Self IP
  bigip_selfip:
    name: self1
    state: absent
    allow_service:
      - tcp:0
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

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

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

Ключ	Возвращаемое значение	Описание
address строка	changed	Адрес собственного IP. Пример: 192.0.2.10
allow_service список / элементы=строка	changed	Услуги, разрешенные через этот собственный IP. Пример: ['igmp:0', 'tcp:22', 'udp:53']
fw_enforced_policy строка	changed	Указывает политику AFM, которая должна быть прикреплена к собственному IP. Пример: /Common/afm-blocking-policy
name строка	created	Имя собственного IP. Пример: self1
netmask строка	changed	Маска подсети собственного IP. Пример: 255.255.255.0
traffic_group строка	changed	Группа трафика, членом которой является собственный IP. Пример: traffic-group-local-only
vlan строка	changed	VLAN, установленный на собственном IP. Пример: vlan1

Авторы

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_selfip_module.html