Apresente rotas BGP

Esta página descreve como listar rotas anunciadas e rotas aprendidas em sessões individuais do Border Gateway Protocol (BGP), o que pode ajudar a resolver problemas com as rotas do Cloud Router. Pode listar as rotas antes ou depois de as políticas de rotas BGP serem aplicadas a uma rota. Para resolver problemas de rotas anunciadas e aprendidas, recomendamos que conclua as seguintes secções pela ordem indicada.

Antes de começar

gcloud

Se quiser usar os exemplos de linhas de comandos neste guia, faça o seguinte:

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

API

Se quiser usar os exemplos de API neste guia, configure o acesso à API.

Liste as rotas BGP antes de as políticas serem aplicadas

Consola

Faça o seguinte:

  1. Na Google Cloud consola, aceda à página Cloud Router.

    Aceda ao Cloud Router

  2. Na página Cloud Router, clique no separador Sessões BGP.

  3. Selecione o par da sessão BGP que quer listar. É apresentada a página de detalhes da sessão de BGP. As rotas anunciadas estão listadas na secção Rotas anunciadas.

gcloud

Use o comando gcloud compute routers list-bgp-routes:

gcloud compute routers list-bgp-routes ROUTER_NAME \
    --address-family=ADDRESS_FAMILY \
    --no-policy-applied \
    --peer=PEER_NAME \
    --region=REGION \
    --route-direction=ROUTE_DIRECTION

Substitua o seguinte:

  • ROUTER_NAME: o nome do seu Cloud Router

  • ADDRESS_FAMILY: a família de endereços IP para apresentar rotas para:

    • IPV4: para endereços BGP baseados em IPv4
    • IPV6: para endereços BGP baseados em IPv6

  • PEER_NAME: o nome do par BGP

  • REGION: a região em que o seu Cloud Router está localizado

  • ROUTE_DIRECTION: a direção para apresentar trajetos para:

    • INBOUND: rotas aprendidas com o par BGP
    • OUTBOUND: rotas anunciadas ao par BGP

O resultado é semelhante ao seguinte:

---
asPaths:
- asns:
  - 64515
  type: AS_PATH_TYPE_SEQUENCE
destination:
  prefix: 192.168.1.0/24
med: 100
origin: BGP_ORIGIN_INCOMPLETE
---
asPaths:
- asns:
  - 64515
  type: AS_PATH_TYPE_SEQUENCE
destination:
  prefix: 192.168.2.0/24
med: 333
origin: BGP_ORIGIN_INCOMPLETE

API

Use o routers.listBgpRoutes método:

GET https://compute.googleapis.com/compute/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME/listBgpRoutes
{
  "addressFamily": "ADDRESS_FAMILY",
  "peer": "PEER_NAME",
  "policyApplied": FALSE,
  "routeType": "ROUTE_TYPE"
}

Substitua o seguinte:

  • PROJECT_ID: o projeto que contém o seu Cloud Router

  • REGION: a região em que o seu Cloud Router está localizado

  • ROUTER_NAME: o nome do seu Cloud Router

  • ADDRESS_FAMILY: a família de endereços IP para apresentar rotas para:

    • IPV4: para endereços BGP baseados em IPv4
    • IPV6: para endereços BGP baseados em IPv6

  • PEER_NAME: o nome do par BGP

  • ROUTE_TYPE: o tipo de trajeto a apresentar:

    • LEARNED: trajeto aprendido com o par de BGP
    • ADVERTISED: rota anunciada ao par BGP

O resultado é semelhante ao seguinte:

{
  "kind": "compute#routersListBgpRoutes",
  "result": [
    {
      "destination": {
        "prefix": "10.0.1.0/24"
      },
      "med": 100
    },
    {
      "destination": {
        "prefix": "10.0.2.0/24"
      },
      "med": 338
    }
  ]
}

Liste as rotas BGP depois de as políticas serem aplicadas

Consola

  1. Na Google Cloud consola, aceda à página Cloud Router.

    Aceda ao Cloud Router

  2. Na página Cloud Router, clique no separador Sessões BGP.

  3. Selecione o par da sessão BGP que quer listar. É apresentada a página de detalhes da sessão de BGP. As rotas anunciadas estão listadas na secção Rotas anunciadas.

gcloud

Use o comando gcloud compute routers list-bgp-routes:

gcloud compute routers list-bgp-routes ROUTER_NAME \
    --address-family=ADDRESS_FAMILY \
    --policy-applied \
    --peer=PEER_NAME \
    --region=REGION \
    --route-direction=ROUTE_DIRECTION

Substitua o seguinte:

  • ADDRESS_FAMILY: a família de endereços IP para apresentar rotas para:

    • IPV4: para endereços BGP baseados em IPv4
    • IPV6: para endereços BGP baseados em IPv6

  • PEER_NAME: o nome do par BGP

  • ROUTE_DIRECTION: a direção para apresentar trajetos para:

    • INBOUND: rotas aprendidas com o par BGP
    • OUTBOUND: rotas anunciadas ao par BGP

