Spec-Zone.ru › Ansible 2.10

community.network.ce_bgp_neighbor_af – Управляет конфигурацией семейства адресов BGP-соседа на коммутаторах HUAWEI CloudEngine.

Примечание

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

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

Для использования в плейбуке укажите: community.network.ce_bgp_neighbor_af.

  • Краткое описание
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Краткое описание

  • Управляет конфигурацией семейства адресов BGP-соседа на коммутаторах HUAWEI CloudEngine.

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
add_path_mode
строка
    Варианты:
  • null
  • receive
  • send
  • both
null, Нулевое значение. receive, Поддержка получения маршрутов Add-Path. send, Поддержка отправки маршрутов Add-Path. both, Поддержка получения и отправки маршрутов Add-Path.
adv_add_path_num
строка
Количество рекламируемых маршрутов addPath. Значение — целое число от 2 до 64.
advertise_arp
строка
    Варианты:
  • no_use ←
  • true
  • false
Если значение true, рекламируемые маршруты ARP различаются. Если значение false, рекламируемые маршруты ARP не различаются.
advertise_community
строка
    Варианты:
  • no_use ←
  • true
  • false
Если значение true, атрибут сообщества рекламируется соседям. Если значение false, атрибут сообщества не рекламируется соседям.
advertise_ext_community
строка
    Варианты:
  • no_use ←
  • true
  • false
Если значение true, расширенный атрибут сообщества рекламируется соседям. Если значение false, расширенный атрибут сообщества не рекламируется соседям.
advertise_irb
строка
    Варианты:
  • no_use ←
  • true
  • false
Если значение true, рекламируемые маршруты IRB различаются. Если значение false, рекламируемые маршруты IRB не различаются.
advertise_remote_nexthop
строка
    Варианты:
  • no_use ←
  • true
  • false
Если значение true, атрибут удаленного следующего узла рекламируется соседям. Если значение false, атрибут удаленного следующего узла не рекламируется соседям.
af_type
строка / обязательно
    Варианты:
  • ipv4uni
  • ipv4multi
  • ipv4vpn
  • ipv6uni
  • ipv6vpn
  • evpn
Тип семейства адресов BGP-инстанса.
allow_as_loop_enable
строка
    Варианты:
  • no_use ←
  • true
  • false
Если значение true, допускаются повторяющиеся локальные номера AS. Если значение false, повторяющиеся локальные номера AS запрещены.
allow_as_loop_limit
строка
Устанавливает максимальное количество повторяющихся локальных номеров AS. Значение — целое число от 1 до 10.
default_rt_adv_enable
строка
    Варианты:
  • no_use ←
  • true
  • false
Если значение true, функция рекламы маршрутов по умолчанию включена. Если значение false, функция рекламы маршрутов по умолчанию выключена.
default_rt_adv_policy
строка
Указывает имя используемой политики. Значение — строка от 1 до 40 символов.
default_rt_match_mode
строка
    Варианты:
  • null
  • matchall
  • matchany
null, Нулевое значение. matchall, Рекламировать маршрут по умолчанию, если выполнены все условия соответствия. matchany, Рекламировать маршрут по умолчанию, если выполнено любое условие соответствия.
discard_ext_community
строка
    Варианты:
  • no_use ←
  • true
  • false
Если значение true, атрибут расширенного сообщества в информации о маршруте соседа игнорируется. Если значение false, атрибут расширенного сообщества в информации о маршруте соседа не игнорируется.
export_acl_name_or_num
строка
Применение политики фильтрации на основе IPv4 ACL для маршрутов, которые будут рекламироваться указанному соседу. Значение — строка от 1 до 32 символов.
export_as_path_filter
строка
Применение политики фильтрации на основе AS_Path для маршрутов, которые будут рекламироваться указанному соседу. Значение — целое число от 1 до 256.
export_as_path_name_or_num
строка
Применение политики фильтрации на основе списка AS-путей для маршрутизации указанного соседа.
export_pref_filt_name
строка
Указывает политику фильтрации IPv4, применяемую к маршрутам, рекламируемым определённому соседу. Значение — строка от 1 до 169 символов.
export_rt_policy_name
строка
Указывает политику фильтрации, применяемую к маршрутам, которые будут рекламироваться соседу. Значение — строка от 1 до 40 символов.
import_acl_name_or_num
строка
Применение политики фильтрации на основе IPv4 ACL для маршрутов, полученных от указанного соседа. Значение — строка от 1 до 32 символов.
import_as_path_filter
строка
Применение политики фильтрации на основе AS_Path для маршрутов, полученных от указанного соседа. Значение — целое число от 1 до 256.
import_as_path_name_or_num
строка
Стратегия маршрутизации, основанная на списке AS-путей для маршрутов, полученных от указанного соседа.
import_pref_filt_name
строка
Указывает политику фильтрации IPv4, применяемую к маршрутам, полученным от определённого соседа. Значение — строка от 1 до 169 символов.
import_rt_policy_name
строка
Указывает политику фильтрации, применяемую к маршрутам, полученным от соседа. Значение — строка от 1 до 40 символов.
ipprefix_orf_enable
строка
    Варианты:
  • no_use ←
  • true
  • false
