f5networks.f5_modules.bigip_apm_network_access – Управление ресурсом доступа APM к сети

Примечание

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

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

Для использования в книге задач укажите: f5networks.f5_modules.bigip_apm_network_access.

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

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

Описание

Управление ресурсом доступа APM к сети.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
allow_local_dns boolean		Варианты: no yes	Включает локальный доступ к серверам DNS, настроенным на клиенте до установления подключения к сети.
allow_local_subnet boolean		Варианты: no yes	Включает доступ к локальной подсети и локальный доступ к любому хосту или подсети в маршрутах, указанных в таблице маршрутизации клиента. Когда `yes` система не поддерживает встроенную фильтрацию IP.
description string			Описание доступа к сети, созданное пользователем.
dns_address_space list / elements=string			Указывает список доменных имен, описывающих целевые адреса DNS локальной сети.
dtls boolean		Варианты: no yes	Когда `yes` подключение к сети использует Datagram Transport Layer Security вместо TCP, чтобы обеспечить лучшую пропускную способность для приложений с высокой нагрузкой, таких как VoIP или потоковое видео.
dtls_port integer			Указывает номер порта, используемый ресурсом доступа к сети для защищенного трафика UDP с DTLS.
excluded_dns_addresses list / elements=string			Указывает пространства имён DNS, для которых трафик не принудительно направляется через туннель.
excluded_ipv4_adresses list / elements=dictionary			Указывает пространства имён IPv4, для которых трафик не принудительно направляется через туннель.
	subnet string		Адрес подсети в формате CIDR, например `192.168.1.0/24`. Адреса хостов могут быть указаны без обозначения маски CIDR.
excluded_ipv6_adresses list / elements=dictionary			Указывает пространства имён IPv6, для которых трафик не принудительно направляется через туннель.
	subnet string		Адрес подсети в формате CIDR, например `2001:db8:abcd:8000::/52`. Адреса хостов могут быть указаны без обозначения маски CIDR.
ip_version string		Варианты: ipv4 ipv4-ipv6	Поддерживаемая версия IP в ресурсе доступа к сети.
ipv4_address_space list / elements=dictionary			Указывает список IPv4 хостов или сетей, описывающих целевую локальную сеть. Этот параметр обязателен при создании нового ресурса, и `split_tunnel` имеет значение `yes`.
	subnet string		Адрес подсети в формате CIDR, например `192.168.1.0/24`. Адреса хостов могут быть указаны без обозначения маски CIDR.
ipv4_lease_pool string			Указывает ресурс пула аренды IPV4 для использования с доступом к сети. Ссылка на пул может быть в полном формате пути, например `/Common/pool_name`. Когда пул аренды указан в полном формате пути, параметр `partition` игнорируется.
ipv6_address_space list / elements=dictionary			Указывает список IPv6 хостов или сетей, описывающих целевую локальную сеть. Этот параметр обязателен при создании нового ресурса, и `split_tunnel` имеет значение `yes`.
	subnet string		Адрес подсети в формате CIDR, например `2001:db8:abcd:8000::/52`. Адреса хостов могут быть указаны без обозначения маски CIDR.
ipv6_lease_pool string			Указывает ресурс пула аренды IPV6 для использования с доступом к сети. Ссылка на пул может быть в полном формате пути, например `/Common/pool_name`. Когда пул аренды указан в полном формате пути, параметр `partition` игнорируется.
name string / required			Указывает имя доступа APM к сети, которое необходимо управлять/создать.
partition string		По умолчанию: "Common"	Раздел устройства для управления ресурсами.
provider dictionary добавлено в 1.0.0 f5networks.f5_modules			Объект словаря, содержащий сведения о подключении.
	auth_provider string		Настраивает поставщика авторизации для получения маркеров аутентификации с удаленного устройства. Этот параметр действительно используется при работе с устройствами BIG-IQ.
	no_f5_teem boolean	Варианты: no yes	Если `yes`, данные телеметрии TEEM не отправляются в F5. Можно опустить этот параметр, установив переменную среды `F5_TEEM`.
	password string / required		Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Можно опустить этот параметр, установив переменную среды `F5_PASSWORD`. псевдонимы: pass, pwd
	server string / required		Хост BIG-IP. Можно опустить этот параметр, установив переменную среды `F5_SERVER`.
	server_port integer	По умолчанию: 443	Порт сервера BIG-IP. Можно опустить этот параметр, установив переменную среды `F5_SERVER_PORT`.
	timeout integer		Устанавливает таймаут в секундах для связи с устройством сети для подключения или отправки команд. Если таймаут превышен до завершения операции, модуль вернёт ошибку.
	transport string	Варианты: rest ←	Настраивает транспортное соединение для использования при подключении к удалённому устройству.
	user string / required		Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные права на устройстве. Можно опустить этот параметр, установив переменную среды `F5_USER`.
	validate_certs boolean	Варианты: no yes ←	Если `no`, сертификаты SSL не проверяются. Используйте только на контролируемых вами сайтах с самозаверяющими сертификатами. Можно опустить этот параметр, установив переменную среды `F5_VALIDATE_CERTS`.
