junipernetworks.junos.junos_static_route – (deprecated, removed after 2022-06-01) Управление статическими маршрутами IP на устройствах Juniper JUNOS
Примечание
Этот плагин входит в коллекцию junipernetworks.junos (версия 1.2.1).
Для его установки используйте: ansible-galaxy collection install junipernetworks.junos
Для использования в playbook укажите: junipernetworks.junos.junos_static_route
New in version 1.0.0: of junipernetworks.junos
УСТАРЕВШЕЕ
- Удалили в
-
главной версии после 2022-06-01
- Почему
-
Выпущены обновленные модули с дополнительными функциями
- Альтернатива
-
Используйте junipernetworks.junos.junos_static_routes вместо него.
Обзор
- Этот модуль обеспечивает декларативное управление статическими маршрутами IP на сетевых устройствах Juniper JUNOS.
Примечание
Этот модуль имеет соответствующий плагин действий.
Требования
Ниже приведены требования к хосту, на котором выполняется этот модуль.
- ncclient (>=v0.5.2)
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| active boolean |
|
Указывает, активна или деактивирована конфигурация | |
| address строка |
Сеть адрес с префиксом статического маршрута. псевдонимы: префикс |
||
| aggregate список / элементы=словарь |
Список определений статических маршрутов | ||
| active boolean |
|
Указывает, активна или деактивирована конфигурация | |
| address строка |
Сеть адрес с префиксом статического маршрута. | ||
| next_hop строка |
IP следующей точки статического маршрута. | ||
| preference целое число |
Глобальная административная предпочтительность статического маршрута. псевдонимы: административное расстояние |
||
| qualified_next_hop строка |
Квалифицированный IP следующей точки статического маршрута. Квалифицированные следующие точки позволяют назначать предпочтительность определенному адресу следующей точки. | ||
| qualified_preference целое число |
Назначение предпочтительности для квалифицированной следующей точки. | ||
| state строка |
|
Состояние конфигурации статического маршрута. | |
| next_hop строка |
IP следующей точки статического маршрута. | ||
| preference целое число |
Глобальная административная предпочтительность статического маршрута. псевдонимы: административное расстояние |
||
| 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. |
||
| qualified_next_hop строка |
Квалифицированный IP следующей точки статического маршрута. Квалифицированные следующие точки позволяют назначать предпочтительность определенному адресу следующей точки. | ||
| qualified_preference целое число |
Назначение предпочтительности для квалифицированной следующей точки. | ||
| 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 static route
junipernetworks.junos.junos_static_route:
address: 192.168.2.0/24
next_hop: 10.0.0.1
preference: 10
qualified_next_hop: 10.0.0.2
qualified_preference: 3
state: present
- name: delete static route
junipernetworks.junos.junos_static_route:
address: 192.168.2.0/24
state: absent
- name: deactivate static route configuration
junipernetworks.junos.junos_static_route:
address: 192.168.2.0/24
next_hop: 10.0.0.1
preference: 10
qualified_next_hop: 10.0.0.2
qualified_preference: 3
state: present
active: false
- name: activate static route configuration
junipernetworks.junos.junos_static_route:
address: 192.168.2.0/24
next_hop: 10.0.0.1
preference: 10
qualified_next_hop: 10.0.0.2
qualified_preference: 3
state: present
active: true
- name: Configure static route using aggregate
junipernetworks.junos.junos_static_route:
aggregate:
- {address: 4.4.4.0/24, next_hop: 3.3.3.3, qualified_next_hop: 5.5.5.5, qualified_preference: 30}
- {address: 5.5.5.0/24, next_hop: 6.6.6.6, qualified_next_hop: 7.7.7.7, qualified_preference: 12}
preference: 10
- name: Delete static route using aggregate
junipernetworks.junos.junos_static_route:
aggregate:
- address: 4.4.4.0/24
- address: 5.5.5.0/24
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны в документации, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| diff.prepared строка |
при изменении конфигурации и включенном параметре diff. | Разница в конфигурации до и после применения изменения. Пример: [edit routing-options static] route 2.2.2.0/24 { ... } + route 4.4.4.0/24 { next-hop 3.3.3.3; qualified-next-hop 5.5.5.5 { + preference 30; } + preference 10; + } |
Статус
- Этот модуль будет удален в следующей основной версии после 2022-06-01. [устаревший]
- Дополнительная информация в УСТАРЕВШЕЕ.
Авторы
- Ganesh Nalawade (@ganeshrn)
© 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/junipernetworks/junos/junos_static_route_module.html