Criar e gerenciar redes

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

Os servidores do Distributed Cloud conectado são enviados com uma única rede pré-configurada, a rede padrão do Distributed Cloud. Os servidores conectados do Distributed Cloud não são compatíveis com a configuração de redes adicionais.

Para mais informações sobre as redes do Distributed Cloud, consulte Como funciona o Distributed Cloud Connected.

Lembre-se:

  • É possível criar até 100 redes por zona do Distributed Cloud.
  • Uma rede é uma rede privada virtual instanciada na zona de destino.
  • A rede é instanciada como uma função de roteamento virtual (VRF).
  • Os pacotes são roteados de forma independente dentro de uma rede.
  • Se os projetos de zona Google Cloud e de cluster Google Cloud forem diferentes, conceda permissão ao projeto de cluster Google Cloud no projeto de zona Google Cloud para permitir o acesso à API Edge Network. Para instruções, consulte Autorizar ações em clusters usando o controle de acesso baseado em papéis.

Criar uma rede

Para criar uma rede 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 networks create:

gcloud edge-cloud networking networks create NETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME \
    --mtu=MTU_SIZE

Substitua:

  • NETWORK_NAME: um nome descritivo que identifica de forma exclusiva essa rede.
  • 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.
  • MTU_SIZE: o tamanho da unidade máxima de transmissão (MTU) para essa rede. Os valores válidos são 1.500 e 9.000. Esse valor precisa corresponder ao tamanho da MTU da rede default e ser o mesmo para todas as redes.

API

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

POST /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/networks?networkId=NETWORK_ID
{
 "labels": { LABELS,
  },
 "mtu": { MTU_SIZE,
  },
}

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 de destino do Distributed Cloud.
  • NETWORK_ID: um ID exclusivo que identifica esta rede.
  • LABELS: uma lista de rótulos a serem aplicados a esse recurso de rede.
  • MTU_SIZE: o tamanho da unidade máxima de transmissão (MTU) para essa rede. Os valores válidos são 1.500 e 9.000.

Listar redes

Para listar as redes do Distributed Cloud provisionadas 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 networks list:

gcloud edge-cloud networking networks 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.networks.list:

GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/networks?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 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 uma rede

Para receber informações sobre uma rede 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 networks describe:

gcloud edge-cloud networking networks describe NETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Substitua:

  • NETWORK_NAME: o nome da 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.

API

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

GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/networks/NETWORK_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.
  • NETWORK_ID: o ID da rede de destino.

Verificar o status operacional de uma rede

Para verificar o status operacional de uma rede 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 networks get-status:

gcloud edge-cloud networking networks get-status NETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Substitua:

  • NETWORK_NAME: o nome da 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.

API

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

 GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/networks/NETWORK_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.
  • NETWORK_ID: o ID da rede de destino.

Excluir uma rede

Para excluir uma rede 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 networks delete:

gcloud edge-cloud networking networks delete NETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Substitua:

  • NETWORK_NAME: o nome da 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.

API

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

 DELETE /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/networks/NETWORK_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.
  • NETWORK_ID: o ID da rede de destino.

A seguir