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

Este documento descreve como criar uma nuvem privada de nó único. As nuvens privadas de nó único ajudam a começar a usar o Google Cloud VMware Engine com a utilização não relacionada com a produção, como testes-piloto e avaliações de provas de conceito. As nuvens privadas de nó único contêm apenas um nó e um cluster. Pode expandir a sua nuvem privada de nó único para três nós em qualquer altura para a converter numa nuvem privada padrão.

Consulte o artigo Nuvens privadas de nó único para ver informações conceptuais sobre nuvens privadas de nó único.

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.

Antes de começar

Crie uma nuvem privada de nó único

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

Consola

  1. Na Google Cloud consola, aceda à página Nuvens privadas.

    Aceda a Nuvens privadas

  2. Clique em Selecionar um projeto e, em seguida, selecione a organização, a pasta ou o projeto
    onde quer criar a nuvem privada de nó único.

  3. Clique em Criar.

  4. Selecione Nuvem privada padrão.

  5. Selecione uma localização onde quer implementar a nuvem privada.

  6. Selecione o tipo de nó para o cluster principal.

  7. Selecione Nó único para criar uma nuvem privada de nó único.

  8. Preencha os restantes detalhes da sua nuvem privada e clique em Guardar.

gcloud

Para criar uma nuvem privada de nó único através da CLI gcloud:

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

    gcloud vmware locations list

  2. Para criar uma nuvem privada de nó único, 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 o seguinte:

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

    Exemplo de resultado:

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

  3. Opcional: se quiser verificar o estado 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 é semelhante ao seguinte:

    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 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 o comando gcloud vmware private-clouds credentials describe para obter as credenciais do vCenter e do NSX, respetivamente:

    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 com a API VMware Engine, faça o seguinte:

  1. Crie uma nuvem privada de nó único (expira após 60 dias) fazendo um pedido 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 o seguinte:

    • PROJECT_ID: o projeto para este pedido
    • ZONE: a zona desta nuvem privada
    • PRIVATE_CLOUD_ID: o nome da nuvem privada para este pedido
    • REGION: a região desta nuvem privada
    • CLUSTER_ID: o ID do cluster para este pedido

  2. Opcional: verifique o estado da criação da nuvem privada (pode demorar até duas horas) fazendo um pedido POST à operação:

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

    Liste as nuvens privadas numa zona fazendo um pedido POST:

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

    Substitua o seguinte:

    • PROJECT_ID: o ID deste pedido
    • ZONE: a zona desta nuvem privada
    • OPERATION_ID: o ID da operação para esta nuvem privada

  3. Opcional: obtenha detalhes da nuvem privada fazendo um pedido 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 desta nuvem privada
    • ZONE: a zona desta nuvem privada

  4. Obtenha as credenciais do vCenter e do NSX, respetivamente, fazendo pedidos GET separados:

    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

O VMware Engine demora aproximadamente 30 minutos a 2 horas a criar a sua nuvem privada e a disponibilizá-la para acesso a partir daGoogle Cloud consola.

O que se segue?