Criar uma rede do VMware Engine

Neste documento, descrevemos como criar uma rede do VMware Engine Standard usando o portal do VMware Engine, a CLI gcloud ou a API. É possível criar várias redes do VMware Engine para isolar nuvens privadas e definir peerings de rede VPC exclusivos. As redes do VMware Engine processam conexões de e para nuvens privadas de acordo com uma política de rede definida separadamente.

Observação: os projetos criados antes de novembro de 2023 têm redes legadas do VMware Engine que não estão mais disponíveis em projetos mais recentes. O Google criou essas redes automaticamente para você. Assim, essas etapas se aplicam apenas a redes padrão. Para mais informações sobre redes legadas e padrão, consulte a Visão geral da rede.

Antes de começar

Google Cloud CLI e requisitos da API

Para usar a ferramenta de linha de comando gcloud ou a API para gerenciar os recursos do VMware Engine, recomendamos configurar as ferramentas conforme descrito abaixo.

gcloud

1. Defina o ID do projeto padrão:

   gcloud config set project PROJECT_ID
   

2. Defina uma região e uma zona padrão.

   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 SDK do Cloud.

API

Os exemplos de API neste conjunto de documentação usam a ferramenta de linha de comando cURL para consultar a API. Um token de acesso válido é necessário como parte da solicitação cURL. Há muitas maneiras de conseguir um token de acesso válido. As etapas a seguir usam a ferramenta gcloud para gerar um token de acesso:

1. Faça login no Google Cloud:

   gcloud auth login
   

2. Gerar token de acesso e exportar para TOKEN:

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

3. Verifique se o TOKEN está definido corretamente:

   echo $TOKEN
   

Use agora o token de autorização nas solicitações para a API. 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 do VMware Engine para se comunicar com a API. Para usar essa abordagem, a biblioteca precisa estar instalada e o Application Default Credentials precisa estar configurado.

1. Faça o download e instale a biblioteca Python:

   pip install google-cloud-vmwareengine
   

2. Execute os comandos no shell para configurar as informações do ADC:

   gcloud auth application-default login
   

   Ou use um arquivo de chave da conta de serviço:

   export GOOGLE_APPLICATION_CREDENTIALS="FILE_PATH"
   

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

Criar uma rede do VMware Engine

Crie uma rede do VMware Engine usando o console do Google Cloud, a CLI gcloud ou a API VMware Engine:

Console

Para criar uma rede do VMware Engine usando o VMware Engine:

1. No console do Google Cloud, acesse a página Redes do VMware Engine.

   Acesse as redes do VMware Engine

2. Clique em Selecionar um projeto e escolha a organização, a pasta ou o projeto em que você quer criar a rede do VMware Engine.

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

4. Digite um nome de rede do VMware Engine.

5. Insira uma descrição para a rede, por exemplo, "My standard VEN 1", e clique em Criar.

6. Opcional: confirme a criação da rede navegando até o item de menu Redes do VMware Engine. Todas as redes do VMware Engine estão listadas na tabela nesta página.

A lista a seguir descreve cada campo durante a criação da política mais detalhadamente:

• Nome: identificador exclusivo permanente da rede do VMware Engine.
• Descrição: informações adicionais que ficam visíveis na página de detalhes da rede do VMware Engine.
• Tipo de rede: identificador de tipo de rede usado para dar suporte a casos de uso de rede e implantações de nuvem privada legada.

• Região: depende se você está usando as redes padrão do VMware Engine ou legado do VMware Engine.

  • Para redes legadas, essa é a região em que a rede tem conectividade.
  • Para redes padrão, este campo é sempre definido como global.

gcloud

Para criar uma rede do VMware Engine usando a CLI gcloud, faça o seguinte:

1. Execute o comando gcloud vmware networks create:

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

   Substitua:

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

2. Opcional: se você quiser listar 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 usando a API VMware Engine, faça o seguinte:

1. Para criar uma rede do VMware Engine, faça uma solicitação POST:

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

   Substitua:

   • PROJECT_ID: o ID do projeto em que você quer criar a rede.
   • NETWORK_ID: o ID da sua rede do VMware Engine.
   • DESCRIPTION: uma descrição para esta rede.

2. Opcional: para listar todas as redes do VMware Engine e confirmar a criação da nova rede, faça uma solicitação GET. Substitua PROJECT_ID pelo ID do projeto em que a rede está localizada.

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

Atualizar uma rede do VMware Engine

Atualize uma rede do VMware Engine usando o console do Google Cloud, a CLI gcloud ou a API VMware Engine:

Console

1. No console do Google Cloud, acesse a página Redes do VMware Engine.

   Acesse as redes do VMware Engine

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

3. Clique no nome da rede que você quer atualizar.

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

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

gcloud

Para atualizar uma rede do VMware Engine usando a 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:

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

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

   gcloud vmware networks describe NETWORK_ID

API

Para atualizar uma rede do VMware Engine usando a API VMware Engine, faça o seguinte:

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

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

   Substitua:

   • PROJECT_ID: o ID do projeto em que a rede está localizada.
   • LOCATION: o local da rede, seja global para redes padrão ou a região para redes legadas.
   • NETWORK_ID: o ID da sua rede do VMware Engine.
   • DESCRIPTION: uma descrição atualizada para esta rede.

2. Opcional: se você quiser conferir o atributo atualizado, faça uma solicitação GET:

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

A seguir

• Receber credenciais de login para dispositivos de gerenciamento.
• Gerenciar recursos e atividades de nuvem privada.