Отключение соседей по протоколу пограничного шлюза

Статья
05/04/2024

В этой статье приведены примеры того, как пользователь может реализовать команды записи чтения (RW) для отключения соседей по протоколу BGP.

Завершение работы определенного однорангового узла на уровне виртуальной маршрутизации и пересылки (VRF)

Ниже показан моментальный снимок устройства Network Fabric перед внесением изменений в конфигурацию с помощью API RW:

sh ip bgp  summary vrf gfab1-isd

BGP summary information for VRF gfab1-isd
Router identifier 10.XXX.14.34, local AS number 650XX
Neighbor Status Codes: m - Under maintenance
  Neighbor            V AS           MsgRcvd   MsgSent  InQ OutQ  Up/Down State   PfxRcd PfxAcc
  10.XXX.13.15        4 650XX         129458    168981    0    0 00:06:50 Estab   189    189
  **10.XXX.30.18        4 650XX          42220     42522    0    0 00:00:44 Estab   154    154**
  10.XXX.157.8        4 645XX          69211     74503    0    0   21d20h Estab   4      4
  fda0:XXXX:XXXX:d::f 4 650XX         132192    171982    0    0   28d18h Estab   0      0

Выполните следующую команду, чтобы отключить сосед BGP:

az networkfabric device run-rw --resource-name <ResourceName> --resource-group <ResourceGroupName> --rw-command "router bgp 65055\n vrf gfab1-isd\n neighbor 10.100.30.18 shutdown"

Ожидаемые выходные данные:

{}

sh ip bgp summary vrf gfab1-isd

BGP summary information for VRF gfab1-isd
Router identifier 10.XXX.14.34, local AS number 650XX
Neighbor Status Codes: m - Under maintenance
  Neighbor            V AS           MsgRcvd   MsgSent  InQ OutQ  Up/Down State   PfxRcd PfxAcc
  10.XXX.13.15        4 650XX         129456    168975    0    0 00:04:31 Estab   189    189
  **10.XXX.30.18        4 650XX          42210     42505    0    0 00:01:50 Idle(Admin)**
  10.XXX.157.8        4 645XX          69206     74494    0    0   21d20h Estab   4      4
  fda0:d59c:df06:d::f 4 65055         132189    171976    0    0   28d18h Estab   0      0

Apr  XX XXX:54 AR Bgp: %BGP-3-NOTIFICATION: sent to neighbor 10.XXX.30.18 (VRF gfab1-isd AS 650XX) 6/2 (Cease/administrative shutdown <Hard Reset>) reason:
Apr  XX XXX:54 AR Bgp: %BGP-3-NOTIFICATION: sent to neighbor 10.XXX.30.18 (VRF gfab1-isd AS 650XX) 6/5 (Cease/connection rejected) 0 bytes

Команда с --no-wait --debug

az networkfabric device run-rw --resource-name <ResourceName> --resource-group <ResourceGroupName> --rw-command "router bgp 65055\n vrf gfab1-isd\n neighbor 10.100.30.18 shutdown" --no-wait –debug

Параметр	Описание
`az networkfabric device run-rw`	Команда Azure CLI для выполнения операции чтения и записи на сетевом устройстве в Azure Network Fabric.
`--resource-name`	Указывает имя ресурса (сетевого устройства), на котором будет выполняться операция RW.
`--resource-group`	Указывает имя группы ресурсов, содержащей сетевое устройство.
`--rw-command "router bgp 65055\n vrf gfab1-isd\n neighbor 10.100.30.18 shutdown"`	Указывает команды RW, выполняемые на сетевом устройстве. Эти команды настраивают параметры BGP и завершают работу определенного соседа.
`--no-wait`	Указывает, что команда должна выполняться асинхронно, не ожидая завершения операции.
`--debug`	Пометка включения режима отладки, предоставляя дополнительные сведения о выполнении команды для устранения неполадок.

