Spec-Zone.ru › Ansible

Модуль netapp.ontap.na_ontap_bgp_peer_group – Модуль NetApp ONTAP для создания, изменения или удаления группы BGP-пейров.

Примечание

Этот модуль входит в коллекцию netapp.ontap (версия 22.12.0).

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

Для установки используйте: ansible-galaxy collection install netapp.ontap. Для использования этого модуля требуются дополнительные требования, см. Требования для получения подробной информации.

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

Новая функция в netapp.ontap 22.0.0

  • Описание
  • Требования
  • Параметры
  • Примечания
  • Примеры

Описание

  • Создание, изменение или удаление группы BGP-пейров.

Требования

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

  • Ansible 2.9 или более поздние версии - рекомендуется 2.12 или более поздние.
  • Python3 - рекомендуется 3.9 или более поздние.
  • При использовании ZAPI, netapp-lib 2018.11.13 или более поздние (установить с помощью «pip install netapp-lib»), сильно рекомендуется netapp-lib 2020.3.12, так как он обеспечивает лучшие сообщения об ошибках при подключении.
  • Физическая или виртуальная кластеризованная система Data ONTAP, модули поддерживают Data ONTAP 9.1 и выше, поддержка REST требует ONTAP 9.6 или более поздней версии.
END_OF_DOCUMENT_MARKER

Параметры

Параметр

Комментарии

cert_filepath

строка

добавлен в netapp.ontap 20.6.0

путь к файлу SSL-сертификата клиента (.pem).

не поддерживается с python 2.6.

feature_flags

словарь

добавлен в netapp.ontap 20.5.0

Включить или выключить новую функцию.

Это можно использовать для включения экспериментальной функции или выключения новой функции, которая нарушает обратную совместимость.

Поддерживаемые ключи и значения могут быть изменены без предварительного уведомления. Неизвестные ключи игнорируются.

force_ontap_version

строка

добавлен в netapp.ontap 21.23.0

Переопределить версию кластера ONTAP при использовании REST.

Поведение не определено, если версия не соответствует целевому кластеру.

Это предлагается как обходной путь, когда версия кластера не может быть прочитана из-за проблем с разрешениями. См. https://github.com/ansible-collections/netapp.ontap/wiki/Known-issues.

Это должно быть в формате 9.10 или 9.10.1, где каждый элемент — целое число.

Когда use_rest установлено в auto, это может принудительно переключиться на ZAPI в зависимости от версии и возможностей платформы.

Игнорируется при использовании ZAPI.

from_name

строка

Имя существующей группы BGP-пиров, подлежащей переименованию в name.

hostname

строка / обязательно

Имя хоста или IP-адрес экземпляра ONTAP.

http_port

целое число

Переопределить стандартный порт (80 или 443) на этот порт

https

булево

Включить и выключить https.

Игнорируется при использовании REST, так как поддерживается только https.

Игнорируется при использовании аутентификации с сертификатом SSL, так как она требует SSL.

Варианты:

  • false ← (по умолчанию)
  • true

ipspace

строка

Имя IPSpace, которое нельзя изменить после создания.

key_filepath

строка

добавлен в netapp.ontap 20.6.0

путь к файлу закрытого ключа SSL клиента.

local

словарь

Информация, описывающая локальный интерфейс, используемый для установления соединения с маршрутизатором с использованием BGP.

При создании группы BGP-пиров используется существующий интерфейс BGP, указав интерфейс, или создается новый интерфейс, указав порт и IP-адрес.

Нельзя изменить после создания.

interface

словарь

Существующий интерфейс BGP.

Если интерфейс не найден, модуль попытается создать интерфейс BGP, используя local.ip и local.port.

name

строка

Имя интерфейса BGP.

ip

словарь

Информация об IP, необходимая для создания нового интерфейса.

address

строка

IPv4 или IPv6-адрес, например 10.10.10.7.

netmask

строка

Вводится как длина маски сети (16) или маска IPv4 (255.255.0.0).

Для IPv6 значение по умолчанию — 64 с допустимым диапазоном от 1 до 127.

port

словарь

Информация о порте и узле, необходимая для создания нового интерфейса.

name

строка

Имя порта.

node

словарь

Имя узла, на котором расположен порт.

name

строка

Имя узла.

name

строка / обязательно

Имя группы BGP-пиров.

ontapi

целое число

