Criar e gerenciar roteadores

Nesta página, descrevemos como criar e gerenciar recursos de roteador conectado do Google Distributed Cloud em uma zona do Distributed Cloud.

Essa funcionalidade está disponível apenas em racks conectados do Distributed Cloud. Os servidores conectados do Distributed Cloud não são compatíveis com recursos de roteador.

Para mais informações sobre os roteadores do Distributed Cloud, consulte Como o Distributed Cloud Connected 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 nesta seção.

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

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 atendida por este roteador.
  • REGION: a Google Cloud região a que pertence a zona de destino do Distributed Cloud Connected.
  • ZONE_NAME: o nome da zona conectada de destino do Distributed Cloud.
  • ASN: o número do sistema autônomo (ASN) deste roteador. É possível especificar um valor de dois ou quatro bytes. Aceita valores de ASN públicos e particulares.

API

Faça uma solicitação POST ao 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 do projeto Google Cloud de destino.
  • REGION: a região Google Cloud a que a zona conectada do Distributed Cloud de destino pertence.
  • ZONE_NAME: o nome da zona conectada de destino do Distributed Cloud.
  • ROUTER_ID: um ID que identifica exclusivamente este roteador.
  • LABELS: uma lista de rótulos a serem aplicados a esse recurso de roteador.
  • NETWORK_NAME: o nome da rede atendida por este roteador.
  • ASN: o número do sistema autônomo (ASN) deste roteador. É possível especificar um valor de dois ou quatro bytes. Aceita 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 Border Gateway Protocol (BGP):

Uma sessão de peering do BGP é estabelecida adicionando 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 sentido norte

Para estabelecer uma sessão de peering de sentido norte em um roteador com um anexo de interconexão, siga as etapas desta seção. A conexão de interconexão de destino precisa estar associada ao roteador de destino.

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

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: a Google Cloud região a que pertence a zona de destino do Distributed Cloud Connected.
  • ZONE_NAME: o nome da zona conectada de destino do Distributed Cloud.

Estabelecer uma sessão de peering southbound

Para estabelecer uma sessão de peering southbound 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) no projeto Google Cloud .

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: a Google Cloud região a que pertence a zona de destino do Distributed Cloud Connected.
  • ZONE_NAME: o nome da zona conectada de destino do Distributed Cloud.

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) no projeto Google Cloud .

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 da interface de loopback, separados por vírgula.
  • REGION: a Google Cloud região a que pertence a zona de destino do Distributed Cloud Connected.
  • ZONE_NAME: o nome da zona conectada de destino do Distributed Cloud.

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, exclua 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) no projeto Google Cloud .

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: a Google Cloud região a que pertence a zona de destino do Distributed Cloud Connected.
  • ZONE_NAME: o nome da zona conectada de destino do Distributed Cloud.

Configurar peers em uma sessão de peering do BGP

É possível adicionar e remover pares 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 peer a uma sessão de peering do BGP, a detecção de encaminhamento bidirecional (BFD) é 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 peer à sessão de peering BGP de destino, é possível atribuir o endereço IP do peer ao pod que executa sua carga de trabalho. Para encontrar o endereço IP do peer, siga as etapas em Receber informações sobre um roteador.

Adicionar um peer a uma sessão de peering do BGP

Para adicionar um peering 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) no projeto Google Cloud .

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 este peer.
  • PEER_ASN: o número do sistema autônomo (ASN, na sigla em inglês) para esse par. É possível especificar um valor de dois ou quatro bytes. Aceita valores de ASN públicos e particulares.
  • PEER_IPv4_RANGE: o intervalo CIDR IPv4 para este peer. 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 este peer. 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: a Google Cloud região a que pertence a zona de destino do Distributed Cloud Connected.
  • ZONE_NAME: o nome da zona conectada de destino do Distributed Cloud.

Remover um peer de uma sessão de peering do BGP

Para remover um peer de uma sessão de peering do BGP, siga as etapas nesta seção.

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

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 peering de destino.
  • REGION: a região Google Cloud a que pertence a zona conectada de destino do Distributed Cloud.
  • ZONE_NAME: o nome da zona conectada de destino do Distributed Cloud.

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 de rede de borda (roles/edgenetwork.viewer) no seu projeto Google Cloud .

gcloud

Use o comando gcloud edge-cloud networking routers list:

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

Substitua:

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

API

Faça uma solicitação GET ao 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 do projeto Google Cloud de destino.
  • REGION: a Google Cloud região a que pertence a zona de destino do Distributed Cloud Connected.
  • ZONE_NAME: o nome da zona conectada de destino do Distributed Cloud.
  • 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 delimitada por vírgulas de nomes de campos pelos quais os resultados retornados são classificados. A ordem de classificação padrão é crescente. Para classificar em ordem decrescente, adicione o prefixo ~ ao campo desejado.
  • PAGE_TOKEN: um token recebido na resposta à última solicitação de lista no campo nextPageToken da resposta. Envie esse token para receber uma página de resultados.

Receber informações sobre um roteador

Para 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 de rede de borda (roles/edgenetwork.viewer) no seu projeto Google Cloud .

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: a Google Cloud região a que pertence a zona de destino do Distributed Cloud Connected.
  • ZONE_NAME: o nome da zona conectada de destino do Distributed Cloud.

API

Faça uma solicitação GET ao 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 do projeto Google Cloud de destino.
  • REGION: a Google Cloud região a que pertence a zona de destino do Distributed Cloud Connected.
  • ZONE_NAME: o nome da zona conectada de destino do Distributed Cloud.
  • 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 recurso ainda não começou o provisionamento 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 com sucesso em toda a zona e está pronto para uso.
  • FAILED: o provisionamento do recurso não foi concluído. Ele 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 de rede de borda (roles/edgenetwork.viewer) no seu projeto Google Cloud .

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: a Google Cloud região a que pertence a zona de destino do Distributed Cloud Connected.
  • ZONE_NAME: o nome da zona conectada de destino do Distributed Cloud.

API

Faça uma solicitação GET ao 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 do projeto Google Cloud de destino.
  • REGION: a Google Cloud região a que pertence a zona de destino do Distributed Cloud Connected.
  • ZONE_NAME: o nome da zona conectada de destino do Distributed Cloud.
  • ROUTER_ID: o ID do roteador de destino.

Excluir um roteador

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

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

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: a Google Cloud região a que pertence a zona de destino do Distributed Cloud Connected.
  • ZONE_NAME: o nome da zona conectada de destino do Distributed Cloud.

API

Faça uma solicitação DELETE ao 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 do projeto Google Cloud de destino.
  • REGION: a Google Cloud região a que pertence a zona de destino do Distributed Cloud Connected.
  • ZONE_NAME: o nome da zona conectada de destino do Distributed Cloud.
  • ROUTER_ID: o ID do roteador de destino.

A seguir