Если значение true, функция фильтрации исходящих маршрутов (ORF) на основе префиксов адресов включена для соседей. Если значение false, функция фильтрации исходящих маршрутов (ORF) на основе префиксов адресов выключена для соседей.
is_nonstd_ipprefix_mod
строка
    Варианты:
  • no_use ←
  • true
  • false
Если значение true, во время согласования возможностей используются нестандартные коды. Если значение false, во время согласования возможностей используются стандартные, определённые RFC, коды ORF.
keep_all_routes
строка
    Варианты:
  • no_use ←
  • true
  • false
Если значение true, система сохраняет все сообщения об обновлении маршрутов, полученные от всех соседей (групп) после настройки подключения BGP. Если значение false, система сохраняет только сообщения об обновлениях BGP, полученные от соседей и прошедшие конфигурируемую политику импорта.
nexthop_configure
строка
    Варианты:
  • null
  • local
  • invariable
null, Следующий узел не меняется. local, Следующий узел меняется на локальный IP-адрес. invariable, Предотвращение изменения устройства следующего узла каждого импортированного IGP-маршрута при рекламе его BGP-соседям.
orf_mode
строка
    Варианты:
  • null
  • receive
  • send
  • both
Режим ORF. null, Значение по умолчанию. receive, ORF для входящих пакетов. send, ORF для исходящих пакетов. both, ORF для входящих и исходящих пакетов.
orftype
строка
Тип ORF. Значение — целое число от 0 до 65535.
origin_as_valid
строка
    Варианты:
  • no_use ←
  • true
  • false
Если значение true, результаты применения маршрута объявления. Если значение false, результаты применения маршрутизации не уведомляются.
preferred_value
строка
Назначение предпочтительного значения для маршрутов, полученных от указанного соседа. Значение — целое число от 0 до 65535.
public_as_only
строка
    Варианты:
  • no_use ←
  • true
  • false
Если значение true, отправляемые сообщения BGP содержат только общедоступный номер AS, но не содержат частные номера AS. Если значение false, отправляемые сообщения BGP могут содержать частные номера AS.
public_as_only_force
строка
    Варианты:
  • no_use ←
  • true
  • false
Если значение true, отправляемые сообщения BGP содержат только общедоступный номер AS, но не содержат частные номера AS. Если значение false, отправляемые сообщения BGP могут содержать частные номера AS.
public_as_only_limited
строка
    Варианты:
  • no_use ←
  • true
  • false
Ограниченное использование номера общедоступного AS.
public_as_only_replace
строка
    Варианты:
  • no_use ←
  • true
  • false
Частный AS заменяется номером общедоступного AS.
public_as_only_skip_peer_as
строка
    Варианты:
  • no_use ←
  • true
  • false
Пропуск номера AS соседа при использовании только общедоступного AS.
redirect_ip
string
    Выбор:
  • no_use ←
  • true
  • false
Переадресация IP.
redirect_ip_validation
string
    Выбор:
  • no_use ←
  • true
  • false
Валидация переадресации IP.

Псевдонимы: redirect_ip_vaildation
reflect_client
string
    Выбор:
  • no_use ←
  • true
  • false
Если значение равно true, локальное устройство функционирует как отражатель маршрутов, а peer — как клиент отражателя маршрутов. Если значение равно false, функции отражателя маршрутов и клиента не настроены.
remote_address
string / required
Адрес подключения peer IPv4 или IPv6.
route_limit
string
Настройка максимального числа маршрутов, которые могут быть приняты от peer. Значение — целое число в диапазоне от 1 до 4294967295.
route_limit_idle_timeout
string
Укажите значение таймера idle-timeout для автоматического повторного установления соединений после их разрыва, когда количество маршрутов превышает установленный порог. Значение — целое число в диапазоне от 1 до 1200.
route_limit_percent
string
Укажите процент маршрутов, когда маршрутизатор начинает генерировать сигнал тревоги. Значение — целое число в диапазоне от 1 до 100.
route_limit_type
string
    Выбор:
  • noparameter
  • alertOnly
  • idleForever
  • idleTimeout