O resultado é semelhante ao seguinte:

---
asPaths:
- asns:
- 64515
type: AS_PATH_TYPE_SEQUENCE
communities:
- 65535:65281
destination:
prefix: 192.168.1.0/24
med: 100
origin: BGP_ORIGIN_INCOMPLETE
---
asPaths:
- asns:
- 64515
type: AS_PATH_TYPE_SEQUENCE
communities:
- 65535:65281
destination:
prefix: 192.168.2.0/24
med: 333
origin: BGP_ORIGIN_INCOMPLETE

API

Use o routers.listBgpRoutes método:

GET https://compute.googleapis.com/compute/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME/listBgpRoutes
{
"addressFamily": "ADDRESS_FAMILY",
"peer": "PEER_NAME",
"policyApplied": TRUE,
"routeType": "ROUTE_TYPE"
}

Substitua o seguinte:

  • PROJECT_ID: o projeto que contém o seu Cloud Router

  • REGION: a região em que o seu Cloud Router está localizado

  • ROUTER_NAME: o nome do seu Cloud Router

  • ADDRESS_FAMILY: a família de endereços IP para apresentar rotas para:

    • IPV4: para endereços BGP baseados em IPv4
    • IPV6: para endereços BGP baseados em IPv6

  • PEER_NAME: o nome do par BGP

  • ROUTE_TYPE: o tipo de trajeto a apresentar:

    • LEARNED: trajeto aprendido com o par de BGP
    • ADVERTISED: rota anunciada ao par BGP

O resultado é semelhante ao seguinte:

{
  "kind": "compute#routersListBgpRoutes",
  "result": [
    {
      "destination": {
        "prefix": "10.0.1.0/24"
      },
      "asPaths": [
        {
          "type": "AS_PATH_TYPE_SEQUENCE",
          "asns": [
            64514
          ]
        }
      ],
      "origin": "BGP_ORIGIN_INCOMPLETE",
      "med": 100
    },
    {
      "destination": {
        "prefix": "10.0.2.0/24"
      },
      "asPaths": [
        {
          "type": "AS_PATH_TYPE_SEQUENCE",
          "asns": [
            64514
          ]
        }
      ],
      "origin": "BGP_ORIGIN_INCOMPLETE",
      "med": 338
    }
  ]
}

Verifique os melhores trajetos dinâmicos

Verifique as melhores rotas dinâmicas por Cloud Router e por região por VPC:

gcloud

Use o gcloud compute routers get-status comando:

gcloud compute routers get-status ROUTER_NAME \
    --region=REGION

A saída inclui as seguintes informações:

  • bestRoutesForRouter: representa os melhores trajetos para um Cloud Router específico
  • bestRoutes: representa as melhores rotas por região de um Cloud Router dessa VPC.

O resultado é semelhante ao seguinte para bestRoutesForRouter:

  bestRoutesForRouter:
  - asPaths:
    - asLists:
      - 65002
      pathSegmentType: AS_SEQUENCE
    creationTimestamp: '2024-09-26T18:28:54.346-07:00'
    destRange: 192.168.1.0/24
    kind: compute#route
    network: https://www.googleapis.com/compute/projects/PROJECT_ID/global/networks/NETWORK_NAME
    nextHopIp: 169.254.0.2
    nextHopOrigin: INCOMPLETE
    nextHopVpnTunnel: https://www.googleapis.com/compute/projects/PROJECT_ID/regions/REGION/vpnTunnels/vpc-demo-tunnel0
    priority: 100
    routeStatus: ACTIVE
    routeType: BGP
  - asPaths:
    - asLists:
      - 65002
      pathSegmentType: AS_SEQUENCE
    creationTimestamp: '2024-09-27T12:44:56.575-07:00'
    destRange: 192.168.1.0/24
    kind: compute#route
    network: https://www.googleapis.com/compute/projects/PROJECT_ID/global/networks/NETWORK_NAME
    nextHopIp: 169.254.1.2
    nextHopOrigin: INCOMPLETE
    nextHopVpnTunnel: https://www.googleapis.com/compute/projects/PROJECT_ID/regions/REGION/vpnTunnels/vpc-demo-tunnel1
    priority: 100
    routeStatus: ACTIVE
    routeType: BGP

