Crie uma rede do VMware Engine

Este documento descreve como criar uma rede do VMware Engine padrão através do portal do VMware Engine, da CLI gcloud ou da API. Pode criar várias redes do VMware Engine para isolar nuvens privadas e definir intercâmbios de redes VPC únicos. As redes do VMware Engine processam as ligações de e para nuvens privadas de acordo com uma política de rede que define separadamente.

Nota: os projetos criados antes de novembro de 2023 têm redes do VMware Engine antigas que já não estão disponíveis em projetos mais recentes. A Google criou automaticamente estas redes para si. Como tal, estes passos só são aplicáveis a redes padrão. Para mais informações sobre redes padrão e antigas, reveja a Vista geral da rede.

Antes de começar

Requisitos da API e da CLI Google Cloud

Para usar a ferramenta de linha de comandos gcloud ou a API para gerir os recursos do VMware Engine, recomendamos que configure as ferramentas conforme descrito abaixo.

gcloud

1. Defina o ID do projeto predefinido:

   gcloud config set project PROJECT_ID
   

2. Defina uma região e uma zona predefinidas:

   gcloud config set compute/region REGION
   

   gcloud config set compute/zone ZONE
   

Para mais informações sobre a ferramenta gcloud vmware, consulte os documentos de referência do Cloud SDK.

API

Os exemplos de API neste conjunto de documentação usam a ferramenta de linha de comandos cURL para consultar a API. É necessária uma chave de acesso válida como parte do pedido.cURL Existem várias formas de obter um token de acesso válido. Os passos seguintes usam a ferramenta gcloud para gerar um token de acesso:

1. Inicie sessão em Google Cloud:

   gcloud auth login
   

2. Gere o token de acesso e exporte-o para TOKEN:

   export TOKEN=`gcloud auth print-access-token`
   

3. Verifique se o TOKEN está definido corretamente:

   echo $TOKEN
   

Agora, use o token de autorização nos seus pedidos à API. Por exemplo:

curl -X GET -H "Authorization: Bearer \"$TOKEN\"" -H "Content-Type: application/json; charset=utf-8" https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations

Python

Os exemplos de código Python nesta documentação usam a biblioteca VMware Engine para comunicar com a API. Para poder usar esta abordagem, a biblioteca tem de estar instalada e as credenciais predefinidas da aplicação devem estar configuradas.

1. Transfira e instale a biblioteca Python:

   pip install google-cloud-vmwareengine
   

2. Configure as informações do ADC executando esses comandos na shell:

   gcloud auth application-default login
   

   Em alternativa, use um ficheiro de chave da conta de serviço:

   export GOOGLE_APPLICATION_CREDENTIALS="FILE_PATH"
   

Para mais informações sobre a biblioteca, visite a página de referência ou veja exemplos de código no GitHub.

Crie uma rede do VMware Engine

Crie uma rede do VMware Engine através da Google Cloud consola, da CLI gcloud ou da API VMware Engine:

Consola

Para criar uma rede do VMware Engine através do VMware Engine:

1. Na Google Cloud consola, aceda à página Redes do VMware Engine.

   Aceda às redes do VMware Engine

2. Clique em Selecionar um projeto e, de seguida, selecione a organização, a pasta ou o projeto onde quer criar a rede do VMware Engine.

3. Clique em Criar. É aberto um formulário de criação de rede do VMware Engine.

4. Introduza um nome de rede do VMware Engine.

5. Introduza uma descrição para a rede, por exemplo, "O meu VEN padrão 1", e clique em Criar.

6. Opcional: confirme a criação da sua rede navegando para o item de menu Redes do VMware Engine. Todas as redes do VMware Engine são apresentadas na tabela desta página.

A lista seguinte descreve cada campo durante a criação da rede mais detalhadamente:

• Nome: identificador exclusivo permanente da rede do VMware Engine.
• Descrição: informações adicionais visíveis na página de detalhes da rede do VMware Engine.
• Tipo de rede: identificador do tipo de rede usado para suportar exemplos de utilização de redes e implementações de nuvem privada padrão.

