junos_static_route – Управление статическими маршрутами IP в устройствах Juniper JUNOS
Новая версия 2.4.
Обзор
- Этот модуль обеспечивает декларативное управление статическими маршрутами IP в устройствах Juniper JUNOS.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- ncclient (>=v0.5.2)
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | ||
|---|---|---|---|---|
| active
boolean
|
|
Указывает, активна или деактивирована конфигурация | ||
| address
- / обязательно
|
Сеть адрес с префиксом статического маршрута. | псевдонимы: префикс |
||
| aggregate
-
|
Список определений статических маршрутов | |||
| next_hop
- / обязательно
|
IP следующего узла статического маршрута. | |||
| preference
-
|
Глобальная административная предпочтительность статического маршрута. | псевдонимы: admin_distance |
||
| provider
-
|
Устарело. Начиная с Ansible 2.5, рекомендуется использовать connection: network_cli или connection: netconf. Для получения дополнительной информации см. руководство Junos OS Platform Options. Объект словаря, содержащий данные подключения. |
|||
| host
- / обязательно
|
Указывает имя или адрес хоста DNS для подключения к удаленному устройству через указанный транспорт. Значение host используется в качестве адреса назначения для транспорта. | |||
| password
-
|
Указывает пароль для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации сессии SSH. Если значение не указано в задаче, используется значение переменной среды ANSIBLE_NET_PASSWORD. |
|||
| port
-
|
Значение по умолчанию: 22 |
Указывает порт для подключения к удаленному устройству. Значение порта по умолчанию - хорошо известный SSH-порт 22 (для transport=cli) или порт 830 (для transport=netconf) устройства. |
||
| ssh_keyfile
-
|
Указывает SSH-ключ для аутентификации подключения к удаленному устройству. Это значение - путь к ключу, используемому для аутентификации сессии SSH. Если значение не указано в задаче, используется значение переменной среды ANSIBLE_NET_SSH_KEYFILE. |
|||
| timeout
-
|
Значение по умолчанию: 10 |
Указывает таймаут в секундах для связи с сетевым устройством для подключения или отправки команд. Если таймаут истечет до завершения операции, модуль выдаст ошибку. | ||
| 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. - Этот модуль также работает с подключением
localдля устаревших playbooks. - Сведения об использовании CLI и netconf см. в руководстве Junos OS Platform Options.
- Дополнительную информацию об использовании Ansible для управления сетевыми устройствами см. в руководстве Ansible Network Guide.
- Дополнительную информацию об использовании Ansible для управления сетевыми устройствами Juniper см. на сайте https://www.ansible.com/ansible-juniper.
Примеры
- name: configure static route
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
junos_static_route:
address: 192.168.2.0/24
state: absent
- name: deactivate static route configuration
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
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
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
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; + } |
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается группой Ansible Network. [сетевой]
Поддержка Red Hat
Дополнительную информацию о поддержке Red Hat для этого модуля можно найти в этой статье базы знаний Red Hat.
Авторы
- 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.7/modules/junos_static_route_module.html
