junipernetworks.junos.junos_linkagg – (устаревший, удалён после 2022-06-01) Управление группами агрегирования каналов на устройствах Juniper JUNOS
Примечание
Этот плагин входит в коллекцию junipernetworks.junos (версия 1.3.0).
Для его установки используйте: ansible-galaxy collection install junipernetworks.junos.
Чтобы использовать его в playbook, укажите: junipernetworks.junos.junos_linkagg.
В версии 1.0.0: коллекции junipernetworks.junos
УСТАРЕЛО
- Удалён в
-
главной версии после 2022-06-01
- Почему
-
Выпущены обновлённые модули с большей функциональностью
- Альтернатива
-
Используйте junipernetworks.junos.junos_lag_interfaces вместо этого.
Описание
- Этот модуль предоставляет декларативное управление группами агрегирования каналов на устройствах Juniper JUNOS.
Примечание
Этот модуль имеет соответствующий плагин действий.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- ncclient (>=v0.5.2)
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| active boolean |
| Указывает, активна или деактивирована конфигурация | |
| aggregate список / элементы=словарь | Список определений агрегирования каналов. | ||
| active boolean |
| Указывает, активна или деактивирована конфигурация | |
| description строка | Описание интерфейса. | ||
| device_count целое число | Количество агрегированных устройств Ethernet, которые можно настроить. Допустимое целое значение от 1 до 128. | ||
| members список / элементы=строка | Список интерфейсов-членов группы агрегирования каналов. Значение может быть одним интерфейсом или списком интерфейсов. | ||
| min_links целое число | Минимальное количество подключений, которые должны быть активными, прежде чем группа агрегирования каналов будет включена. | ||
| mode строка |
| Режим группы агрегирования каналов. Значение on включит LACP в режиме passive. active настраивает связь для активного получения информации о состоянии канала, или можно настроить в режиме passive, т.е. отправлять информацию о состоянии канала только при получении от другого канала. Значение off отключит LACP. | |
| name строка / обязательно | Имя группы агрегирования каналов. | ||
| state строка |
| Состояние группы агрегирования каналов. | |
| description строка | Описание интерфейса. | ||
| device_count целое число | Количество агрегированных устройств Ethernet, которые можно настроить. Допустимое целое значение от 1 до 128. | ||
| members список / элементы=строка | Список интерфейсов-членов группы агрегирования каналов. Значение может быть одним интерфейсом или списком интерфейсов. | ||
| min_links целое число | Минимальное количество подключений, которые должны быть активными, прежде чем группа агрегирования каналов будет включена. | ||
| mode строка |
| Режим группы агрегирования каналов. Значение on включит LACP в режиме passive. active настраивает связь для активного получения информации о состоянии канала, или можно настроить в режиме passive, т.е. отправлять информацию о состоянии канала только при получении от другого канала. Значение off отключит LACP. | |
| name строка | Имя группы агрегирования каналов. | ||
| provider словарь | Устарело Начиная с Ansible 2.5, рекомендуется использовать connection: network_cli или connection: netconf. Для получения дополнительной информации, см. руководство Junos OS Platform Options. Объект словаря, содержащий сведения о подключении. | ||
| host строка | Указывает имя хоста DNS или адрес для подключения к удалённому устройству по указанному транспорту. Значение host используется в качестве адреса назначения для транспорта. | ||
| password строка | Указывает пароль для аутентификации соединения с удалённым устройством. Это значение используется для аутентификации SSH-сессии. Если значение не указано в задаче, используется значение переменной среды ANSIBLE_NET_PASSWORD. | ||
| port целое число | Указывает порт, используемый при построении соединения с удалённым устройством. Значение порта по умолчанию — хорошо известный порт SSH 22 (для transport=cli) или порт 830 (для transport=netconf) устройства. | ||
| ssh_keyfile путь | Указывает SSH-ключ для аутентификации соединения с удалённым устройством. Это значение — путь к ключу, используемому для аутентификации SSH-сессии. Если значение не указано в задаче, используется значение переменной среды ANSIBLE_NET_SSH_KEYFILE. | ||
| timeout целое число | Указывает время ожидания в секундах для связи с сетевым устройством при подключении или отправке команд. Если время ожидания истечёт до завершения операции, модуль выдаст ошибку. | ||
| transport строка |
| Настраивает транспортное соединение для подключения к удалённому устройству. | |
| username строка | Настраивает имя пользователя для аутентификации соединения с удалённым устройством. Это значение используется для аутентификации SSH-сессии. Если значение не указано в задаче, используется значение переменной среды ANSIBLE_NET_USERNAME. | ||
| state строка |
| Состояние группы агрегирования каналов. | |
Примечания
Примечание
- Этот модуль требует, чтобы на удалённом управляемом устройстве был включён системный сервис netconf.
- Проверено на vSRX JUNOS версии 15.1X49-D15.4, vqfx-10000 JUNOS версии 15.1X53-D60.4.
- Рекомендуемое подключение —
netconf. См. руководство Junos OS Platform Options. - Этот модуль также работает с подключениями
localдля устаревших playbooks. - Дополнительную информацию об использовании CLI и netconf см. в руководстве Junos OS Platform Options
- Дополнительную информацию об использовании Ansible для управления сетевыми устройствами см. в руководстве Ansible Network Guide
- Дополнительную информацию об использовании Ansible для управления устройствами Juniper см. в https://www.ansible.com/ansible-juniper.
Примеры
- name: configure link aggregation
junipernetworks.junos.junos_linkagg:
name: ae11
members:
- ge-0/0/5
- ge-0/0/6
- ge-0/0/7
lacp: active
device_count: 4
state: present
- name: delete link aggregation
junipernetworks.junos.junos_linkagg:
name: ae11
members:
- ge-0/0/5
- ge-0/0/6
- ge-0/0/7
lacp: active
device_count: 4
state: delete
- name: deactivate link aggregation
junipernetworks.junos.junos_linkagg:
name: ae11
members:
- ge-0/0/5
- ge-0/0/6
- ge-0/0/7
lacp: active
device_count: 4
state: present
active: false
- name: Activate link aggregation
junipernetworks.junos.junos_linkagg:
name: ae11
members:
- ge-0/0/5
- ge-0/0/6
- ge-0/0/7
lacp: active
device_count: 4
state: present
active: true
- name: Disable link aggregation
junipernetworks.junos.junos_linkagg:
name: ae11
state: down
- name: Enable link aggregation
junipernetworks.junos.junos_linkagg:
name: ae11
state: up
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие — поля, уникальные для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| diff string | при изменении конфигурации и включенном параметре diff. | Разница в конфигурации до и после применения изменения. Пример: [edit interfaces] + ge-0/0/6 { + ether-options { + 802.3ad ae0; + } + } [edit interfaces ge-0/0/7] + ether-options { + 802.3ad ae0; + } [edit interfaces] + ae0 { + description "configured by junos_linkagg"; + aggregated-ether-options { + lacp { + active; + } + } + } |
Статус
- Этот модуль будет удален в крупном релизе после 2022-06-01. [устаревший]
- Для получения дополнительной информации см. УСТАРЕВШИЙ.
Авторы
- Ganesh Nalawade (@ganeshrn)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/junipernetworks/junos/junos_linkagg_module.html