Desabilitar os vizinhos de Border Gateway Protocol

Artigo
05/08/2024

Este artigo fornece exemplos que demonstram como um usuário pode implementar os comandos RW (leitura/gravação) para desabilitar os vizinhos do BGP (Border Gateway Protocol).

Desligar um par específico no nível de VRF (Roteamento e Encaminhamento Virtual)

O seguinte mostra um instantâneo do Dispositivo do Network Fabric antes de fazer alterações na configuração usando a API de 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

Execute o seguinte comando para desabilitar o vizinho 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"

Saída esperada:

{}

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

Comando com --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

Parâmetro	Descrição
`az networkfabric device run-rw`	Comando da CLI do Azure para executar uma operação de leitura/gravação em um dispositivo de rede no Azure Network Fabric.
`--resource-name`	Especifica o nome do recurso (dispositivo de rede) no qual a operação de RW será executada.
`--resource-group`	Especifica o nome do grupo de recursos que contém o dispositivo de rede.
`--rw-command "router bgp 65055\n vrf gfab1-isd\n neighbor 10.100.30.18 shutdown"`	Especifica os comandos de RW a serem executados no dispositivo de rede. Esses comandos definem as configurações do BGP e desligam um vizinho específico.
`--no-wait`	Indica que o comando deve ser executado de maneira assíncrona, sem aguardar a conclusão da operação.
`--debug`	Sinalizador habilitando o modo de depuração, fornecendo informações adicionais sobre a execução do comando para fins de solução de problemas.

Saída esperada:

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=

Você pode verificar programaticamente o status da operação executando o seguinte comando:

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

Exemplo da URL do ponto de extremidade Azure-AsyncOperation extraída da saída truncada.

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

O status indica se a API foi bem-sucedida ou falhou.

Saída esperada:

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"
}

Desligar o grupo de pares no nível do VRF

Este exemplo mostra como a configuração RW é desligada do grupo de pares em um nível 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"

Parâmetro	Descrição
`az networkfabric device run-rw`	Comando da CLI do Azure para executar uma operação de leitura/gravação em um dispositivo de rede no Azure Network Fabric.
`--resource-name`	Especifica o nome do recurso (dispositivo de rede) no qual a operação de RW é executada.
`--resource-group`	Especifica o nome do grupo de recursos que contém o dispositivo de rede.
`--rw-command "router bgp 65055\n neighbor untrustnetwork shutdown"`	Especifica os comandos de RW a serem executados no dispositivo de rede. Esses comandos definem as configurações do BGP para desligar o vizinho chamado "untrustnetwork".

Saída esperada:

{}

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

Comando com --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

Parâmetro	Descrição
`az networkfabric device run-rw`	Comando da CLI do Azure para executar uma operação de leitura/gravação em um dispositivo de rede no Azure Network Fabric.
`--resource-name`	Especifica o nome do recurso (dispositivo de rede) no qual a operação de RW é executada.
`--resource-group`	Especifica o nome do grupo de recursos que contém o dispositivo de rede.
`--rw-command "router bgp 65055\n neighbor untrustnetwork shutdown"`	Especifica os comandos de RW a serem executados no dispositivo de rede. Esses comandos definem as configurações do BGP para desligar o vizinho chamado "untrustnetwork".
`--no-wait`	Indica que o comando deve ser executado de maneira assíncrona, sem aguardar a conclusão da operação.
`--debug`	Sinalizador habilitando o modo de depuração, fornecendo informações adicionais sobre a execução do comando para fins de solução de problemas.

Saída truncada esperada:

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.

Você pode verificar programaticamente o status da operação executando o seguinte comando:

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

Exemplo da URL do ponto de extremidade Azure-AsyncOperation extraída da saída truncada.

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

O status indica se a API foi bem-sucedida ou falhou.

Saída esperada:

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"
}

Operação de configuração incorreta

Se você tentar implementar um comando de configuração no dispositivo e a configuração estiver incorreta, a configuração não será imposta no dispositivo. O prompt gera uma resposta de erro típica, indicando uma falha gNMI SET. Para corrigir esse erro, reaplique a configuração correta. Não há nenhuma alteração no estado do dispositivo.

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"

Parâmetro	Descrição
`az networkfabric device run-rw`	Comando da CLI do Azure para executar uma operação de leitura/gravação em um dispositivo de rede no Azure Network Fabric.
`--resource-name`	Especifica o nome do recurso (dispositivo de rede) no qual a operação de RW é executada.
`--resource-group`	Especifica o nome do grupo de recursos que contém o dispositivo de rede.
`--rw-command "router bgp 4444\n vrf gfab1-isd\n niehgbor 10.100.30.18 shudown"`	Especifica os comandos de RW a serem executados no dispositivo de rede. Esses comandos definem as configurações de BGP para desligar o vizinho com o endereço IP 10.100.30.18 dentro do VRF chamado "gfab1-isd".

Saída esperada:

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

Executar comandos de leitura e gravação

Compartilhar via

Desabilitar os vizinhos de Border Gateway Protocol

Desligar um par específico no nível de VRF (Roteamento e Encaminhamento Virtual)

Desligar o grupo de pares no nível do VRF

Operação de configuração incorreta

Comentários

Recursos adicionais

Compartilhar via

Desabilitar os vizinhos de Border Gateway Protocol

Desligar um par específico no nível de VRF (Roteamento e Encaminhamento Virtual)

Desligar o grupo de pares no nível do VRF

Operação de configuração incorreta

Conteúdo relacionado

Comentários

Recursos adicionais