Используемая версия API ontap

password

псевдонимы: pass

строка

Пароль для указанного пользователя.

peer

словарь

Информация, описывающая маршрутизатор для установления соединения.

address

string

Адрес маршрутизатора-партнёра.

asn

integer

Номер автономной системы партнёра.

Не может быть изменён после создания.

state

string

Создать или удалить группу партнёров BGP.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

use_peer_as_next_hop

boolean

добавлено в netapp.ontap 22.12.0

Указывает, использует ли группа партнёров адрес партнёра в качестве маршрута следующего перехода.

Это поле требует версию ONTAP 9.9 или выше.

Варианты:

  • false
  • true

use_rest

string

Использовать REST или ZAPI.

always – всегда будет использовать REST API, если модуль поддерживает REST. Выводится предупреждение, если модуль не поддерживает REST. Возникает ошибка, если параметр модуля не поддерживается в REST.

never – всегда будет использовать ZAPI, если модуль поддерживает ZAPI. Может быть выдана ошибка, если параметр REST не поддерживается в ZAPI.

auto – попробует использовать REST API, если модуль поддерживает REST и параметры модуля поддерживаются. В противном случае переходит на ZAPI.

По умолчанию: "auto"

username

aliases: user

string

Это может быть учетная запись уровня кластера или SVM, в зависимости от того, требуется ли API уровня кластера или уровня SVM.

Дополнительную информацию можно найти в документации https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/.

Поддерживаются два метода аутентификации

  1. аутентификация по протоколу Basic, использующая имя пользователя и пароль,
  2. аутентификация по сертификату SSL, использующая файл сертификата клиента ssl и, необязательно, файл закрытого ключа.

Для использования сертификата он должен быть установлен в кластере ONTAP, а аутентификация по сертификатам должна быть включена.

validate_certs

boolean

Если установлено значение no, сертификаты SSL не будут проверены.

Это следует установить только в False на сайтах с собственными сертификатами.

Варианты:

  • false
  • true ← (по умолчанию)

Примечания

Примечание

  • Модули с префиксом na_ontap разработаны для поддержки платформы хранения ONTAP.
  • https включён по умолчанию и рекомендуется. Для включения http в кластере необходимо выполнить следующие команды: ‘set -privilege advanced;’ ‘system services web modify -http-enabled true;’

Примеры

- name: Create BGP peer group with existing bgp interface bgp_lif.
  netapp.ontap.na_ontap_bgp_peer_group:
    name: peer_group
    ipspace: Default
    local:
      interface:
        name: bgp_lif
    peer:
      address: 10.10.10.19
      asn: 65501
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"

- name: Create new BGP interface new_bgp_lif and BGP peer group peer_group_1.
  netapp.ontap.na_ontap_bgp_peer_group:
    name: peer_group_1
    ipspace: Default
    local:
      interface:
        name: new_bgp_lif
      ip:
        address: 10.10.10.20
        netmask: 24
      port:
        name: e0a
        node:
          name: ontap98-01
    peer:
      address: 10.10.10.20
      asn: 65500
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"

  # this will create bgp interface with random name.
- name: Create BGP interface without interface name and BGP peer group peer_group_2.
  netapp.ontap.na_ontap_bgp_peer_group:
    name: peer_group_2
    ipspace: Default
    local:
      ip:
        address: 10.10.10.22
        netmask: 24
      port:
        name: e0a
        node:
          name: ontap98-01
    peer:
      address: 10.10.10.22
      asn: 65512
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"

- name: Modify peer address.
  netapp.ontap.na_ontap_bgp_peer_group:
    name: peer_group_2
    ipspace: Default
    peer:
      address: 10.10.55.22
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"

- name: Rename BGP peer group name and modify peer address.
  netapp.ontap.na_ontap_bgp_peer_group:
    from_name: peer_group_2
    name: new_peer_group
    ipspace: Default
    peer:
      address: 10.10.55.40
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"

- name: Delete BGP peer group.
  netapp.ontap.na_ontap_bgp_peer_group:
    name: new_peer_group
    ipspace: Default
    state: absent
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"

Авторы

  • Команда NetApp Ansible (@carchi8py)

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

  • Трекер задач
  • Главная страница
  • Репозиторий (источники)

© 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/netapp/ontap/na_ontap_bgp_peer_group_module.html

Spec-Zone.ru

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