• Região: isto depende de estar a usar redes do VMware Engine padrão ou do VMware Engine antigo.

  • Para redes antigas, esta é a região onde a rede tem conetividade.
  • Para redes padrão, este campo está sempre definido como global.

gcloud

Para criar uma rede do VMware Engine através da CLI gcloud:

1. Executar o comando gcloud vmware networks create:

   gcloud vmware networks create NETWORK_ID \
     --type=STANDARD \
     --description="DESCRIPTION"

   Substitua o seguinte:

   • NETWORK_ID: o ID da sua rede do VMware Engine.
   • DESCRIPTION: uma descrição desta rede.

2. Opcional: se quiser apresentar uma lista de todas as redes do VMware Engine para confirmar a criação da nova rede, use o comando gcloud vmware networks list:

   gcloud vmware networks list \
     --location=global

API

Para criar uma rede do VMware Engine através da API VMware Engine, faça o seguinte:

1. Para criar uma rede do VMware Engine, faça um pedido POST:

   POST "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/vmwareEngineNetworks?vmware_engine_network_id=NETWORKD_ID"
   
   '{
     "type": "standard",
     "description": "DESCRIPTION"
   }'

   Substitua o seguinte:

   • PROJECT_ID: o ID do projeto onde quer criar a rede.
   • NETWORK_ID: o ID da sua rede do VMware Engine.
   • DESCRIPTION: uma descrição desta rede.

2. Opcional: para listar todas as redes do VMware Engine para confirmar a criação da nova rede, faça um pedido GET. Substitua PROJECT_ID pelo ID do projeto onde a rede se encontra.

   GET https://vmwareengine.googleapis.com/v1/projects//locations/global/vmwareEngineNetworks

Atualize uma rede do VMware Engine

Atualize uma rede do VMware Engine através da Google Cloud consola, da CLI gcloud ou da API VMware Engine:

Consola

1. Na Google Cloud consola, aceda à página Redes do VMware Engine.

   Aceda às redes do VMware Engine

2. Clique em Selecionar um projeto e, de seguida, selecione a organização, a pasta ou o projeto que contém a rede do VMware Engine que quer atualizar.

3. Clique no nome da rede que quer atualizar.

4. Na página de detalhes da rede, edite a descrição e, de seguida, clique em Guardar.

5. Opcional: para ver a descrição atualizada, navegue até ao item de menu Redes do VMware Engine e clique na rede para ver os detalhes.

gcloud

Para atualizar uma rede do VMware Engine através da CLI gcloud, faça o seguinte:

1. Atualize a descrição de uma rede do VMware Engine executando o comando gcloud vmware networks update:

   gcloud vmware networks update NETWORK_ID \
     --description='DESCRIPTION'

   Substitua o seguinte:

   • NETWORK_ID: o ID da sua rede do VMware Engine.
   • DESCRIPTION: uma descrição atualizada desta rede.

2. Opcional: se quiser ver o atributo atualizado, use o comando gcloud vmware networks describe:

   gcloud vmware networks describe NETWORK_ID

API

Para atualizar uma rede do VMware Engine através da API VMware Engine, faça o seguinte:

1. Para atualizar a descrição de uma rede do VMware Engine, faça um pedido PATCH:

   PATCH "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/vmwareEngineNetworks/NETWORK_ID?update_mask=description"
   
   '{
     "description":"DESCRIPTION"
   }'
   

   Substitua o seguinte:

   • PROJECT_ID: o ID do projeto onde a rede está localizada.
   • LOCATION: a localização da rede, global para redes padrão ou a região para redes antigas.
   • NETWORK_ID: o ID da sua rede do VMware Engine.
   • DESCRIPTION: uma descrição atualizada desta rede.

2. Opcional: se quiser ver o atributo atualizado, faça um pedido GET:

   GET "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/vmwareEngineNetworks/NETWORK_ID"

O que se segue?

• Obtenha credenciais de início de sessão para dispositivos de gestão.
• Faça a gestão dos seus recursos e atividade na nuvem privada.