f5networks.f5_modules.bigip_static_route – Управление статическими маршрутами на BIG-IP

Примечание

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

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

Чтобы использовать его в playbook, укажите: f5networks.f5_modules.bigip_static_route.

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

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

Обзор

Управление статическими маршрутами на системе BIG-IP.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
описание строка			Описание, идентифицирующее маршрут.
назначение строка			Указывает IP-адрес для статической записи в таблице маршрутизации. При создании нового статического маршрута это значение необходимо. Это значение нельзя изменить после его установки.
адрес_шлюза строка			Указывает маршрутизатор, который система должна использовать при пересылке пакетов на целевой хост или сеть. Также известен как адрес маршрутизатора следующего шага. Может быть адресом IPv4 или IPv6. Если это адрес IPv6, начинающийся с `FE80:`, адрес обрабатывается как адрес локальной ссылки. Требуется также параметр `vlan`.
mtu строка			Указывает определенный максимальный размер пакета (MTU).
имя строка / обязательно			Имя статического маршрута.
маска_сети строка			Маска подсети для статического маршрута. При создании нового статического маршрута это значение необходимо. Это значение может быть в формате IP или CIDR. Это значение нельзя изменить после его установки.
раздел строка		По умолчанию: "Общие"	Раздел устройства для управления ресурсами.
пул строка			Указывает пул, через который система пересылает пакеты на пункт назначения.
поставщик словарь добавлен в 1.0.0 модуля f5networks.f5_modules			Объект словаря, содержащий данные подключения.
	поставщик_аутентификации строка		Настраивает поставщика аутентификации для получения маркеров аутентификации от удаленного устройства. Этот параметр фактически используется при работе с устройствами BIG-IQ.
	no_f5_teem булево	Варианты: нет да	Если `yes`, данные телеметрии TEEM не отправляются в F5. Вы можете опустить этот параметр, установив переменную среды `F5_TEEM`.
	пароль строка / обязательно		Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_PASSWORD`. псевдонимы: pass, pwd
	сервер строка / обязательно		Хост BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_SERVER`.
	порт_сервера целое число	По умолчанию: 443	Порт сервера BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_SERVER_PORT`.
	таймаут целое число		Указывает таймаут в секундах для связи с сетевым устройством при подключении или отправке команд. Если таймаут истечет до завершения операции, модуль выдаст ошибку.
	транспорт строка	Варианты: rest ←	Настраивает транспортное соединение для подключения к удаленному устройству.
	пользователь строка / обязательно		Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь права администратора на устройстве. Вы можете опустить этот параметр, установив переменную среды `F5_USER`.
	validate_certs булево	Варианты: нет да ←	Если `no`, сертификаты SSL не проверяются. Используйте это только на контролируемых вами сайтах, использующих самозаверяющие сертификаты. Вы можете опустить этот параметр, установив переменную среды `F5_VALIDATE_CERTS`.
отклонить булево		Варианты: нет да	Указывает, что система отбрасывает пакеты, отправленные на пункт назначения.
домен_маршрута целое число			Идентификатор домена маршрута системы. При создании нового статического маршрута, если это значение не указано, по умолчанию оно равно `0`. Это значение нельзя изменить после его установки.
состояние строка		Варианты: настоящий ← отсутствующий	Если `present`, гарантирует существование статического маршрута. Если `absent`, гарантирует, что статический маршрут не существует.
vlan строка			Указывает VLAN или туннель, через который система пересылает пакеты на пункт назначения. Если `gateway_address` — это адрес локальной ссылки IPv6, это значение необходимо.

Примечания

Примечание

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

Примеры

- name: Create static route with gateway address
  bigip_static_route:
    destination: 10.10.10.10
    netmask: 255.255.255.255
    gateway_address: 10.2.2.3
    name: test-route
    provider:
      password: secret
      server: lb.mydomain.come
      user: admin
      validate_certs: no
  delegate_to: localhost

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

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

Ключ	Возвращаемое значение	Описание
описание строка	изменено	Описание, идентифицирующее маршрут. Пример: Маршрут до DMZ
назначение строка	изменено	IP-адрес для статической записи в таблице маршрутизации. Пример: 0.0.0.0/0
адрес_шлюза строка	изменено	Маршрутизатор для использования системой при пересылке пакетов на целевой хост или сеть. Пример: 10.2.2.3
маска_сети строка	изменено	Маска подсети назначения. Пример: 255.255.255.255
раздел строка	изменено	Раздел, в котором был создан статический маршрут. Пример: Общие
пул строка	изменено	Включен ли баннер или нет. Пример: True
отклонить булево	изменено	Указывает, что система отбрасывает пакеты, отправленные на пункт назначения. Пример: True
домен_маршрута целое число	изменено	Идентификатор домена маршрута системы. Пример: 1
vlan строка	изменено	VLAN или туннель, через который система пересылает пакеты на пункт назначения. Пример: /Общие/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.10/collections/f5networks/f5_modules/bigip_static_route_module.html