vyos_interface - Управление интерфейсами на устройствах VyOS
Новая версия 2.4.
Обзор
- Этот модуль предоставляет декларативное управление интерфейсами на устройствах VyOS.
Параметры
| параметр | обязательный | по умолчанию | варианты | примечания |
|---|---|---|---|---|
| aggregate | нет | Список определений интерфейсов. | ||
| delay | нет | 10 | Время в секундах ожидания проверки операционного состояния на удалённом устройстве. Это ожидание применимо для аргументов операционного состояния, которые являются state со значениями up/down и neighbors. | |
| description | нет | Описание интерфейса. | ||
| duplex | нет | auto |
| Состояние соединения интерфейса. |
| enabled | нет | Состояние соединения интерфейса. | ||
| mtu | нет | Максимальный размер передаваемого пакета. | ||
| name | да | Имя интерфейса. | ||
| speed | нет | Скорость соединения интерфейса. | ||
| state | нет | present |
| Состояние конфигурации интерфейса, up означает присутствие и рабочее состояние, а down означает присутствие и нерабочее состояние down
|
Примеры
- name: configure interface
vyos_interface:
name: eth0
description: test-interface
- name: remove interface
vyos_interface:
name: eth0
state: absent
- name: make interface down
vyos_interface:
name: eth0
enabled: False
- name: make interface up
vyos_interface:
name: eth0
enabled: True
- name: Configure interface speed, mtu, duplex
vyos_interface:
name: eth5
state: present
speed: 100
mtu: 256
duplex: full
- name: Set interface using aggregate
vyos_interface:
aggregate:
- { name: eth1, description: test-interface-1, speed: 100, duplex: half, mtu: 512}
- { name: eth2, description: test-interface-2, speed: 1000, duplex: full, mtu: 256}
- name: Disable interface on aggregate
net_interface:
aggregate:
- name: eth1
- name: eth2
enabled: False
- name: Delete interface using aggregate
net_interface:
aggregate:
- name: eth1
- name: eth2
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны здесь Возвращаемые значения, следующие поля уникальны для этого модуля:
| название | описание | возвращено | тип | пример |
|---|---|---|---|---|
| commands | Список команд режима конфигурации для отправки на устройство | всегда, за исключением платформ, использующих транспорт Netconf для управления устройством. | список | ['set interfaces ethernet eth0 description "test-interface"', 'set interfaces ethernet eth0 speed 100', 'set interfaces ethernet eth0 mtu 256', 'set interfaces ethernet eth0 duplex full'] |
Примечания
Примечание
- Тестировалось на VYOS 1.1.7
Статус
Этот модуль помечен как предварительный просмотр, что означает, что он не гарантирует обратную совместимость интерфейса.
Информация о техническом обслуживании
Дополнительную информацию о поддержке данного модуля Red Hat см. по этому knowledge base article<https://access.redhat.com/articles/rhel-top-support-policies>
Для получения помощи в разработке модулей, если у вас есть такие пожелания, пожалуйста, ознакомьтесь с Информация о сообществе и вклад, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/vyos_interface_module.html