Desativar ou remover sessões do BGP

É possível desativar uma sessão do BGP temporariamente ou removê-la completamente. Alguns motivos comuns para desativar uma sessão são alterar a configuração do roteador ao migrar para um peering do BGP diferente ou realizar a manutenção em um peering do BGP.

Antes de começar

Para usar os exemplos de linha de comando deste guia:

  1. Instale ou atualize para a versão mais recente da Google Cloud CLI.
  2. Defina uma região e uma zona padrão.

Para usar os exemplos da API deste guia, configure o acesso a ela.

Desativar uma sessão do BGP

É possível desativar uma sessão do BGP usando o Console do Google Cloud, o comando update-bgp-peer ou a API. As sessões do BGP são ativadas por padrão.

Se desativada, qualquer sessão ativa com o par no nível de protocolo BGP será encerrada e todas as informações de roteamento associadas serão removidas.

Para desativar uma sessão do BGP, siga estas etapas.

Console

  1. No console do Google Cloud, acesse a página do Cloud Routers.

    Acesse o Cloud Routers

  2. Selecione o roteador que hospeda a sessão do BGP que você quer desativar.
  3. Na página Detalhes do roteador, selecione a sessão do BGP que você quer desativar.
  4. Na página de detalhes da sessão do BGP, clique em Editar.
  5. Em Peering do BGP, selecione Desativado.
  6. Clique em Save.

gcloud

Execute o comando update-bgp-peer:

  gcloud compute routers update-bgp-peer ROUTER_NAME \
      --project=PROJECT_ID \
      --peer-name=PEER_NAME \
      --region=REGION \
      --no-enabled

Substitua:

  • ROUTER_NAME: o nome do seu Cloud Router
  • PROJECT_ID: o projeto que contém o Cloud Router
  • PEER_NAME: o nome do peer do BGP
  • REGION: a região onde o Cloud Router está localizado

API

Use o método routers.patch para atualizar o campo bgpPeers[].

O campo bgpPeers[] aceita uma matriz de pares do BGP. Quando você PATCH esse campo, você substitui a matriz atual de pares do BGP pela nova matriz incluída na solicitação.

  1. Envie uma solicitação GET para receber a matriz atual de pares do BGP para o roteador. Para detalhes, consulte Visualizar as configurações da sessão do BGP.

  2. Envie uma solicitação PATCH com uma nova matriz de pares do BGP. Para cada par do BGP para o qual você quer desativar a sessão do BGP, defina bgpPeers[].enable como FALSE.

    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME
    {
      "bgpPeers": [
        BGP_PEERS
      ]
    }
    

    Substitua:

    • PROJECT_ID: o projeto que contém o Cloud Router
    • REGION: a região onde o Cloud Router está localizado
    • ROUTER_NAME: o nome do Cloud Router
    • BGP_PEERS: o conteúdo da nova matriz de pares do BGP

    O exemplo a seguir desativa a sessão do primeiro peer do BGP:

        {
          "name": "peer-1",
          "interfaceName": "if-peer-1",
          "ipAddress": "169.254.10.1",
          "peerIpAddress": "169.254.10.2",
          "peerAsn": 64512,
          "advertisedRoutePriority": 100,
          "advertiseMode": "DEFAULT",
          "advertisedGroups": [],
          "advertisedIpRanges": [],
          "enable": "FALSE"
        },
        {
          "name": "peer-2",
          "interfaceName": "if-peer-2",
          "ipAddress": "169.254.20.1",
          "peerIpAddress": "169.254.20.2",
          "peerAsn": 64513,
          "advertisedRoutePriority": 100,
          "advertiseMode": "DEFAULT",
          "advertisedGroups": [],
          "advertisedIpRanges": []
        }
    

Ativar uma sessão do BGP

É possível ativar uma sessão do BGP usando o Console do Google Cloud, o comando update-bgp-peer ou a API. As sessões do BGP são ativadas por padrão.

Se estiver ativada, a conexão de peering pode ser estabelecida com informações de roteamento.

Para ativar uma sessão do BGP, siga estas etapas.

Console

  1. No console do Google Cloud, acesse a página do Cloud Routers.

    Acesse o Cloud Routers

  2. Selecione o roteador que hospeda a sessão do BGP que você quer ativar.
  3. Na página Detalhes do roteador, selecione a sessão do BGP que você quer ativar.
  4. Na página de detalhes da sessão do BGP, clique em Editar.
  5. Em Peering do BGP, selecione Ativado.
  6. Clique em Save.

gcloud

Execute o comando update-bgp-peer:

  gcloud compute routers update-bgp-peer ROUTER_NAME \
      --project=PROJECT_ID \
      --peer-name=PEER_NAME \
      --region=REGION \
      --enabled

Substitua:

  • ROUTER_NAME: o nome do seu Cloud Router
  • PROJECT_ID: o projeto que contém o Cloud Router
  • PEER_NAME: o nome do peer do BGP
  • REGION: a região onde o Cloud Router está localizado

