bigip_selfip – Управление адресами Self-IP на системе BIG-IP

Новая версия с 2.2.

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

Описание

Управление адресами Self-IP на системе BIG-IP.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
address строка			IP-адреса для нового адреса Self-IP. Это значение игнорируется при обновлении, так как сами адреса изменить нельзя после создания. Это значение требуется при создании новых адресов Self-IP.
allow_service список			Настройка блокировки портов для Self-IP. По умолчанию Self-IP имеет политику «отказ по умолчанию». Это можно изменить, разрешив TCP и UDP порты, а также определенные протоколы. Этот список должен содержать значения `protocol`:`port`.
description строка добавлено в 2.8			Описание селектора трафика.
name строка / обязательно			Self-IP для создания. Если этот параметр не указан, он будет по умолчанию равен значению, предоставленному в параметре `address`.
netmask строка			Маска сети для Self-IP. При создании нового адреса Self-IP это значение обязательно.
partition строка добавлено в 2.5		По умолчанию: "Общие"	Раздел устройства для управления ресурсами. Вы можете установить различные разделы для Self-IP, но используемый адрес может не совпадать с любым другим адресом, используемым адресом Self-IP. В этом смысле Self-IP не изолированы по разделам, как и другие ресурсы на BIG-IP.
password строка / обязательно			Пароль от учетной записи пользователя для подключения к BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_PASSWORD`. псевдонимы: pass, pwd
provider словарь добавлено в 2.5			Объект словаря, содержащий данные подключения.
	password строка / обязательно		Пароль от учетной записи пользователя для подключения к BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_PASSWORD`. псевдонимы: pass, pwd
	server строка / обязательно		Хост BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_SERVER`.
	server_port целое число	По умолчанию: 443	Порт сервера BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_SERVER_PORT`.
	ssh_keyfile путь		Указывает файл SSH-ключа для аутентификации подключения к удаленному устройству. Этот аргумент используется только для транспортов cli. Вы можете опустить этот параметр, установив переменную среды `ANSIBLE_NET_SSH_KEYFILE`.
	timeout целое число	По умолчанию: 10	Указывает таймаут в секундах для связи с сетевым устройством для подключения или отправки команд. Если таймаут истекает до завершения операции, модуль выдаст ошибку.
	transport строка	Варианты: cli rest ←	Настраивает транспортное соединение для подключения к удаленному устройству.
	user строка / обязательно		Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь права администратора на устройстве. Вы можете опустить этот параметр, установив переменную среды `F5_USER`.
	validate_certs логическое значение	Варианты: no yes ←	Если `no`, сертификаты SSL не проверяются. Используйте только на сайтах, которыми вы управляете, с самоподписанными сертификатами. Вы можете опустить этот параметр, установив переменную среды `F5_VALIDATE_CERTS`.
route_domain целое число добавлено в 2.3			Идентификатор домена маршрутизации системы. При создании нового Self-IP, если это значение не указано, будет использовано значение по умолчанию `0`. Это значение нельзя изменить после установки.
server строка / обязательно			Хост BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_SERVER`.
server_port целое число добавлено в 2.2		По умолчанию: 443	Порт сервера BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_SERVER_PORT`.
state строка		Варианты: отсутствует присутствует ←	Когда `present`, гарантирует, что Self-IP существует с указанными атрибутами. Когда `absent`, удаляет Self-IP из системы.
traffic_group строка			Группа трафика для адресов Self-IP в конфигурации актив-актив, редундентного балансировщика нагрузки. При создании нового Self-IP, если это значение не указано, используется значение по умолчанию `/Common/traffic-group-local-only`.
user строка / обязательно			Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь права администратора на устройстве. Вы можете опустить этот параметр, установив переменную среды `F5_USER`.
validate_certs логическое значение добавлено в 2.0		Варианты: нет да ←	Если `no`, сертификаты SSL не проверяются. Используйте только на сайтах, которыми вы управляете, с самоподписанными сертификатами. Вы можете опустить этот параметр, установив переменную среды `F5_VALIDATE_CERTS`.
vlan строка			VLAN, на котором будут находиться новые адреса Self-IP. При создании нового Self-IP это значение обязательно.

Примечания

Примечание

Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks можно найти по адресу https://www.ansible.com/integrations/networks/f5.
Требуется версия ПО BIG-IP >= 12.
Модули F5 изменяют только текущую конфигурацию продукта F5. Чтобы убедиться, что конфигурация, специфичная для BIG-IP, сохраняется на диске, обязательно включите хотя бы одну задачу, использующую модуль 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 строка	изменённое	Адрес локального IP-адреса Пример: 192.0.2.10
allow_service список	изменённое	Сервисы, разрешенные через этот локальный IP-адрес Пример: ['igmp:0', 'tcp:22', 'udp:53']
name строка	созданное	Имя локального IP-адреса Пример: self1
netmask строка	изменённое	Маска подсети локального IP-адреса Пример: 255.255.255.0
traffic_group строка	изменённое	Группа трафика, членом которой является локальный IP-адрес Пример: traffic-group-local-only
vlan строка	изменённое	VLAN, настроенный на локальном IP-адресе Пример: vlan1

Статус

Этот модуль гарантирует отсутствие изменений интерфейса, несовместимых со старыми версиями. [stableinterface]
Этот модуль поддерживается партнёром Ansible. [certified]

Авторы

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.8/modules/bigip_selfip_module.html