Ожидаемые выходные данные:

cli.knack.cli: Command arguments: \['networkfabric', 'device', 'run-rw', '--resource-name', <ResourceName>, '--resource-group', <ResourceGroupName>, '--rw-command', 'router bgp 65055\\\\n vrf gfab1-isd\\\\n neighbor 10.100.30.18 shutdown', '--debug'\]
cli.knack.cli: \_\_init\_\_ debug log:
Enable color in terminal.
cli.knack.cli: Event: Cli.PreExecute \[\]
cli.knack.cli: Event: CommandParser.OnGlobalArgumentsCreate \[<function CLILogging.on\_global\_arguments at 0x01F1A610>;, <function OutputProducer.on\_global\_arguments at 0x0211B850>, <function CLIQuery.on\_global\_arguments at 0x021314A8>\]
cli.azure.cli.core.sdk.policies: 'Azure-AsyncOperation': 'https://eastus.management.azure.com/subscriptionsXXXXXXXXXXXXXXXXXX/providers/Microsoft.ManagedNetworkFabric/locations/EASTUS/operationStatuses/e239299a-8c71-426e-8460-58d4c0b470e2\*850DA565ABE0036AB?api-version=2022-01-15-privatepreview&t=638479088323069839&c=

Вы можете программно проверить состояние операции, выполнив следующую команду:

az rest -m get -u "<Azure-AsyncOperation-endpoint url>"

Пример URL-адреса конечной точки Azure-AsyncOperation, извлеченных из усеченных выходных данных.

<https://eastus.management.azure.com/subscriptions/xxxxxxxxxxx/providers/Microsoft.ManagedNetworkFabric/locations/EASTUS/operationStatuses/xxxxxxxxxxx?api-version=20XX-0X-xx-xx>

Состояние указывает, успешно ли выполнен или завершился сбой API.

Ожидаемые выходные данные:

https://eastus.management.azure.com/subscriptions/XXXXXXXX/providers/Microsoft.ManagedNetworkFabric/locations/EASTUS/operationStatuses/e239299a-8c71-426e-8460-58d4c0b470e2AB?api-version=2022-01-15-privatepreview

{

"endTime": "2024-XX-XXT10:14:13.2334379Z",
"id": "/subscriptions/XXXXXXXXXXXXXX/providers/Microsoft.ManagedNetworkFabric/locations/EASTUS/operationStatuses/e239299a-8c71-426e-DA565ABE0036AB",
"name": "e239299a-8c71-426e-8460-58d4c0b470e2\*E98FEC8C2D6479A6C0A450CE6E20DA4C9DDBF225A07F7F4850DA565ABE0036AB",
"properties": null,
"resourceId": "/subscriptions/XXXXXXXXXXXX/resourceGroups/ResourceGroup/providers/Microsoft.ManagedNetworkFabric/networkDevices/ResourceName",
"startTime": "2024-XX-XXT10:13:52.0438351Z",
"status": "Succeeded"
}

Завершение работы одноранговой группы на уровне VRF

В этом примере показано, как конфигурация RW завершает работу одноранговой группы на уровне VRF.

sh ip bgp  summary vrf gfab1-isd

BGP summary information for VRF gfab1-isd
Router identifier 10.XXX.14.34, local AS number 650XX
Neighbor Status Codes: m - Under maintenance
  Neighbor            V AS           MsgRcvd   MsgSent  InQ OutQ  Up/Down State   PfxRcd PfxAcc
  10.XXX.13.15        4 650XX         129458    168981    0    0 00:06:50 Estab   189    189
  10.XXX.30.18        4 650XX          42220     42522    0    0 00:00:44 Estab   154    154
**  10.XXX.157.8        4 645XX          69211     74503    0    0   21d20h Estab   4      4**
  fda0:XXXX:XXXX:d::f 4 650XX         132192    171982    0    0   28d18h Estab   0      0

