ce_bgp_neighbor – Управляет настройкой BGP-пиров на коммутаторах HUAWEI CloudEngine.
Новое в версии 2.4.
Описание
- Управляет конфигурациями BGP-пиров на коммутаторах HUAWEI CloudEngine.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| conn_retry_time - | Интервал повторных подключений. Значение — целое число от 1 до 65535. | |
| connect_mode - | Значение может быть Connect-only, Listen-only или Both. | |
| conventional - |
| Если значение true, маршрутизатор обладает всеми расширенными возможностями. Если значение false, маршрутизатор не обладает всеми расширенными возможностями. |
| description - | Описание пира, которое может содержать буквы или цифры. Значение — строка от 1 до 80 символов. | |
| dual_as - |
| Если значение true, EBGP-пир может использовать либо фиктивный номер AS, либо фактический номер AS. Если значение false, EBGP-пир может использовать только фиктивный номер AS. |
| ebgp_max_hop - | Максимальное количество хопов в непрямом EBGP-соединении. Значение — от 1 до 255. | |
| fake_as - | Фиктивный номер AS, указанный для локального пира. Значение — строка от 1 до 11 символов. | |
| hold_time - | Указывает время удержания пира или группы пиров. Значение — 0 или целое число от 3 до 65535. | |
| is_bfd_block - |
| Если значение true, пиры включены для наследования функции BFD от группы пиров. Если значение false, пиры отключены для наследования функции BFD от группы пиров. |
| is_bfd_enable - |
| Если значение true, BFD включен. Если значение false, BFD отключен. |
| is_ignore - |
| Если значение true, сессия с указанным пиром разрывается, и все связанные маршрутные записи очищаются. Если значение false, сессия с указанным пиром сохраняется. |
| is_log_change - |
| Если значение true, BGP включён для регистрации статуса сессии пира и информации об событиях. Если значение false, BGP отключён от регистрации статуса сессии пира и информации об событиях. |
| is_single_hop - |
| Если значение true, система включена для предпочтительного использования режима single-hop для настройки сессии BFD между IBGP-пирами. Если значение false, система отключена от предпочтительного использования режима single-hop для настройки сессии BFD между IBGP-пирами. |
| keep_alive_time - | Указывает время keepalive пира или группы пиров. Значение — целое число от 0 до 21845. Значение по умолчанию — 60. | |
| key_chain_name - | Указывает имя цепочки ключей для аутентификации при установлении TCP-соединения между BGP-пирами. Значение — строка от 1 до 47 символов, регистронезависимая. | |
| local_if_name - | Имя интерфейса источника, отправляющего пакеты BGP. Значение — строка от 1 до 63 символов. | |
| min_hold_time - | Указывает минимальное время удержания пира или группы пиров. | |
| mpls_local_ifnet_disable - |
| Если значение true, пир создаёт MPLS Local IFNET disable. Если значение false, пир создаёт MPLS Local IFNET enable. |
| multiplier - | Указывает множитель обнаружения. Значение по умолчанию — 3. Значение — целое число от 3 до 50. | |
| peer_addr - / обязательно | Адрес подключения пира, который может быть IPv4 или IPv6 адресом. | |
| prepend_fake_as - |
| Добавляет фиктивный номер AS к полученным пакетам Update. |
| prepend_global_as - |
| Добавляет глобальный номер AS к пакетам Update, которые будут рекламироваться. |
| pswd_cipher_text - | Строка символов в пароле, идентифицирует содержимое пароля, пробелы не поддерживаются. Значение — строка от 1 до 255 символов. | |
| pswd_type - |
| Разрешает BGP-пирам устанавливать TCP-соединение и выполнять аутентификацию по Message Digest 5 (MD5) для BGP-сообщений. |
| remote_as - / обязательно | Номер AS пира. Значение — строка от 1 до 11 символов. | |
| route_refresh - |
| Если значение true, BGP разрешено рекламировать пакеты REFRESH. Если значение false, функция обновления маршрутов включена. |
| rx_interval - | Указывает минимальный интервал, в котором принимаются пакеты BFD. Значение — целое число от 50 до 1000, в миллисекундах. | |
| state - |
| Указывает желаемое состояние ресурса. |
| 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-инстанса. |
Примеры
- 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"
ce_bgp_neighbor:
state: present
vrf_name: js
peer_addr: 192.168.10.10
remote_as: 500
provider: "{{ cli }}"
- name: "Config bgp route id"
ce_bgp_neighbor:
state: absent
vrf_name: js
peer_addr: 192.168.10.10
provider: "{{ cli }}"
Возвращаемые значения
Общие значения возвращаемых данных документированы здесь, ниже приведены поля, уникальные для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| changed boolean | всегда | проверка на изменение на устройстве Пример: True |
| end_state словарь | всегда | пара k/v параметров aaa после выполнения модуля Пример: {'bgp peer': [['192.168.10.10', '500']]} |
| existing словарь | всегда | пара k/v существующего сервера aaa Пример: {'bgp peer': []} |
| proposed словарь | всегда | пара k/v параметров, переданных в модуль Пример: {'peer_addr': '192.168.10.10', 'remote_as': '500', 'state': 'present', 'vrf_name': 'js'} |
| updates список | всегда | команда, отправленная на устройство Пример: ['peer 192.168.10.10 as-number 500'] |
Статус
- Данный модуль не гарантирует обратную совместимость. [превью]
- Данный модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- wangdezhuang (@CloudEngine-Ansible)
Подсказка
Если вы обнаружите какие-либо проблемы в данной документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/ce_bgp_neighbor_module.html