API

Use o método routers.patch para atualizar o campo bgpPeers[].

O campo bgpPeers[] aceita uma matriz de pares do BGP. Ao fazer uma solicitação PATCH com esse campo especificado, você substitui a matriz existente de pares do BGP pela nova matriz incluída na solicitação.

  1. Envie uma solicitação GET para receber a matriz atual de pares do BGP para o roteador. Para detalhes, consulte Visualizar detalhes do Cloud Router.

  2. Envie uma solicitação PATCH com uma nova matriz de pares do BGP. Para cada par do BGP para o qual você quer ativar a sessão do BGP, defina bgpPeers[].enable como TRUE.

    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME
    {
      "bgpPeers": [
        BGP_PEERS
      ]
    }
    

    Substitua:

    • PROJECT_ID: o projeto que contém o Cloud Router
    • REGION: a região onde o Cloud Router está localizado
    • ROUTER_NAME: o nome do Cloud Router
    • BGP_PEERS: o conteúdo da nova matriz de pares do BGP

    O exemplo a seguir ativa a sessão para o primeiro par do BGP:

        {
          "name": "peer-1",
          "interfaceName": "if-peer-1",
          "ipAddress": "169.254.10.1",
          "peerIpAddress": "169.254.10.2",
          "peerAsn": 64512,
          "advertisedRoutePriority": 100,
          "advertiseMode": "DEFAULT",
          "advertisedGroups": [],
          "advertisedIpRanges": [],
          "enable": "TRUE"
        },
        {
          "name": "peer-2",
          "interfaceName": "if-peer-2",
          "ipAddress": "169.254.20.1",
          "peerIpAddress": "169.254.20.2",
          "peerAsn": 64513,
          "advertisedRoutePriority": 100,
          "advertiseMode": "DEFAULT",
          "advertisedGroups": [],
          "advertisedIpRanges": []
        }
    

Remover uma sessão do BGP

Se você excluir o túnel do Cloud VPN ou o anexo da VLAN associado a uma sessão do BGP, a sessão será removida automaticamente.

É possível remover sessões do BGP manualmente com o Console do Google Cloud, o comando remove-bgp-peer ou a API. Se você remover a sessão do BGP, o túnel da VPN ou o anexo da VLAN permanecerá, mas o Cloud Router não divulgará rotas neles.

Para remover uma sessão do BGP, siga estas etapas.

Console

  1. No console do Google Cloud, acesse a página do Cloud Routers.

    Acesse o Cloud Routers

  2. Selecione o roteador do qual você quer remover uma sessão do BGP.
  3. Em Sessões do BGP, selecione a sessão do BGP que você quer remover.
  4. Na parte superior da página, clique em Excluir e confirme a exclusão.

gcloud

Execute o comando remove-bgp-peer:

gcloud compute routers remove-bgp-peer ROUTER_NAME \
    --project=PROJECT_ID \
    --peer-name=PEER_NAME \
    --region=REGION \

Substitua:

  • ROUTER_NAME: o nome do seu Cloud Router
  • PROJECT_ID: o projeto que contém o Cloud Router
  • PEER_NAME: o nome do peer do BGP
  • REGION: a região onde o Cloud Router está localizado

API

Para remover pares BGP de um Cloud Router, use o método routers.patch para atualizar o campo bgpPeers[].

O campo bgpPeers[] aceita uma matriz de pares do BGP. Quando você PATCH esse campo, você substitui a matriz atual de pares do BGP pela nova matriz incluída na solicitação.

  1. Envie uma solicitação GET para receber a matriz atual de pares do BGP para o roteador. Para detalhes, consulte Visualizar detalhes do Cloud Router.

  2. Envie uma solicitação PATCH com uma nova matriz de pares do BGP. Use a matriz da solicitação GET na etapa anterior e remova os pares do BGP que você não quer no roteador.

    É possível enviar uma matriz vazia para remover todos os pares do BGP.

    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME
    {
      "bgpPeers": [
        BGP_PEERS
      ]
    }
    

    Substitua:

    • PROJECT_ID: o projeto que contém o Cloud Router
    • REGION: a região onde o Cloud Router está localizado
    • ROUTER_NAME: o nome do Cloud Router
    • BGP_PEERS: o conteúdo da nova matriz de pares do BGP

    O exemplo a seguir contém dois pares do BGP:

        {
          "name": "peer-1",
          "interfaceName": "if-peer-1",
          "ipAddress": "169.254.10.1",
          "peerIpAddress": "169.254.10.2",
          "peerAsn": 64512,
          "advertisedRoutePriority": 100,
          "advertiseMode": "DEFAULT"
        },
        {
          "name": "peer-2",
          "interfaceName": "if-peer-2",
          "ipAddress": "169.254.20.1",
          "peerIpAddress": "169.254.20.2",
          "peerAsn": 64513,
          "advertisedRoutePriority": 100,
          "advertiseMode": "DEFAULT"
        }
    

A seguir