Criar uma nuvem privada de nó único do VMware Engine

Neste documento, descrevemos como criar uma nuvem privada de nó único. As nuvens privadas com um único nó ajudam você a dar os primeiros passos na experiência do Google Cloud VMware Engine com o uso de não produção, como pilotos e avaliações de prova de conceito. As nuvens privadas com um único nó contêm apenas um nó e um cluster, têm limite de tempo e são removidas automaticamente após 60 dias. É possível expandir sua nuvem privada com um único nó até três nós a qualquer momento para convertê-la em uma nuvem privada padrão.

Consulte Nuvens privadas de nó único para informações conceituais sobre nuvens privadas de nó único.

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 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. Gere o token de acesso e exporte para o 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. Configure as informações do ADC executando estes comandos no shell:

    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.

Antes de começar

Criar uma nuvem privada de nó único

Crie uma nuvem privada de nó único com as instruções a seguir.

Console

  1. Vá para o Console do Google Cloud.
  2. Na página Recursos, clique em Criar nuvem privada.
  3. Selecione Nuvem privada padrão.
  4. Selecione um local em que você quer implantar a nuvem privada.
  5. Selecione o tipo de nó para seu cluster principal.
  6. Selecione Único nó para criar uma nuvem privada com um único nó.
  7. Preencha os demais detalhes da nuvem privada e clique em Salvar.

gcloud

Para criar uma nuvem privada com um único nó pela gcloud CLI:

  1. Opcional: se você não souber os nomes das regiões e zonas disponíveis para seu projeto, execute o comando gcloud vmware locations list para listá-los:

    gcloud vmware locations list

  2. Para criar uma nuvem privada com um único nó, que expira após 60 dias, use o comando gcloud vmware private-clouds create:

    gcloud vmware private-clouds create PRIVATE_CLOUD_ID \
   --description= "" \
   --location=ZONE \
   --cluster="CLUSTER_ID" \
   --node-type-config=type=standard-72, count=1 \
   --management-range=IP_ADDRESS \
   --vmware-engine-network="REGION" \
   --type=TIME_LIMITED

    Substitua:

    • PRIVATE_CLOUD_ID: o nome dessa nuvem privada.
    • CLUSTER_ID: o ID do cluster para essa solicitação
    • ZONE: a zona desta nuvem privada
    • IP_ADDRESS: o endereço IP e o intervalo dessa nuvem privada. Por exemplo, 192.168.1.0/24.
    • REGION: a região dessa nuvem privada

    Exemplo de saída:

    Create in progress for private cloud [projects/PROJECT_ID/locations/ZONE/operations/OPERATION_ID].

  3. Opcional: se você quiser verificar o status da criação da nuvem privada, use os comandos gcloud vmware operations describe e gcloud vmware private-clouds list.

    gcloud vmware operations describe OPERATION_ID \
   --location=ZONE

    gcloud vmware private-clouds list \
   --location=ZONE

    O resultado será assim:

    NAME                  PROJECT       LOCATION  CREATE_TIME STATE         VCENTER_FQDN
PRIVATE_CLOUD_ID      PROJECT_ID    ZONE      2023-03-01T13:08:21.507Z  CREATING VCENTER_FQDN

  4. Opcional: se você quiser verificar os detalhes da nuvem privada, execute o comando gcloud vmware private-clouds describe:

    gcloud vmware private-clouds describe PRIVATE_CLOUD_ID \
   --location=ZONE

  5. Execute os comandos gcloud vmware private-clouds credentials describe para receber as credenciais do vCenter e do NSX-T, respectivamente:

    gcloud vmware private-clouds vcenter credentials describe PRIVATE_CLOUD_ID \
   --location=ZONE

    gcloud vmware private-clouds nsx credentials describe PRIVATE_CLOUD_ID \
   --location=ZONE

REST

Para criar uma nuvem privada de nó único usando a API VMware Engine, faça o seguinte:

  1. Crie uma nuvem privada de nó único (expira depois de 60 dias) fazendo uma solicitação POST:

    POST https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds?private_cloud_id=PRIVATE_CLOUD_ID

{
 "description": "my private cloud",
 "network_config": {
   "vmware_engine_network": "projects/PROJECT_ID/locations/REGION/vmwareEngineNetworks/REGION-default",
   "management_cidr": "192.168.0.0/24"
 },
 "management_cluster": {
   "cluster_id": "CLUSTER_ID",
   "node_type_configs": {
     "standard-72": {
       "node_count": 1
     }
   }
 },
 "type": "TIME_LIMITED"
}

    Substitua:

    • PROJECT_ID: o projeto para esta solicitação
    • ZONE: a zona desta nuvem privada
    • PRIVATE_CLOUD_ID: o nome da nuvem privada da solicitação.
    • REGION: a região dessa nuvem privada
    • CLUSTER_ID: o ID do cluster para essa solicitação

  2. Opcional: verifique o status da criação da nuvem privada (pode levar até duas horas) fazendo uma solicitação POST à operação:

    POST "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/operations/OPERATION_ID

    Liste as nuvens privadas em uma zona fazendo uma solicitação POST:

    POST "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds

    Substitua:

    • PROJECT_ID: o ID desta solicitação.
    • ZONE: a zona desta nuvem privada
    • OPERATION_ID: o ID da operação dessa nuvem privada.

  3. Opcional: receba detalhes da nuvem privada fazendo uma solicitação GET:

    GET https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID
    • PROJECT_ID: o ID deste projeto.
    • PRIVATE_CLOUD_ID: o ID dessa nuvem privada.
    • ZONE: a zona desta nuvem privada

  4. Receba as credenciais do vCenter e do NSX-T, respectivamente, fazendo solicitações GET separadas:

    GET https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID:showVcenterCredentials

    GET https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID:showNsxCredentials

Leva de 30 minutos a 2 horas para o VMware Engine criar sua nuvem privada e disponibilizá-la para acesso no console do Google Cloud.

A seguir