az networkfabric device run-rw --resource-name <ResourceName>; --resource-group <ResourceGroupName> --rw-command "router bgp 65055\\n neighbor untrustnetwork shutdown"

Параметр	Описание
`az networkfabric device run-rw`	Команда Azure CLI для выполнения операции чтения и записи на сетевом устройстве в Azure Network Fabric.
`--resource-name`	Указывает имя ресурса (сетевого устройства), на котором выполняется операция RW.
`--resource-group`	Указывает имя группы ресурсов, содержащей сетевое устройство.
`--rw-command "router bgp 65055\n neighbor untrustnetwork shutdown"`	Указывает команды RW, выполняемые на сетевом устройстве. Эти команды настраивают параметры BGP для завершения работы соседа с именем untrustnetwork.

Ожидаемые выходные данные:

{}

sh ip bgp  summary vrf gfab1-isd

BGP summary information for VRF gfab1-isd
Router identifier 10.XXX.14.34,
Neighbor            V AS           MsgRcvd   MsgSent  InQ OutQ  Up/Down State   PfxRcd PfxAcc
  10.XXX.13.15        4 65055         129462    168986    0    0 00:10:10 Estab   189    189
  10.XXX.30.18        4 65055          42224     42527    0    0 00:04:04 Estab   154    154
  fda0:XXX:XXXX:d::f 4 65055       132196    171987    0    0   28d18h Estab   0      0

AR-CE1)#Apr  X XX-XX:09 AR-CE1 Bgp: %BGP-3-NOTIFICATION: sent to neighbor **10.XXX.157.8** (VRF gfab1-isd AS 64512) 6/2 (Cease/administrative shutdown <Hard Reset>) reason: 

Apr  8 13:24:11 AR-CE1 Bgp: %BGP-3-NOTIFICATION: sent to neighbor **10.XXX.157.8** (VRF gfab1-isd AS 64512) 6/5 (Cease/connection rejected) 0 bytes

Команда с --no-wait --debug

az networkfabric device run-rw --resource-name <ResourceName> --resource-group <ResourceGroupName> --rw-command "router bgp 65055\n neighbor untrustnetwork shutdown" --no-wait --debug

Параметр	Описание
`az networkfabric device run-rw`	Команда Azure CLI для выполнения операции чтения и записи на сетевом устройстве в Azure Network Fabric.
`--resource-name`	Указывает имя ресурса (сетевого устройства), на котором выполняется операция RW.
`--resource-group`	Указывает имя группы ресурсов, содержащей сетевое устройство.
`--rw-command "router bgp 65055\n neighbor untrustnetwork shutdown"`	Указывает команды RW, выполняемые на сетевом устройстве. Эти команды настраивают параметры BGP для завершения работы соседа с именем untrustnetwork.
`--no-wait`	Указывает, что команда должна выполняться асинхронно, не ожидая завершения операции.
`--debug`	Пометка включения режима отладки, предоставляя дополнительные сведения о выполнении команды для устранения неполадок.

Ожидаемые усеченные выходные данные:

cli.knack.cli: Command arguments: ['networkfabric', 'device', 'run-rw', '--resource-name', <ResourceName>, '--resource-group', <ResourceGroup>, '--rw-command', 'router bgp 65055\\n neighbor untrustnetwork shutdown', '--debug'] 
cli.knack.cli: __init__ debug log: 
Enable color in terminal. 
cli.knack.cli: Event: Cli.PreExecute [] 
cli.azure.cli.core.sdk.policies:     'Expires': '-1' 
cli.azure.cli.core.sdk.policies:     'Location': 'https://eastus2euap.management.azure.com/subscriptions/XXXXXXXXXX/providers/Microsoft.ManagedNetworkFabric/locations/EASTUS/operationStatuses/4659700f-0280-491d-b478-491c6a88628c*F348648BDC06F42B2EDBC6E58?api-version=2022-01-15-privatepreview&t=638481804853087320 
telemetry.process: Return from creating process 
telemetry.main: Finish creating telemetry upload process.

