Criar e gerenciar roteadores

Esta página descreve como criar e gerenciar recursos de roteador conectado do Google Distributed Cloud em uma zona do Distributed Cloud.

Essa funcionalidade só está disponível em racks conectados do Distributed Cloud. Os servidores conectados do Distributed Cloud não oferecem suporte a recursos de roteador.

Para mais informações sobre os roteadores do Distributed Cloud, consulte Como o Distributed Cloud conectado funciona.

Lembre-se:

  • É possível criar um roteador por rede do Distributed Cloud.

  • Recomendamos que você crie um roteador e o anexo de interconexão correspondente ao mesmo tempo. Para mais informações sobre como criar um anexo de interconexão, consulte Criar um anexo de interconexão.

Criar um roteador

Para criar um roteador do Distributed Cloud, siga as etapas desta seção.

Para concluir essa tarefa, você precisa ter o papel de administrador da rede de borda (roles/edgenetwork.admin) em seu Google Cloud projeto.

gcloud

Use o comando gcloud edge-cloud networking routers create:

gcloud edge-cloud networking routers create ROUTER_NAME \
    --network=NETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME \
    --asn=ASN

Substitua:

  • ROUTER_NAME: um nome descritivo que identifica exclusivamente esse roteador.
  • NETWORK_NAME: o nome da rede que esse roteador atende.
  • REGION: aregião a que a zona conectada do Distributed Cloud de destino pertence. Google Cloud
  • ZONE_NAME: o nome da zona conectada do Distributed Cloud de destino.
  • ASN: o número do sistema autônomo (ASN, na sigla em inglês) desse roteador. É possível especificar um valor de dois ou quatro bytes. Oferece suporte a valores de ASN públicos e particulares.

API

Faça uma solicitação POST para o método projects.locations.zones.routers.create:

POST /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/routers?routerId=ROUTER_ID
{
 "labels": { LABELS,
  },
 "network": { NETWORK_NAME,
  },
 "asn": { ASN,
  },      
}

Substitua:

  • PROJECT_ID: o ID doprojeto de destino. Google Cloud
  • REGION: aregião a que a zona conectada do Distributed Cloud de destino pertence. Google Cloud
  • ZONE_NAME: o nome da zona conectada do Distributed Cloud de destino.
  • ROUTER_ID: um ID que identifica exclusivamente esse roteador.
  • LABELS: uma lista de rótulos a serem aplicados a esse recurso de roteador.
  • NETWORK_NAME: o nome da rede que esse roteador atende.
  • ASN: o número do sistema autônomo (ASN, na sigla em inglês) desse roteador. É possível especificar um valor de dois ou quatro bytes. Oferece suporte a valores de ASN públicos e particulares.

Estabelecer uma sessão de peering do BGP em um roteador

Um roteador permite estabelecer os seguintes tipos de sessões de peering do protocolo de gateway de borda (BGP, na sigla em inglês):

Uma sessão de peering do BGP é estabelecida pela adição de uma interface ao roteador para o componente de rede do Distributed Cloud que corresponde ao tipo de sessão de peering.

Estabelecer uma sessão de peering de saída

Para estabelecer uma sessão de peering de saída em um roteador com um anexo de interconexão, siga as etapas desta seção. O anexo de interconexão de destino precisa estar associado ao roteador de destino.

Para concluir essa tarefa, você precisa ter o papel de administrador da rede de borda (roles/edgenetwork.admin) em seu Google Cloud projeto.

gcloud

Use o comando gcloud edge-cloud networking routers add-interface:

gcloud edge-cloud networking routers add-interface ROUTER_NAME \
    --interface-name=INTERFACE_NAME \
    --interconnect-attachment=ATTACHMENT_NAME \
    --ip-address=INTERCONNECT_ADDRESS \
    --ip-mask-length=IP_MASK_LENGTH \
    --location=REGION \
    --zone=ZONE_NAME

Substitua:

  • ROUTER_NAME: o nome do roteador de destino.
  • INTERFACE_NAME: um nome descritivo para essa interface.
  • ATTACHMENT_NAME: o nome do anexo de interconexão de destino no roteador de destino.
  • INTERCONNECT_ADDRESS: o endereço IP da interconexão em que o anexo de interconexão de destino está configurado.
  • IP_MASK_LENGTH: o comprimento da máscara para o endereço IP de interconexão especificado.
  • REGION: aregião a que a zona conectada do Distributed Cloud de destino pertence. Google Cloud
  • ZONE_NAME: o nome da zona conectada do Distributed Cloud de destino.

