Spec-Zone.ru › Ansible 2.11

junipernetworks.junos.junos_interface – (deprecated, removed after 2022-06-01) Управление интерфейсом на устройствах Juniper JUNOS

Примечание

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

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

Для использования в книге задач укажите: junipernetworks.junos.junos_interface.

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

  • УСТАНОВЛЕНО
  • Описание
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения
  • Статус

УСТАНОВЛЕНО

Удалено в

главной версии после 2022-06-01

Почему

Обновленные модули выпущены с большей функциональностью

Альтернатива

Используйте junipernetworks.junos.junos_interfaces вместо этого.

Описание

  • Этот модуль предоставляет декларативное управление интерфейсами на устройствах Juniper JUNOS.

Примечание

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

Требования

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

  • ncclient (>=v0.5.2)

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
active
boolean
    Варианты:
  • нет
  • да ←
Указывает, активна или деактивирована конфигурация
aggregate
список / элементы=словарь
Список определений интерфейсов.
active
boolean
    Варианты:
  • нет
  • да
Указывает, активна или деактивирована конфигурация
delay
целое число
Время в секундах ожидания перед проверкой оперативного состояния на удалённом устройстве. Это ожидание применимо для аргументов оперативного состояния, которые являются state со значениями up/down, tx_rate и rx_rate.
description
строка
Описание интерфейса.
duplex
строка
    Варианты:
  • полный
  • полудуплексный
  • автоматический
Статус соединения интерфейса.
enabled
boolean
    Варианты:
  • нет
  • да
Настройка статуса соединения интерфейса.
mtu
целое число
Максимальный размер передаваемого пакета.
name
строка / обязательно
Имя интерфейса.
neighbors
список / элементы=словарь
Проверка оперативного состояния данного интерфейса name для соседа LLDP.
Доступны следующие подварианты.
host
строка
Хост соседа LLDP для данного интерфейса name.
port
строка
Порт соседа LLDP, к которому подключен данный интерфейс name.
rx_rate
строка
Скорость приёма в битах в секунду (бит/с).
Этот параметр предназначен только для проверки состояния.
Поддерживает условные выражения, см. Условные выражения в модулях сетевых операций
speed
строка
Скорость соединения интерфейса.
state
строка
    Варианты:
  • present
  • absent
  • up
  • down
Состояние конфигурации интерфейса, up указывает на наличие и работоспособность, а down указывает на наличие и неработоспособность down
tx_rate
строка
Скорость передачи в битах в секунду (бит/с).
Этот параметр предназначен только для проверки состояния.
Поддерживает условные выражения, см. Условные выражения в модулях сетевых операций
delay
целое число
Значение по умолчанию:
10
Время в секундах ожидания перед проверкой оперативного состояния на удалённом устройстве. Это ожидание применимо для аргументов оперативного состояния, которые являются state со значениями up/down, tx_rate и rx_rate.
description
строка
Описание интерфейса.
duplex
строка
    Варианты:
  • full
  • half
  • auto
Статус соединения интерфейса.
enabled
boolean
    Варианты:
  • нет
  • да ←
Настройка статуса соединения интерфейса.
mtu
целое число
Максимальный размер передаваемого пакета.
name
строка
Имя интерфейса.
neighbors
список / элементы=словарь
Проверка оперативного состояния данного интерфейса name для соседа LLDP.
Доступны следующие подварианты.
host
строка
Хост соседа LLDP для данного интерфейса name.
port
строка
Порт соседа LLDP, к которому подключен данный интерфейс name.
provider
словарь
Устаревшее
Начиная с Ansible 2.5, рекомендуется использовать connection: network_cli или connection: netconf.
Для получения дополнительной информации, см. Руководство по вариантам платформы Junos OS.
Объект словаря, содержащий данные подключения.
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.
rx_rate
строка
Скорость приёма в битах в секунду (бит/с).
Этот параметр предназначен только для проверки состояния.
Поддерживает условные выражения, см. Условные выражения в модулях сетевых операций
speed
строка
Скорость соединения интерфейса.
state
строка
    Варианты:
  • present ←
  • absent
  • up
  • down
Состояние конфигурации интерфейса, up указывает на наличие и работоспособность, а down указывает на наличие и неработоспособность down
tx_rate
строка
Скорость передачи в битах в секунду (бит/с).
Этот параметр предназначен только для проверки состояния.
Поддерживает условные выражения, см. Условные выражения в модулях сетевых операций

Примечания

Примечание

  • Для работы данного модуля требуется включение системной службы 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 interface
  junipernetworks.junos.junos_interface:
    name: ge-0/0/1
    description: test-interface

- name: remove interface
  junipernetworks.junos.junos_interface:
    name: ge-0/0/1
    state: absent

- name: make interface down
  junipernetworks.junos.junos_interface:
    name: ge-0/0/1
    enabled: false

- name: make interface up
  junipernetworks.junos.junos_interface:
    name: ge-0/0/1
    enabled: true

- name: Deactivate interface config
  junipernetworks.junos.junos_interface:
    name: ge-0/0/1
    state: present
    active: false

- name: Activate interface config
  junipernetworks.junos.junos_interface:
    name: ge-0/0/1
    state: present
    active: true

- name: Configure interface speed, mtu, duplex
  junipernetworks.junos.junos_interface:
    name: ge-0/0/1
    state: present
    speed: 1g
    mtu: 256
    duplex: full

- name: Create interface using aggregate
  junipernetworks.junos.junos_interface:
    aggregate:
    - name: ge-0/0/1
      description: test-interface-1
    - name: ge-0/0/2
      description: test-interface-2
    speed: 1g
    duplex: full
    mtu: 512

- name: Delete interface using aggregate
  junipernetworks.junos.junos_interface:
    aggregate:
    - name: ge-0/0/1
    - name: ge-0/0/2
    state: absent

- name: Check intent arguments
  junipernetworks.junos.junos_interface:
    name: '{{ name }}'
    state: up
    tx_rate: ge(0)
    rx_rate: le(0)

- name: Check neighbor intent
  junipernetworks.junos.junos_interface:
    name: xe-0/1/1
    neighbors:
    - port: Ethernet1/0/1
      host: netdev

- name: Config + intent
  junipernetworks.junos.junos_interface:
    name: '{{ name }}'
    enabled: false
    state: down

Возвращаемые значения

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

Ключ Возвращаемое значение Описание
diff.prepared
string
при изменении конфигурации и включённом параметре diff.
Разница в конфигурации до и после применения изменений.

Пример:
[edit interfaces] + ge-0/0/1 { + description test-interface; + }


Статус

  • Этот модуль будет удалён в основной версии после 2022-06-01. [устарел]
  • Дополнительная информация доступна в разделе УСТАРЕВШИЙ.

Авторы

  • Ganesh Nalawade (@ganeshrn)

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API