Вы можете программно проверить состояние операции, выполнив следующую команду:

az rest -m get -u "<Azure-AsyncOperation-endpoint url>"

Пример URL-адреса конечной точки Azure-AsyncOperation, извлеченных из усеченных выходных данных.

<https://eastus.management.azure.com/subscriptions/xxxxxxxxxxx/providers/Microsoft.ManagedNetworkFabric/locations/EASTUS/operationStatuses/xxxxxxxxxxx?api-version=20XX-0X-xx-xx>

Состояние указывает, успешно ли выполнен или завершился сбой API.

Ожидаемые выходные данные:

https://eastus.management.azure.com/subscriptions/XXXXXXXX/providers/Microsoft.ManagedNetworkFabric/locations/EASTUS/operationStatuses/e239299a-8c71-426e-8460-58d4c0b470e2AB?api-version=2022-01-15-privatepreview

{

"endTime": "2024-XX-XXT10:14:13.2334379Z",
"id": "/subscriptions/XXXXXXXXXXXXXX/providers/Microsoft.ManagedNetworkFabric/locations/EASTUS/operationStatuses/e239299a-8c71-426e-DA565ABE0036AB",
"name": "e239299a-8c71-426e-8460-58d4c0b470e2\*E98FEC8C2D6479A6C0A450CE6E20DA4C9DDBF225A07F7F4850DA565ABE0036AB",
"properties": null,
"resourceId": "/subscriptions/XXXXXXXXXXXX/resourceGroups/ResourceGroup/providers/Microsoft.ManagedNetworkFabric/networkDevices/ResourceName",
"startTime": "2024-XX-XXT10:13:52.0438351Z",
"status": "Succeeded"
}

Неправильная операция конфигурации

Если вы попытаетесь реализовать на устройстве команду конфигурации и неправильная конфигурация, конфигурация не применяется на устройстве. Запрос выдает типичный ответ на ошибку, указывающий на сбой gNMI SET. Чтобы устранить эту ошибку, повторно примените правильную конфигурацию. Нет изменений в состоянии устройства.

az networkfabric device run-rw --resource-name <ResourceName> --resource-group <ResourceGroupName> --rw-command "router bgp 4444\n vrf gfab1-isd\n niehgbor 10.100.30.18 shudown"

Параметр	Описание
`az networkfabric device run-rw`	Команда Azure CLI для выполнения операции чтения и записи на сетевом устройстве в Azure Network Fabric.
`--resource-name`	Указывает имя ресурса (сетевого устройства), на котором выполняется операция RW.
`--resource-group`	Указывает имя группы ресурсов, содержащей сетевое устройство.
`--rw-command "router bgp 4444\n vrf gfab1-isd\n niehgbor 10.100.30.18 shudown"`	Указывает команды RW, выполняемые на сетевом устройстве. Эти команды настраивают параметры BGP для завершения работы соседа с IP-адресом 10.100.30.18 в VRF с именем gfab1-isd.

Ожидаемые выходные данные:

Error: Message: \[GNMI SET failed. Error: GNMI SET failed: rpc error: code = config failed to apply.

Выполнение команд записи чтения

Поделиться через

Отключение соседей по протоколу пограничного шлюза

Завершение работы определенного однорангового узла на уровне виртуальной маршрутизации и пересылки (VRF)

Завершение работы одноранговой группы на уровне VRF

Неправильная операция конфигурации

Обратная связь

Дополнительные ресурсы

Поделиться через

Отключение соседей по протоколу пограничного шлюза

Завершение работы определенного однорангового узла на уровне виртуальной маршрутизации и пересылки (VRF)

Завершение работы одноранговой группы на уровне VRF

Неправильная операция конфигурации

Связанный контент

Обратная связь

Дополнительные ресурсы