junipernetworks.junos.junos_vrf – Управление определениями VRF на устройствах Juniper JUNOS

Примечание

Этот плагин входит в коллекцию junipernetworks.junos (версия 1.2.1).

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

Для использования в playbook, укажите: junipernetworks.junos.junos_vrf.

Новое в версии 1.0.0: of junipernetworks.junos

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

Обзор

Этот модуль предоставляет декларативное управление определениями VRF на устройствах Juniper JUNOS. Он позволяет playbooks управлять отдельными или всеми определениями VRF.

Примечание

У этого модуля есть соответствующий плагин действий.

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

ncclient (>=v0.5.2)

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
active boolean		Варианты: no да ←	Указывает, активна или деактивирована конфигурация
aggregate список / элементы=словарь			Набор объектов определения VRF, которые должны быть настроены на удалённом устройстве JUNOS. Элементы списка могут быть именем VRF или хэш-таблицей определений и атрибутов VRF. Этот аргумент взаимоисключает с аргументом `name`.
	active boolean	Варианты: no yes	Указывает, активна или деактивирована конфигурация
	description строка		Предоставляет краткое описание определения VRF в текущей активной конфигурации. Значение определения VRF принимает алфавитно-цифровые символы, используемые для предоставления дополнительной информации о VRF.
	interfaces список / элементы=строка		Определяет набор интерфейсов, которые должны быть настроены в VRF. Интерфейсы должны быть маршрутизируемыми, чтобы быть помещёнными в VRF.
	name строка / обязательно		Имя определения VRF, подлежащего управлению на удалённом устройстве IOS. Имя определения VRF — это строка ASCII, используемая для уникальной идентификации VRF. Этот аргумент взаимоисключает с аргументом `aggregate`
	rd список / элементы=строка		Значение router-distinguisher, уникально идентифицирующее VRF для процессов маршрутизации на удалённой системе IOS. Значение RD имеет вид `A:B`, где `A` и `B` — числовые значения.
	state строка	Варианты: present absent	Настраивает состояние определения VRF по отношению к операционной конфигурации устройства. При значении present VRF должен быть настроен в активной конфигурации устройства, а при значении absent — нет.
	table_label boolean	Варианты: no yes	Принуждает JUNOS выделять VPN-метку на VRF, а не на VPN FEC. Это позволяет пересылать трафик к непосредственно подключённым подсетям, фильтрации COS Egress и т. д.
	target список / элементы=строка		Настраивает конфигурацию сообщества VRF target. Значение target имеет вид `target:A:B`, где `A` и `B` — числовые значения.
description строка			Предоставляет краткое описание определения VRF в текущей активной конфигурации. Значение определения VRF принимает алфавитно-цифровые символы, используемые для предоставления дополнительной информации о VRF.
interfaces список / элементы=строка			Определяет набор интерфейсов, которые должны быть настроены в VRF. Интерфейсы должны быть маршрутизируемыми, чтобы быть помещёнными в VRF.
name строка			Имя определения VRF, подлежащего управлению на удалённом устройстве IOS. Имя определения VRF — это строка ASCII, используемая для уникальной идентификации VRF. Этот аргумент взаимоисключает с аргументом `aggregate`
provider словарь			Устарело Начиная с Ansible 2.5, рекомендуем использовать `connection: network_cli` или `connection: netconf`. Для получения дополнительной информации см. руководство по параметрам платформы Junos OS Platform Options guide. Объект словаря, содержащий данные соединения.
	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 строка	Варианты: cli netconf ←	Настраивает транспортное соединение для подключения к удалённому устройству.
	username строка		Настраивает имя пользователя для аутентификации подключения к удалённому устройству. Это значение используется для аутентификации SSH-сессии. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_USERNAME`.
rd список / элементы=строка			Значение router-distinguisher, уникально идентифицирующее VRF для процессов маршрутизации на удалённой системе IOS. Значение RD имеет вид `A:B`, где `A` и `B` — числовые значения.
state строка		Варианты: present ← absent	Настраивает состояние определения VRF по отношению к операционной конфигурации устройства. При значении present VRF должен быть настроен в активной конфигурации устройства, а при значении absent — нет.
table_label boolean		Варианты: no да ←	Принуждает JUNOS выделять VPN-метку на VRF, а не на VPN FEC. Это позволяет пересылать трафик к непосредственно подключённым подсетям, фильтрации COS Egress и т. д.
target список / элементы=строка			Настраивает конфигурацию сообщества VRF target. Значение target имеет вид `target:A:B`, где `A` и `B` — числовые значения.

Примечания

Примечание

Для работы данного модуля требуется включить службу netconf на управляемом удалённом устройстве.
Проверено на vSRX JUNOS версии 15.1X49-D15.4, vqfx-10000 JUNOS версии 15.1X53-D60.4.
Рекомендуемое подключение netconf. См. страницы параметров платформы Junos OS.
Этот модуль также работает с local подключениями для устаревших playbooks.
Сведения об использовании CLI и netconf см. в руководстве по параметрам платформы Junos OS
Дополнительную информацию об использовании Ansible для управления сетевыми устройствами см. в руководстве по сетям Ansible
Дополнительную информацию об использовании Ansible для управления сетевыми устройствами Juniper см. в https://www.ansible.com/ansible-juniper.

Примеры

- name: Configure vrf configuration
  junipernetworks.junos.junos_vrf:
    name: test-1
    description: test-vrf-1
    interfaces:
    - ge-0/0/3
    - ge-0/0/2
    rd: 192.0.2.1:10
    target: target:65514:113
    state: present

- name: Remove vrf configuration
  junipernetworks.junos.junos_vrf:
    name: test-1
    description: test-vrf-1
    interfaces:
    - ge-0/0/3
    - ge-0/0/2
    rd: 192.0.2.1:10
    target: target:65514:113
    state: absent

- name: Deactivate vrf configuration
  junipernetworks.junos.junos_vrf:
    name: test-1
    description: test-vrf-1
    interfaces:
    - ge-0/0/3
    - ge-0/0/2
    rd: 192.0.2.1:10
    target: target:65514:113
    active: false

- name: Activate vrf configuration
  junipernetworks.junos.junos_vrf:
    name: test-1
    description: test-vrf-1
    interfaces:
    - ge-0/0/3
    - ge-0/0/2
    rd: 192.0.2.1:10
    target: target:65514:113
    active: true

- name: Create vrf using aggregate
  junipernetworks.junos.junos_vrf:
    aggregate:
    - name: test-1
      description: test-vrf-1
      interfaces:
      - ge-0/0/3 - ge-0/0/2
      rd: 192.0.2.1:10
      target: target:65514:113
    - name: test-2
      description: test-vrf-2
      interfaces:
      - ge-0/0/4
      - ge-0/0/5
      rd: 192.0.2.2:10
      target: target:65515:114
  state: present

Значения возврата

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

Ключ	Возвращаемое значение	Описание
diff.prepared строка	при изменении конфигурации и включенном варианте diff.	Разница в конфигурации до и после применения изменения. Пример: [edit routing-instances] + test-1 { + description test-vrf-1; + instance-type vrf; + interface ge-0/0/2.0; + interface ge-0/0/3.0; + route-distinguisher 192.0.2.1:10; + vrf-target target:65514:113; + }

Авторы

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_vrf_module.html