snat_pool string			Указывает имя пула SNAT, используемого для реализации выборочных и интеллектуальных SNAT. Если `none`, для этого сетевого ресурса не используется пул SNAT. Если `automap`, система использует все собственные IP-адреса в качестве адресов трансляции для пула.
split_tunnel boolean		Варианты: no yes	Указывает, что только трафик, направленный в указанное адресное пространство, отправляется через туннель доступа к сети.
state string		Варианты: present ← absent	Если `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 a split tunnel IPV4 Network Access
  bigip_apm_network_access:
    name: foobar
    ip_version: ipv4
    split_tunnel: yes
    snat_pool: "none"
    ipv4_lease_pool: leasefoo
    ipv4_address_space:
      - subnet: 10.10.1.1
      - subnet: 10.10.2.0/24
    excluded_ipv4_adresses:
      - subnet: 192.168.1.0/24
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

- name: Modify a split tunnel IPV4 Network Access
  bigip_apm_network_access:
    name: foobar
    snat_pool: /Common/poolsnat
    ipv4_address_space:
      - subnet: 172.16.23.0/24
    excluded_ipv4_adresses:
      - subnet: 10.10.2.0/24
    allow_local_subnet: yes
    allow_local_dns: yes
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

- name: Remove Network Access
  bigip_apm_network_access:
    name: foobar
    state: absent
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

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

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

Ключ		Возвращаемое значение	Описание
allow_local_dns boolean		changed	Включает локальный доступ к серверам DNS, настроенным на клиенте. Пример: True
allow_local_subnet boolean		changed	Включает локальный доступ к подсетям. Пример: True
description string		changed	Новое описание сетевого доступа. Пример: Мой доступ
dns_address_space list / elements=string		changed	Указывает список доменных имен, описывающих целевые адреса DNS локальной сети. Пример: ['internal.net', '*.engnet.org']
dtls boolean		changed	Включает использование DTLS для сетевого доступа.
dtls_port integer		changed	Указывает номер порта, используемый ресурсом сетевого доступа для DTLS. Пример: 4433
excluded_dns_addresses list / elements=string		changed	Указывает пространства адресов DNS, для которых трафик не принудительно направляется через туннель. Пример: ['foobar.com', 'bazbar.org']
excluded_ipv4_adresses complex		changed	Указывает пространства адресов IPv4, для которых трафик не принудительно направляется через туннель. Пример: словарь/список значений
	subnet string	changed	Адрес хоста или сети. Пример: 192.168.10.1
excluded_ipv6_adresses complex		changed	Указывает пространства адресов IPv6, для которых трафик не принудительно направляется через туннель. Пример: словарь/список значений
	subnet string	changed	Адрес хоста или сети. Пример: 2001:DB8:ABCD:0012::0
ip_version string		changed	Поддерживаемая версия IP для ресурса сетевого доступа. Пример: ipv4-ipv6
ipv4_address_space complex		changed	Указывает список IPv4-хостов или сетей, описывающих целевую локальную сеть. Пример: словарь/список значений
	subnet string	changed	Адрес хоста или сети. Пример: 192.168.10.1
ipv4_lease_pool string		changed	Указывает ресурс пула аренды IPv4 для использования с сетевым доступом. Пример: /Common/leasepoolv4
ipv6_address_space complex		changed	Указывает список IPv6-хостов или сетей, описывающих целевую локальную сеть. Пример: словарь/список значений
	subnet string	changed	Адрес хоста или сети. Пример: 2001:DB8:ABCD:0012::0
ipv6_lease_pool string		changed	Указывает ресурс пула аренды IPv6 для использования с сетевым доступом. Пример: /Common/leasepoolv6
snat_pool string		changed	Имя пула SNAT, используемого ресурсом сетевого доступа. Пример: /Common/my-pool
split_tunnel boolean		changed	Включает разделенный туннель для ресурса сетевого доступа. Пример: True

Авторы

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