bigip_vlan - Управление VLAN на системе BIG-IP

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

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

Обзор

Управление VLAN на системе BIG-IP

Требования

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

f5-sdk >= 3.0.9

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
cmp_hash (добавлен в 2.5)			Указывает, как будет производиться разделение трафика в VLAN. Выбранное значение определяет метод разделения трафика. Вы можете выбрать разделение трафика по `source-address` (исходный IP-адрес), `destination-address` (адрес назначения) или `default`, что указывает на использование по умолчанию CMP-хеширования по портам L4. При создании новой VLAN, если этот параметр не указан, используется значение по умолчанию `default`.
dag_round_robin (добавлен в 2.5)		Варианты: no yes	Указывает, будет ли часть бессостоятельного трафика в VLAN распределяться в циклическом порядке (round-robin), вместо использования статического хеширования. Бессостоятельный трафик включает не-IP L2 трафик, ICMP, некоторые протоколы UDP и т.д. При создании новой VLAN, если этот параметр не указан, используется значение по умолчанию (no).
dag_tunnel (добавлен в 2.5)			Указывает, как распределитель (DAG) распределяет полученные туннелированные пакеты по экземплярам TMM. Выберите `inner` для распределения пакетов на основе информации во внутренних заголовках. Выберите `outer` для распределения пакетов на основе информации во внешних заголовках без проверки внутренних заголовков. При создании новой VLAN, если этот параметр не указан, используется значение по умолчанию `outer`. Этот параметр не поддерживается в виртуальных изданиях BIG-IP.
description			Описание VLAN.
mtu (добавлен в 2.5)			Указывает максимальное значение MTU (Maximum Transmission Unit) для трафика в этой VLAN. При создании новой VLAN, если этот параметр не указан, используется значение по умолчанию `1500`. Это число должно быть от 576 до 9198.
name обязательно			VLAN для управления. Если указана специальная VLAN `ALL` со значением `state` `absent`, все VLAN будут удалены.
partition (добавлен в 2.5)		По умолчанию: Common	Раздел устройства для управления ресурсами.
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 ←	Настраивает транспортное соединение для подключения к удалённому устройству.
server обязательно			Хост BIG-IP. Можно опустить этот параметр, если переменная окружения `F5_SERVER` установлена.
server_port (добавлен в 2.2)		По умолчанию: 443	Порт сервера BIG-IP. Можно опустить этот параметр, если переменная окружения `F5_SERVER_PORT` установлена.
state		Варианты: absent present ←	Состояние VLAN в системе. При значении `present`, гарантирует, что VLAN существует с указанными атрибутами. При значении `absent`, удаляет VLAN из системы.
tag			Номер тега VLAN. Номер тега может быть любым целым числом от 1 до 4094. Система автоматически назначит номер тега, если вы не укажете значение.
tagged_interfaces			Указывает список помеченных интерфейсов и каналов, которые вы хотите настроить для VLAN. Используйте помеченные интерфейсы или каналы, если вы хотите назначить один интерфейс или канал нескольким VLAN. псевдонимы: tagged_interface
untagged_interfaces			Указывает список непомеченных интерфейсов и каналов, которые вы хотите настроить для VLAN. псевдонимы: untagged_interface
user обязательно			Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Можно опустить этот параметр, если переменная окружения `F5_USER` установлена.
validate_certs (добавлен в 2.0)		Варианты: no yes ←	Если `no`, сертификаты SSL не будут проверены. Используйте только на сайтах, контролируемых вами, с самоподписанными сертификатами. Можно опустить этот параметр, если переменная окружения `F5_VALIDATE_CERTS` установлена.

Примечания

Примечание

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

Примеры

- name: Create VLAN
  bigip_vlan:
      name: "net1"
      password: "secret"
      server: "lb.mydomain.com"
      user: "admin"
      validate_certs: "no"
  delegate_to: localhost

- name: Set VLAN tag
  bigip_vlan:
      name: "net1"
      password: "secret"
      server: "lb.mydomain.com"
      tag: "2345"
      user: "admin"
      validate_certs: "no"
  delegate_to: localhost

- name: Add VLAN 2345 as tagged to interface 1.1
  bigip_vlan:
      tagged_interface: 1.1
      name: "net1"
      password: "secret"
      server: "lb.mydomain.com"
      tag: "2345"
      user: "admin"
      validate_certs: "no"
  delegate_to: localhost

- name: Add VLAN 1234 as tagged to interfaces 1.1 and 1.2
  bigip_vlan:
      tagged_interfaces:
          - 1.1
          - 1.2
      name: "net1"
      password: "secret"
      server: "lb.mydomain.com"
      tag: "1234"
      user: "admin"
      validate_certs: "no"
  delegate_to: localhost

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

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

Ключ	Возвращаемое	Описание
cmp_hash строка	изменено	Новый метод агрегирования трафика. Пример: source-address
dag_tunnel строка	изменено	Новая настройка туннеля DAG. Пример: outer
description строка	изменено	Описание, заданное для VLAN. Пример: VLAN foo
interfaces список	изменено	Интерфейсы, к которым назначена VLAN. Пример: ['1.1', '1.2']
partition строка	изменено	Раздел, на котором была создана VLAN. Пример: Common
tag целое число	изменено	Идентификатор VLAN. Пример: 2345

Статус

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

Автор

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.5/modules/bigip_vlan_module.html