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

Примечание

Этот модуль является частью коллекции junipernetworks.junos (версия 8.0.0).

Эта коллекция может быть уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить её установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install junipernetworks.junos. Для использования этого модуля необходимы дополнительные требования. Подробнее см. Требования.

Чтобы использовать его в книге задач, укажите: junipernetworks.junos.junos_vrf.

Новинка в junipernetworks.junos 1.0.0

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

Обзор

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

Псевдонимы: vrf

Требования

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

ncclient (>=v0.5.2)

Параметры

Параметр	Комментарии
active boolean	Указывает, активна ли конфигурация или отключена Варианты: `false` `true` ← (по умолчанию)
aggregate список / элементы=словарь	Набор объектов определения VRF, которые необходимо настроить на удалённом устройстве JUNOS. Элементы списка могут быть именем VRF или словарем с определениями и атрибутами VRF. Этот аргумент несовместим с аргументом `name`.
active boolean	Указывает, активна ли конфигурация или отключена Варианты: `false` `true`
description строка	Предоставляет краткое описание определения VRF в текущей активной конфигурации. Значение определения VRF принимает буквенно-цифровые символы, используемые для предоставления дополнительной информации о VRF.
interfaces список / элементы=строка	Определяет набор интерфейсов, которые должны быть настроены в VRF. Интерфейсы должны быть маршрутизируемыми интерфейсами, чтобы быть помещёнными в VRF.
name строка / обязательно	Имя определения VRF, которое необходимо управлять на удалённом устройстве IOS. Имя определения VRF — это строка ASCII, используемая для уникальной идентификации VRF. Этот аргумент несовместим с аргументом `aggregate`.
rd список / элементы=строка	Значение маршрутизатора-дискриминатора уникально идентифицирует VRF для маршрутизирующих процессов на удалённой системе IOS. Значение RD имеет вид `A:B`, где `A` и `B` — числовые значения.
state строка	Настраивает состояние определения VRF по отношению к операционной конфигурации устройства. При установке в present, VRF должен быть настроен в активной конфигурации устройства, а при установке в absent VRF не должен быть в активной конфигурации устройства. Варианты: `"present"` `"absent"`
table_label boolean	Принуждает JUNOS выделять VPN-метку на VRF, а не на VPN FEC. Это позволяет передавать трафик напрямую к подключённым подсетям, фильтрации COS Egress и т. д. Варианты: `false` `true`
target список / элементы=строка	Настраивает конфигурацию сообщества целей VRF. Значение target имеет вид `target:A:B`, где `A` и `B` — числовые значения.
description строка	Предоставляет краткое описание определения VRF в текущей активной конфигурации. Значение определения VRF принимает буквенно-цифровые символы, используемые для предоставления дополнительной информации о VRF.
interfaces список / элементы=строка	Определяет набор интерфейсов, которые должны быть настроены в VRF. Интерфейсы должны быть маршрутизируемыми интерфейсами, чтобы быть помещёнными в VRF.
name строка	Имя определения VRF, которое необходимо управлять на удалённом устройстве IOS. Имя определения VRF — это строка ASCII, используемая для уникальной идентификации VRF. Этот аргумент несовместим с аргументом `aggregate`
rd список / элементы=строка	Значение маршрутизатора-дискриминатора уникально идентифицирует VRF для маршрутизирующих процессов на удалённой системе IOS. Значение RD имеет вид `A:B`, где `A` и `B` — числовые значения.
state строка	Настраивает состояние определения VRF по отношению к операционной конфигурации устройства. При установке в present, VRF должен быть настроен в активной конфигурации устройства, а при установке в absent VRF не должен быть в активной конфигурации устройства. Варианты: `"present"` ← (по умолчанию) `"absent"`
table_label boolean	Принуждает JUNOS выделять VPN-метку на VRF, а не на VPN FEC. Это позволяет передавать трафик напрямую к подключённым подсетям, фильтрации COS Egress и т. д. Варианты: `false` `true` ← (по умолчанию)
target список / элементы=строка	Настраивает конфигурацию сообщества целей VRF. Значение 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, см. руководство :ref:`параметры платформы Junos OS <junos_platform_options>`.
Дополнительную информацию об использовании Ansible для управления сетевыми устройствами см. в :ref:`Руководстве по сетям Ansible <network_guide>`.
Дополнительную информацию об использовании 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; + }\n"`

Ключ

Описание

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; + }\n"

Авторы

Ganesh Nalawade (@ganeshrn)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/junipernetworks/junos/junos_vrf_module.html