Noparameter, После того, как количество полученных маршрутов превысит порог, и таймер тайм-аута истечет, никакие действия не выполняются. AlertOnly, Генерируется сигнал тревоги, и дополнительные маршруты не будут приниматься, если было получено максимальное количество разрешенных маршрутов. IdleForever, Прерванное соединение не восстанавливается автоматически, если максимальное количество разрешенных маршрутов было получено. IdleTimeout, После того, как количество полученных маршрутов превысит порог, и таймер тайм-аута истечет, прерванное соединение автоматически восстанавливается.
rt_updt_interval
string
Укажите минимальный интервал, с которым отправляются пакеты Update. Значение — целое число в секундах. Значение — целое число в диапазоне от 0 до 600.
soostring
string
Настройка атрибута расширенного сообщества Site-of-Origin (SoO). Значение — строка длиной от 3 до 21 символа.
substitute_as_enable
string
    Выбор:
  • no_use ←
  • true
  • false
Если значение равно true, функция замены номера AS указанного peer в атрибуте AS-Path на локальный номер AS включена. Если значение равно false, функция замены номера AS указанного peer в атрибуте AS-Path на локальный номер AS отключена.
update_pkt_standard_compatible
string
    Выбор:
  • no_use ←
  • true
  • false
Если значение равно true, при получении и обновлении сообщения VPNv4 multicast-соседом, сообщение не имеет метки. Если значение равно false, при получении и обновлении сообщения VPNv4 multicast-соседом, сообщение имеет метку.
vpls_ad_disable
string
    Выбор:
  • no_use ←
  • true
  • false
Если значение равно true, включить vpls-ad. Если значение равно false, отключить vpls-ad.
vpls_enable
string
    Выбор:
  • no_use ←
  • true
  • false
Если значение равно true, включить vpls. Если значение равно false, отключить vpls.
vrf_name
string / required
Имя экземпляра BGP. Имя — чувствительная к регистру строка символов. Экземпляр BGP может использоваться только после создания соответствующего экземпляра VPN.

Примечания

Примечание

  • Для данного модуля требуется, чтобы служба netconf системы была включена на удалённом управляемом устройстве.
  • Рекомендуемое соединение — netconf.
  • Этот модуль также работает с local подключениями для устаревших playbooks.

Примеры

- name: CloudEngine BGP neighbor address family test
  hosts: cloudengine
  connection: local
  gather_facts: no
  vars:
    cli:
      host: "{{ inventory_hostname }}"
      port: "{{ ansible_ssh_port }}"
      username: "{{ username }}"
      password: "{{ password }}"
      transport: cli

  tasks:

  - name: "Config BGP peer Address_Family"
    community.network.ce_bgp_neighbor_af:
      state: present
      vrf_name: js
      af_type: ipv4uni
      remote_address: 192.168.10.10
      nexthop_configure: local
      provider: "{{ cli }}"

  - name: "Undo BGP peer Address_Family"
    community.network.ce_bgp_neighbor_af:
      state: absent
      vrf_name: js
      af_type: ipv4uni
      remote_address: 192.168.10.10
      nexthop_configure: local
      provider: "{{ cli }}"

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

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

Ключ Возвращаемое Описание
changed
boolean
всегда
проверка, были ли внесены изменения на устройстве

Пример:
True
end_state
словарь
всегда
k/v пары параметров aaa после выполнения модуля

Пример:
{'bgp neighbor af': {'af_type': 'ipv4uni', 'remote_address': '192.168.10.10', 'vrf_name': 'js'}, 'bgp neighbor af other': {'af_type': 'ipv4uni', 'nexthop_configure': 'local', 'vrf_name': 'js'}}
existing
словарь
всегда
k/v пары существующего aaa сервера

Пример:
{'bgp neighbor af': {'af_type': 'ipv4uni', 'remote_address': '192.168.10.10', 'vrf_name': 'js'}, 'bgp neighbor af other': {'af_type': 'ipv4uni', 'nexthop_configure': 'null', 'vrf_name': 'js'}}
proposed
словарь
всегда
k/v пары параметров, переданных в модуль

Пример:
{'af_type': 'ipv4uni', 'nexthop_configure': 'local', 'remote_address': '192.168.10.10', 'state': 'present', 'vrf_name': 'js'}
updates
список / элементы=строка
всегда
команда, отправленная на устройство

Пример:
['peer 192.168.10.10 next-hop-local']


Авторы

  • wangdezhuang (@QijunPan)

© 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/community/network/ce_bgp_neighbor_af_module.html

Spec-Zone.ru

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