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.

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 a documentação de referência do SDK 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 é exigido como parte do cURL solicitação. Há muitas maneiras de se obter um token de acesso válido: o seguinte As etapas usam a ferramenta gcloud para gerar um token de acesso:

  1. Faça login no Google Cloud:

    gcloud auth login
    
  2. Gere o token de acesso e exporte para o TOKEN:

    export TOKEN=`gcloud auth print-access-token`
    
  3. Verifique se o TOKEN está configurado 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.

    Acessar redes do VMware Engine

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

  3. Digite um nome de rede do VMware Engine.

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

  5. 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 nome da rede para esta solicitação
    • DESCRIPTION: uma descrição desta 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 desta solicitação;
    • NETWORK_ID: o nome da rede para esta solicitação.
    • 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 para esta solicitação.

    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.

    Acessar redes do VMware Engine

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

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

  4. 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 nome da rede para esta solicitação.
    • 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

    Substitua NETWORK_ID pelo nome da rede dessa solicitação.

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 projeto para esta solicitação
    • LOCATION: o local da rede, seja global para redes legadas ou a região para redes padrão
    • NETWORK_ID: o nome da rede para esta solicitação
    • 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