Estabelecer uma sessão de peering de entrada

Para estabelecer uma sessão de peering de entrada em um roteador com uma sub-rede, siga as etapas desta seção.

Para concluir essa tarefa, você precisa ter o papel de administrador da rede de borda (roles/edgenetwork.admin) em seu Google Cloud projeto.

gcloud

Use o comando gcloud edge-cloud networking routers add-interface:

gcloud edge-cloud networking routers add-interface ROUTER_NAME \
    --interface-name=INTERFACE_NAME \
    --subnet=SUBNETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Substitua:

  • ROUTER_NAME: o nome do roteador de destino.
  • INTERFACE_NAME: um nome descritivo para essa interface.
  • SUBNETWORK_NAME: o nome da sub-rede de destino.
  • REGION: aregião a que a zona conectada do Distributed Cloud de destino pertence. Google Cloud
  • ZONE_NAME: o nome da zona conectada do Distributed Cloud de destino.

Estabelecer uma sessão de peering de loopback

Para estabelecer uma sessão de peering de loopback em um roteador com uma rede, siga as etapas desta seção.

Para concluir essa tarefa, você precisa ter o papel de administrador da rede de borda (roles/edgenetwork.admin) em seu Google Cloud projeto.

gcloud

Use o comando gcloud edge-cloud networking routers add-interface:

gcloud edge-cloud networking routers add-interface ROUTER_NAME \
    --interface-name=INTERFACE_NAME \
    --loopback-ip-addresses=LOOPBACK_ADDRESSES \
    --location=REGION \
    --zone=ZONE_NAME

Substitua:

  • ROUTER_NAME: o nome do roteador de destino.
  • INTERFACE_NAME: um nome descritivo para essa interface.
  • LOOPBACK_ADDRESSES: os endereços IPv4 de entrada e saída para a interface de loopback, separados por vírgulas.
  • REGION: aregião a que a zona conectada do Distributed Cloud de destino pertence. Google Cloud
  • ZONE_NAME: o nome da zona conectada do Distributed Cloud de destino.

Encerrar uma sessão de peering do BGP

Para encerrar uma sessão de peering do BGP entre um roteador e um anexo de interconexão, uma sub-rede ou uma rede, é necessário excluir a interface desse componente de rede do roteador de destino. Para excluir a interface, siga as etapas desta seção.

Para concluir essa tarefa, você precisa ter o papel de administrador da rede de borda (roles/edgenetwork.admin) em seu Google Cloud projeto.

gcloud

Use o comando gcloud edge-cloud networking routers remove-interface:

gcloud edge-cloud networking routers remove-interface ROUTER_NAME \
    --interface-name=INTERFACE_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Substitua:

  • ROUTER_NAME: o nome do roteador de destino.
  • INTERFACE_NAME: um nome descritivo para essa interface.
  • REGION: aregião a que a zona conectada do Distributed Cloud de destino pertence. Google Cloud
  • ZONE_NAME: o nome da zona conectada do Distributed Cloud de destino.

Configurar apps semelhantes em uma sessão de peering do BGP

É possível adicionar e remover apps semelhantes do BGP em uma sessão de peering do BGP estabelecida entre um roteador e um anexo de interconexão, uma sub-rede ou uma rede. Quando você adiciona um app semelhante a uma sessão de peering do BGP, a detecção de encaminhamento bidirecional (BFD, na sigla em inglês) é ativada automaticamente no roteador de destino com um intervalo de 100 ms, uma janela de recebimento mínima de 100 ms e um multiplicador de 3.

Depois de adicionar um app semelhante à sessão de peering do BGP de destino, é possível atribuir o endereço IP do app semelhante ao pod que executa sua carga de trabalho. Para encontrar o endereço IP do app semelhante, siga as etapas em Receber informações sobre um roteador.

Adicionar um app semelhante a uma sessão de peering do BGP

Para adicionar um app semelhante a uma sessão de peering do BGP, siga as etapas desta seção.

