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-соединение и выполнять аутентификацию 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. |
Примечания
Примечание
- Для работы данного модуля требуется, чтобы на управляемом удалённом устройстве была включена служба 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"
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 словарь | всегда | пара ключ/значение параметров 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'] |
Статус
- Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- 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.8/modules/ce_bgp_neighbor_module.html