Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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 de nó único contêm apenas um nó e um cluster. É 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

Defina o ID do projeto padrão:
```
gcloud config set project PROJECT_ID
```

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:

Faça login em Google Cloud:
```
gcloud auth login
```

Gere o token de acesso e exporte para TOKEN:

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

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.

Faça o download e instale a biblioteca Python:
```
pip install google-cloud-vmwareengine
```
Configure as informações do ADC executando esse comando 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 exemplos de código no GitHub.

Antes de começar

Crie uma rede do VMware Engine, caso ainda não tenha feito isso.

Criar uma nuvem privada de nó único

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

Console

No Google Cloud console do, acesse a página Nuvens privadas.

Acessar nuvens privadas
Clique em Selecionar um projeto e selecione a organização, a pasta ou o projeto
em que você quer criar a nuvem privada de nó único.
Clique em Criar.
Selecione Nuvem privada padrão.
Selecione um local em que você quer que a nuvem privada seja implantada.
Selecione o tipo de nó para o cluster principal.
Selecione Único nó para criar uma nuvem privada com um único nó.
Preencha os demais detalhes da nuvem privada e clique em Salvar.

gcloud

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

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
```
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].
```

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

Opcional: se você quiser verificar os detalhes da nuvem privada, execute o gcloud vmware private-clouds describe comando:
```
gcloud vmware private-clouds describe PRIVATE_CLOUD_ID \
   --location=ZONE
```

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

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 para esta solicitação
REGION: a região dessa nuvem privada
CLUSTER_ID: o ID do cluster para essa solicitação

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.
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

Receba as credenciais do vCenter e do NSX, 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 Google Cloud console.

A seguir

Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.

Última atualização 2026-07-19 UTC.