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

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

Обзор
- Требования
Параметры
Примечания
Примеры
Значения возврата
Статус
- Автор

Обзор

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

Требования

Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.

f5-sdk >= 3.0.9
netaddr

Параметры

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

Примечания

Примечание

Требуется пакет Python netaddr на хосте.
Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
Требуется пакет Python f5-sdk на хосте. Это так же просто, как pip install f5-sdk.

Примеры

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

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

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

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

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

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

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

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

Значения возврата

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

Ключ	Возвращаемое значение	Описание
address строка	создано	Адрес для IP-адреса Self Пример: 192.0.2.10
allow_service список	изменено	Сервисы, разрешенные через этот IP-адрес Self Пример: ['igmp:0', 'tcp:22', 'udp:53']
name строка	создано, изменено и удалено	Имя IP-адреса Self Пример: self1
netmask строка	изменено и создано	Маска сети IP-адреса Self Пример: 255.255.255.0
traffic_group строка	изменено и создано	Группа трафика, членом которой является IP-адрес Self Пример: traffic-group-local-only
vlan строка	изменено и создано	Настроенный VLAN на IP-адресе Self Пример: vlan1

Статус

Этот модуль помечен как превью, что означает, что его интерфейс не гарантирует обратную совместимость.

Автор

Tim Rupp (@caphrim007)

Подсказка

Если вы заметили какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/bigip_selfip_module.html