Para concluir essa tarefa, você precisa ter o papel de administrador da rede de borda (roles/edgenetwork.admin) em seu Google Cloud projeto.

gcloud

Use o comando gcloud edge-cloud networking routers add-bgp-peer:

gcloud edge-cloud networking routers add-bgp-peer ROUTER_NAME \
    --peer-name=PEER_NAME> \
    --peer-asn=PEER_ASN \
    --peer-ipv4-range=PEER_IPv4_RANGE \
    --peer-ipv6-range=PEER_IPv6_RANGE \        
    --interface=INTERFACE_NAME \                                                       \
    --location=REGION \
    --zone=ZONE_NAME

Substitua:

  • ROUTER_NAME: o nome do roteador de destino.
  • PEER_NAME: um nome descritivo para esse app semelhante.
  • PEER_ASN: o número do sistema autônomo (ASN, na sigla em inglês) desse app semelhante. É possível especificar um valor de dois ou quatro bytes. Oferece suporte a valores de ASN públicos e particulares.
  • PEER_IPv4_RANGE: o intervalo CIDR IPv4 para esse app semelhante. Esse intervalo de endereços precisa estar na mesma sub-rede que o endereço IP ou o intervalo de endereços do anexo de interconexão, da sub-rede ou da rede associada.
  • PEER_IPv6_RANGE: o intervalo CIDR IPv6 para esse app semelhante. Esse intervalo de endereços precisa estar na mesma sub-rede que o endereço IP ou o intervalo de endereços do anexo de interconexão, da sub-rede ou da rede associada.
  • INTERFACE_NAME: o nome da interface que corresponde à sessão do BGP de destino.
  • REGION: aregião a que a zona conectada do Distributed Cloud de destino pertence. Google Cloud
  • ZONE_NAME: o nome da zona conectada do Distributed Cloud de destino.

Remover um app semelhante de uma sessão de peering do BGP

Para remover um app semelhante de uma sessão de peering do BGP, siga as etapas desta seção.

Para concluir essa tarefa, você precisa ter o papel de administrador da rede de borda (roles/edgenetwork.admin) em seu Google Cloud projeto.

gcloud

Use o comando gcloud edge-cloud networking routers remove-bgp-peer:

gcloud edge-cloud networking routers remove-bgp-peer ROUTER_NAME \
    --peer-name=PEER_NAME> \
    --location=REGION \
    --zone=ZONE_NAME

Substitua:

  • ROUTER_NAME: o nome do roteador de destino.
  • PEER_NAME: o nome do app semelhante de destino.
  • REGION: aregião a que a zona conectada do Distributed Cloud de destino pertence. Google Cloud
  • ZONE_NAME: o nome da zona conectada do Distributed Cloud de destino.

Listar roteadores

Para listar os roteadores provisionados em uma zona conectada do Distributed Cloud, siga as etapas desta seção.

Para concluir essa tarefa, você precisa ter o papel de visualizador da rede de borda (roles/edgenetwork.viewer) em seu Google Cloud projeto.

gcloud

Use o comando gcloud edge-cloud networking routers list:

gcloud edge-cloud networking routers list \
    --location=REGION \
    --zone=ZONE_NAME

Substitua:

  • REGION: aregião a que a zona conectada do Distributed Cloud de destino pertence. Google Cloud
  • ZONE_NAME: o nome da zona conectada do Distributed Cloud de destino.

API

Faça uma solicitação GET para o método projects.locations.zones.routers.list:

 GET /v1/PROJECT_ID/locations/REGION/zones/ZONE_NAME/routers?filter=FILTER&pageSize=PAGE_SIZE&orderBy=SORT_BY&pageToken=PAGE_TOKEN

Substitua:

  • PROJECT_ID: o ID doprojeto de destino. Google Cloud
  • REGION: aregião a que a zona conectada do Distributed Cloud de destino pertence. Google Cloud
  • ZONE_NAME: o nome da zona conectada do Distributed Cloud de destino.
  • FILTER: uma expressão que restringe os resultados retornados a valores específicos.
  • PAGE_SIZE: o número de resultados a serem retornados por página.
  • SORT_BY: uma lista de nomes de campos separados por vírgulas pelos quais os resultados retornados são classificados. A ordem de classificação padrão é crescente. Para a ordem de classificação decrescente, prefixe o campo desejado com ~.
  • PAGE_TOKEN: um token recebido na resposta à última solicitação de lista no campo nextPageToken na resposta. Envie esse token para receber uma página de resultados.

