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

Примечание

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

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

Для использования в playbook, укажите: community.network.ce_bgp_neighbor.

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

Описание

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
conn_retry_time строка		Интервал повторных подключений. Значение — целое число от 1 до 65535.
connect_mode строка		Значение может быть Connect-only, Listen-only или Both.
conventional строка	Варианты: no_use ← true false	Если значение true, маршрутизатор обладает всеми расширенными возможностями. Если false, маршрутизатор не имеет всех расширенных возможностей.
description строка		Описание пира, может содержать буквы или цифры. Значение — строка от 1 до 80 символов.
dual_as строка	Варианты: no_use ← true false	Если значение true, EBGP-пир может использовать как фиктивный, так и фактический номер AS. Если false, EBGP-пир может использовать только фиктивный номер AS.
ebgp_max_hop строка		Максимальное количество хопов в непрямом EBGP-соединении. Значение — целое число от 1 до 255.
fake_as строка		Фиктивный номер AS, указанный для локального пира. Значение — строка от 1 до 11 символов.
hold_time строка		Укажите время удержания пира или группы пиров. Значение — 0 или целое число от 3 до 65535.
is_bfd_block строка	Варианты: no_use ← true false	Если значение true, пиры могут унаследовать функцию BFD от группы пиров. Если false, пиры не могут унаследовать функцию BFD от группы пиров.
is_bfd_enable строка	Варианты: no_use ← true false	Если значение true, BFD включён. Если false, BFD отключён.
is_ignore строка	Варианты: no_use ← true false	Если значение true, сессия с указанным пиром прерывается, и все связанные маршрутные записи очищаются. Если false, сессия с указанным пиром сохраняется.
is_log_change строка	Варианты: no_use ← true false	Если значение true, BGP записывает состояние сессии пира и информацию об событиях. Если false, BGP не записывает состояние сессии пира и информацию об событиях.
is_single_hop строка	Варианты: no_use ← true false	Если значение true, система предпочитает использовать одноходовой режим для настройки сессии BFD между IBGP-пирами. Если false, система не предпочитает использовать одноходовой режим для настройки сессии BFD между IBGP-пирами.
keep_alive_time строка		Укажите время Keepalive пира или группы пиров. Значение — целое число от 0 до 21845. Значение по умолчанию — 60.
key_chain_name строка		Укажите имя цепочки ключей (Keychain), используемой при установлении TCP-соединения между BGP-пирами. Значение — строка от 1 до 47 символов, регистр не учитывается.
local_if_name строка		Имя интерфейса источника, отправляющего пакеты BGP. Значение — строка от 1 до 63 символов.
min_hold_time строка		Укажите минимальное время удержания пира или группы пиров.
mpls_local_ifnet_disable строка	Варианты: no_use ← true false	Если значение true, пир создает MPLS Local IFNET disable. Если false, пир создает MPLS Local IFNET enable.
multiplier строка		Укажите множитель обнаружения. Значение по умолчанию — 3. Значение — целое число от 3 до 50.
peer_addr строка / обязательно		Адрес соединения пира, может быть IPv4 или IPv6 адресом.
prepend_fake_as строка	Варианты: no_use ← true false	Добавляет фиктивный номер AS в полученные пакеты Update.
prepend_global_as строка	Варианты: no_use ← true false	Добавляет глобальный номер AS в пакеты Update, которые должны быть распространены.
pswd_cipher_text строка		Строка символов в пароле идентифицирует содержимое пароля, пробелы не поддерживаются. Значение — строка от 1 до 255 символов.
pswd_type строка	Варианты: null cipher simple	Включает возможность для BGP-пиров установить TCP-соединение и выполнить аутентификацию с помощью Message Digest 5 (MD5) для сообщений BGP.
remote_as строка / обязательно		Номер AS пира. Значение — строка от 1 до 11 символов.
route_refresh строка	Варианты: no_use ← true false	Если значение true, BGP разрешено рекламировать пакеты REFRESH. Если false, функция обновления маршрутов включена.
rx_interval строка		Укажите минимальный интервал получения пакетов BFD. Значение — целое число от 50 до 1000, в миллисекундах.
state строка	Варианты: present ← absent	Укажите желаемое состояние ресурса.
tcp_MSS строка		Максимальное значение TCP MSS, используемое для установления TCP-соединения для пира. Значение — целое число от 176 до 4096.
tx_interval строка		Укажите минимальный интервал отправки пакетов BFD. Значение — целое число от 50 до 1000, в миллисекундах.
valid_ttl_hops строка		Включить GTSM для пира или группы пиров. Параметр valid-TTL-Value используется для указания количества хопов TTL, которые должны быть обнаружены. Значение — целое число от 1 до 255.
vrf_name строка / обязательно		Имя экземпляра BGP. Имя — строка символов, регистрозависимая. Экземпляр BGP может быть использован только после создания соответствующего экземпляра VPN.

Примечания

Примечание

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

Примеры

- name: CloudEngine BGP neighbor 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"
    community.network.ce_bgp_neighbor:
      state: present
      vrf_name: js
      peer_addr: 192.168.10.10
      remote_as: 500
      provider: "{{ cli }}"

  - name: "Config bgp route id"
    community.network.ce_bgp_neighbor:
      state: absent
      vrf_name: js
      peer_addr: 192.168.10.10
      provider: "{{ cli }}"

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

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

Ключ	Возвращаемое значение	Описание
changed boolean	всегда	проверка, было ли внесено изменение на устройстве Пример: True
end_state словарь	всегда	пара ключ/значение параметров aaa после выполнения модуля Пример: {'bgp peer': [['192.168.10.10', '500']]}
existing словарь	всегда	пара ключ/значение существующего сервера aaa Пример: {'bgp peer': []}
proposed словарь	всегда	пара ключ/значение параметров, переданных в модуль Пример: {'peer_addr': '192.168.10.10', 'remote_as': '500', 'state': 'present', 'vrf_name': 'js'}
updates список / элементы=строка	всегда	команда, отправленная на устройство Пример: ['peer 192.168.10.10 as-number 500']

Авторы

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