Spec-Zone.ru › Ansible

f5networks.f5_modules.bigip_trunk модуль — Управление каналами на BIG-IP

Примечание

Этот модуль входит в коллекцию f5networks.f5_modules (версия 1.31.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

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

Для использования в плейбуке укажите: f5networks.f5_modules.bigip_trunk.

Новая функция в f5networks.f5_modules 1.0.0

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

Обзор

  • Управляет каналами на BIG-IP.

Параметры

Параметр

Комментарии

description

string

Описание магистрали.

frame_distribution_hash

string

Указывает основу для хэша, который система использует в качестве алгоритма распределения кадров. Система использует результирующий хэш для определения того, какой интерфейс использовать для пересылки трафика.

При создании новой магистрали, если этот параметр не указан, по умолчанию используется source-destination-ip.

Когда source-destination-mac, указывает, что система основывает хэш на комбинированных MAC-адресах источника и получателя.

Когда destination-mac, указывает, что система основывает хэш на MAC-адресе получателя.

Когда source-destination-ip, указывает, что система основывает хэш на комбинированных IP-адресах источника и получателя.

Варианты:

  • "destination-mac"
  • "source-destination-ip"
  • "source-destination-mac"

interfaces

list / elements=string

Интерфейсы, которые являются частью магистрали.

Чтобы очистить список интерфейсов, укажите пустой список.

lacp_enabled

boolean

Когда true, указывает, что система поддерживает протокол управления агрегацией каналов (LACP), который отслеживает магистраль, обмениваясь управляющими пакетами по каналам-членам для определения работоспособности каналов.

Если LACP обнаруживает сбой в канале-члене, он удаляет канал из агрегации каналов.

При создании новой магистрали, если этот параметр не указан, LACP false.

LACP отключен по умолчанию для обратной совместимости. Если это не относится к вашей сети, мы рекомендуем включить LACP.

Варианты:

  • false
  • true

lacp_mode

string

Указывает режим работы для протокола управления агрегацией каналов (LACP), если LACP включен для магистрали.

При создании новой магистрали, если этот параметр не указан, по умолчанию используется active.

Когда active, указывает, что система периодически отправляет управляющие пакеты независимо от того, запросил ли это партнерская система.

Когда passive, указывает, что система отправляет управляющие пакеты только тогда, когда партнерская система отправила запрос.

Варианты:

  • "active"
  • "passive"

lacp_timeout

string

Указывает скорость, с которой система отправляет управляющие пакеты LACP.

При создании новой магистрали, если этот параметр не указан, по умолчанию используется long.

Когда long, указывает, что система отправляет управляющий пакет LACP каждые 30 секунд.

Когда short, указывает, что система отправляет управляющий пакет LACP каждую секунду.

Варианты:

  • "long"
  • "short"

link_selection_policy

string

После настройки магистрали указывает политику, которую магистраль использует для определения того, какой канал-член (интерфейс) может обрабатывать новый трафик.

При создании новой магистрали, если это значение не указано, по умолчанию используется auto.

Когда auto, указывает, что система автоматически определяет, какие интерфейсы могут обрабатывать новый трафик. Для варианта auto каналы-члены должны быть одного типа носителя и скорости.

Когда maximum-bandwidth, указывает, что система определяет, какие интерфейсы могут обрабатывать новый трафик, на основе максимальной пропускной способности членов.

Варианты:

  • "auto"
  • "maximum-bandwidth"

name

string / required

Указывает имя магистрали.

provider

dictionary

добавлено в f5networks.f5_modules 1.0.0

Объект dict, содержащий данные подключения.

auth_provider

string

Настраивает поставщика авторизации для получения маркеров аутентификации от удаленного устройства.

Этот параметр действительно используется при работе с устройствами BIG-IQ.

no_f5_teem

boolean

Если yes, данные телеметрии TEEM не отправляются в F5.

Вы можете пропустить этот параметр, установив переменную среды F5_TELEMETRY_OFF.

Ранее используемая переменная F5_TEEM устарела, так как ее название было запутанным.

Варианты:

  • false ← (по умолчанию)
  • true

password

алиасы: pass, pwd

string / required

Пароль для учетной записи пользователя, используемой для подключения к BIG-IP или BIG-IQ.

Вы можете пропустить этот параметр, установив переменную среды F5_PASSWORD.

server

string / required

Хост BIG-IP или хост BIG-IQ.

Вы можете пропустить этот параметр, установив переменную среды F5_SERVER.

server_port

integer

Порт сервера BIG-IP.

Вы можете пропустить этот параметр, установив переменную среды F5_SERVER_PORT.

По умолчанию: 443

timeout

integer

Указывает время ожидания в секундах для связи с сетевым устройством для подключения или отправки команд. Если время ожидания истечет до завершения операции, модуль выдаст ошибку.

transport

string

Настраивает соединение транспорта для подключения к удаленному устройству.

Варианты:

  • "rest" ← (по умолчанию)

user

string / обязательно

Имя пользователя для подключения к BIG-IP или BIG-IQ. У этого пользователя должны быть административные привилегии на устройстве.

Этот параметр можно опустить, установив переменную среды F5_USER.

validate_certs

boolean

Если no, сертификаты SSL не проверяются. Используйте это только на сайтах, контролируемых вами лично, использующих самозаверенные сертификаты.

Этот параметр можно опустить, установив переменную среды F5_VALIDATE_CERTS.

Варианты:

  • false
  • true ← (по умолчанию)

qinq_ethertype

any

Указывает значение ether-type, используемое для пакетов, обрабатываемых на этом канале, когда он является членом VLAN QinQ.

Ether-type можно установить на любое строковое значение, содержащее допустимое шестнадцатеричное число из 16 бит, или любое из известных ether-type; 0x8100, 0x9100, 0x88a8.

Этот параметр не поддерживается в виртуальных изданиях.

Вы всегда должны заключать это значение в кавычки, чтобы предотвратить интерпретацию Ansible значения как буквального шестнадцатеричного числа и преобразование его в целое число.

state

string

Когда present, гарантирует существование ресурса.

Когда absent, гарантирует удаление ресурса.

Варианты:

  • "present" ← (по умолчанию)
  • "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 trunk on hardware
  bigip_trunk:
    name: trunk1
    interfaces:
      - 1.1
      - 1.2
    link_selection_policy: maximum-bandwidth
    frame_distribution_hash: destination-mac
    lacp_enabled: true
    lacp_mode: passive
    lacp_timeout: short
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

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

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

Ключ

Описание

description

string

Описание канала.

Возвращается: changed

Пример: "My trunk"

frame_distribution_hash

string

Хэш, используемый системой как алгоритм распределения кадров.

Возвращается: changed

Пример: "src-dst-ipport"

interfaces

list / elements=string

Интерфейсы, которые являются частью канала.

Возвращается: changed

Пример: ["int1", "int2"]

lacp_enabled

boolean

Поддерживает ли система протокол агрегирования каналов связи LACP или нет.

Возвращается: changed

Пример: true

lacp_mode

string

Режим работы LACP, если опция lacp включена для канала.

Возвращается: changed

Пример: "active"

lacp_timeout

string

Скорость, с которой система отправляет пакеты управления LACP.

Возвращается: changed

Пример: "long"

link_selection_policy

string

Политика LACP, используемая каналом для определения, какой членский интерфейс может обрабатывать новый трафик.

Возвращается: changed

Пример: "auto"

qinq_ethertype

string

Значение ether-type, используемое для пакетов, обрабатываемых на этом канале, когда он является членом VLAN QinQ.

Возвращается: changed

Пример: "37120"

Авторы

  • Tim Rupp (@caphrim007)
  • Wojciech Wypior (@wojtek0806)

Ссылки на коллекцию

  • Система отслеживания ошибок
  • Главная страница
  • Репозиторий (исходные коды)

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/f5networks/f5_modules/bigip_trunk_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API