Receber informações sobre um roteador

Para receber informações sobre um roteador do Distributed Cloud, siga as etapas desta seção.

Para concluir essa tarefa, você precisa ter o papel de visualizador da rede de borda (roles/edgenetwork.viewer) em seu Google Cloud projeto.

gcloud

Use o comando gcloud edge-cloud networking routers describe:

gcloud edge-cloud networking routers describe ROUTER_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Substitua:

  • ROUTER_NAME: o nome do roteador de destino.
  • REGION: aregião a que a zona conectada do Distributed Cloud de destino pertence. Google Cloud
  • ZONE_NAME: o nome da zona conectada do Distributed Cloud de destino.

API

Faça uma solicitação GET para o método projects.locations.zones.routers.get:

GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/routers/ROUTER_ID

Substitua:

  • PROJECT_ID: o ID doprojeto de destino. Google Cloud
  • REGION: aregião a que a zona conectada do Distributed Cloud de destino pertence. Google Cloud
  • ZONE_NAME: o nome da zona conectada do Distributed Cloud de destino.
  • ROUTER_ID: o ID do roteador de destino.

Essa operação retorna informações detalhadas sobre o recurso, incluindo o estado de provisionamento:

  • PENDING: o provisionamento do recurso ainda não foi iniciado e ainda não foi propagado por toda a zona.
  • PROVISIONING: o recurso está sendo provisionado. Aguarde até que ele seja propagado por toda a zona.
  • RUNNING: o recurso foi provisionado e propagado por toda a zona. Ele está pronto para uso.
  • FAILED: o provisionamento do recurso não foi bem-sucedido. O recurso não foi propagado por toda a zona.

Verificar o status operacional de um roteador

Para verificar o status operacional de um roteador do Distributed Cloud, siga as etapas desta seção.

Para concluir essa tarefa, você precisa ter o papel de visualizador da rede de borda (roles/edgenetwork.viewer) em seu Google Cloud projeto.

gcloud

Use o comando gcloud edge-cloud networking routers get-status:

gcloud edge-cloud networking routers get-status ROUTER_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Substitua:

  • ROUTER_NAME: o nome do roteador de destino.
  • REGION: aregião a que a zona conectada do Distributed Cloud de destino pertence. Google Cloud
  • ZONE_NAME: o nome da zona conectada do Distributed Cloud de destino.

API

Faça uma solicitação GET para o método projects.locations.zones.routers.diagnose:

 GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/routers/ROUTER_ID:diagnose

Substitua:

  • PROJECT_ID: o ID doprojeto de destino. Google Cloud
  • REGION: aregião a que a zona conectada do Distributed Cloud de destino pertence. Google Cloud
  • ZONE_NAME: o nome da zona conectada do Distributed Cloud de destino.
  • ROUTER_ID: o ID do roteador de destino.

Excluir um roteador

Para excluir um roteador do Distributed Cloud, siga as etapas desta seção.

Para concluir essa tarefa, você precisa ter o papel de administrador da rede de borda (roles/edgenetwork.admin) em seu Google Cloud projeto.

gcloud

Use o comando gcloud edge-cloud networking routers delete:

gcloud edge-cloud networking routers delete ROUTER_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Substitua:

  • ROUTER_NAME: o nome do roteador de destino.
  • REGION: aregião a que a zona conectada do Distributed Cloud de destino pertence. Google Cloud
  • ZONE_NAME: o nome da zona conectada do Distributed Cloud de destino.

API

Faça uma solicitação DELETE para o método projects.locations.zones.routers.delete:

 DELETE /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/routers/ROUTER_ID

Substitua:

  • PROJECT_ID: o ID doprojeto de destino. Google Cloud
  • REGION: aregião a que a zona conectada do Distributed Cloud de destino pertence. Google Cloud
  • ZONE_NAME: o nome da zona conectada do Distributed Cloud de destino.
  • ROUTER_ID: o ID do roteador de destino.

A seguir