O resultado é semelhante ao seguinte para bestRoutes:

  bestRoutes:
  - asPaths:
    - asLists:
      - 65002
      pathSegmentType: AS_SEQUENCE
    creationTimestamp: '2024-09-26T18:33:50.505-07:00'
    destRange: 192.168.1.0/24
    kind: compute#route
    network: https://www.googleapis.com/compute/projects/PROJECT_ID/global/networks/NETWORK_NAME
    nextHopIp: 169.254.0.2
    nextHopOrigin: INCOMPLETE
    nextHopVpnTunnel: https://www.googleapis.com/compute/projects/PROJECT_ID/regions/REGION/vpnTunnels/vpc-demo-tunnel0
    priority: 100
    routeType: BGP
  - asPaths:
    - asLists:
      - 65002
      pathSegmentType: AS_SEQUENCE
    creationTimestamp: '2024-09-27T12:46:49.028-07:00'
    destRange: 192.168.1.0/24
    kind: compute#route
    network: https://www.googleapis.com/compute/projects/PROJECT_ID/global/networks/NETWORK_NAME
    nextHopIp: 169.254.1.2
    nextHopOrigin: INCOMPLETE
    nextHopVpnTunnel: https://www.googleapis.com/compute/projects/PROJECT_ID/regions/REGION/vpnTunnels/vpc-demo-tunnel1
    priority: 100
    routeType: BGP

A saída inclui os seguintes valores:

  • PROJECT_ID: o projeto que contém o seu Cloud Router

  • NETWORK_NAME: o nome da rede da VPC

  • REGION: o nome da região

API

Use o método routers.getRouterStatus:

GET https://compute.googleapis.com/compute/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME/getRouterStatus

Substitua o seguinte:

  • PROJECT_ID: o projeto que contém o seu Cloud Router

  • REGION: a região em que o seu Cloud Router está localizado

  • ROUTER_NAME: o nome do seu Cloud Router

A saída inclui as seguintes informações:

  • bestRoutes: representa as melhores rotas por região de um Cloud Router dessa VPC.
  • bestRoutesForRouter: representa os melhores trajetos para um Cloud Router específico

O resultado é semelhante ao seguinte para bestRoutes:

    "bestRoutes": [
      {
        "kind": "compute#route",
        "creationTimestamp": "2025-03-05T11:20:40.323-08:00",
        "network": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks/NETWORK_NAME",
        "destRange": "200.0.0.0/24",
        "priority": 100,
        "nextHopIp": "169.254.0.1",
        "nextHopVpnTunnel": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/vpnTunnels/TUNNEL_NAME",
        "routeType": "BGP",
        "asPaths": [
          {
            "pathSegmentType": "AS_SEQUENCE",
            "asLists": [
              65001
            ]
          }
        ],
        "nextHopOrigin": "INCOMPLETE"
      },

O resultado é semelhante ao seguinte para bestRoutesForRouter:

    "bestRoutesForRouter": [
      {
        "kind": "compute#route",
        "creationTimestamp": "2025-03-05T11:20:50.240-08:00",
        "network": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks/NETWORK_NAME",
        "destRange": "10.2.1.0/24",
        "priority": 100,
        "nextHopIp": "169.254.0.1",
        "nextHopVpnTunnel": "https://www.googleapis.com/compute/v1/projects/PROJECT_NAME/regions/REGION/vpnTunnels/TUNNEL_NAME",
        "routeType": "BGP",
        "asPaths": [
          {
            "pathSegmentType": "AS_SEQUENCE",
            "asLists": [
              65001
            ]
          }
        ],
        "routeStatus": "ACTIVE",
        "nextHopOrigin": "INCOMPLETE"
      },
      {
        "kind": "compute#route",
        "creationTimestamp": "2025-03-05T01:50:01.725-08:00",
        "network": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks/on-prem",
        "destRange": "200.0.0.0/24",
        "priority": 100,
        "nextHopIp": "169.254.0.1",
        "nextHopVpnTunnel": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/vpnTunnels/TUNNEL_NAME",
        "routeType": "BGP",
        "asPaths": [
          {
            "pathSegmentType": "AS_SEQUENCE",
            "asLists": [
              65001
            ]
          }
        ],
        "routeStatus": "ACTIVE",
        "nextHopOrigin": "INCOMPLETE"
      },
      {
        "kind": "compute#route",
        "creationTimestamp": "2025-03-06T05:30:06.277-08:00",
        "network": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks/on-prem",
        "destRange": "10.2.1.0/24",
        "priority": 100,
        "nextHopIp": "169.254.1.1",
        "nextHopVpnTunnel": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/vpnTunnels/TUNNEL_NAME",
        "routeType": "BGP",
        "asPaths": [
          {
            "pathSegmentType": "AS_SEQUENCE",
            "asLists": [
              65001
            ]
          }
        ],
        "routeStatus": "ACTIVE",
        "nextHopOrigin": "INCOMPLETE"
      }
    ],

A saída inclui os seguintes valores:

  • PROJECT_ID: o projeto que contém o seu Cloud Router

  • REGION: a região em que o seu Cloud Router está localizado

  • ROUTER_NAME: o nome do seu Cloud Router

  • TUNNEL_NAME: se aplicável, o nome do seu túnel de VPN

Veja a tabela de rotas do plano de encaminhamento da VPC

Faça o seguinte:

  1. Na Google Cloud consola, aceda à página Rotas.

    Aceda a Trajetos

  2. No separador Rotas eficazes, selecione a rede para a qual quer listar rotas.

  3. Na lista Região, selecione a região na qual quer apresentar as rotas e, de seguida, clique em Ver.