Gerenciar recursos e atividades de nuvem privada
Depois de criar uma nuvem privada, é possível ver informações detalhadas sobre ela, gerenciar os recursos e a atividade e acessar os dispositivos de gerenciamento de VMware. Cada nuvem privada contém um ou mais clusters, e cada cluster contém nós que correspondem a hosts ESXi.
Para conferir uma lista das suas nuvens privadas, acesse a página de resumo dos recursos:
No console do Google Cloud, acesse a página Nuvens privadas.
Selecione a nuvem particular que você quer gerenciar na lista de nuvens privadas.
gcloud e requisitos de 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 no Google Cloud:
gcloud auth login
Gerar token de acesso e exportar 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
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.
Verificar a versão do layout de endereço IP
As nuvens privadas criadas após novembro de 2022 adotam as alocações de sub-rede do layout de endereço IP (plano IP) versão 2.0. Quase todas as nuvens privadas criadas antes de novembro de 2022 adotam as alocações de sub-rede do plano de IP versão 1.0.
Para saber qual versão sua nuvem privada adota, siga estas etapas:
No console do Google Cloud, acesse a página Nuvens privadas.
Selecione o nome da nuvem privada que você quer verificar. O número da versão é exibido com Versão do plano de IP.
Como visualizar um resumo privado na nuvem
O resumo fornece informações sobre a nuvem privada, incluindo nome, número de clusters do vSphere, número de nós, local, estado operacional e muito mais. A página de resumo inclui os servidores DNS implantados na nuvem privada.
Na página de resumo da nuvem particular, é possível realizar as seguintes ações:
- Iniciar cliente do vSphere. Acesse o vCenter para esta nuvem privada.
- Adicionar nós. Adicione nós a esta nuvem privada.
- Adicionar cluster. Adicione um novo cluster a esta nuvem privada.
- Criar um cluster com configuração de contagem de núcleos personalizados. Crie um novo cluster com configuração de contagem de núcleos personalizada
- Remover nós. Remover nós desta nuvem privada.
- Exclua a nuvem privada. Exclua uma nuvem privada, incluindo todas as VMs, a configuração do vCenter e os dados. Antes da exclusão, faça backup de todos os sistemas e dados.
- Alterar privilégios do vSphere. Coloque seus privilégios para realizar uma tarefa específica nessa nuvem privada.
- Copiar endereços IP de servidores DNS. Receba uma lista de servidores DNS na sua nuvem privada. É possível configurar o encaminhamento de DNS de servidores DNS locais para servidores DNS de nuvem privada. Para mais informações sobre encaminhamento de DNS, consulte Como configurar o DNS para resolução de nomes para acesso do vCenter de nuvem particular a partir de estações de trabalho locais.
Como adicionar nós a uma nuvem privada
Uma nuvem privada consiste em um ou mais clusters do vSphere, cada um contendo vários nós. Ao adicionar nós a uma nuvem particular, você adiciona nós ao cluster atual ou cria um novo cluster. Uma nuvem privada pode ser expandida várias vezes, desde que você esteja dentro dos limites gerais de nós. Toda vez que você expande uma nuvem privada, você adiciona ao cluster atual ou cria um novo.
Como parte da nova configuração do cluster, o Google configura a infraestrutura da VMware. As configurações incluem as configurações de armazenamento para grupos de discos vSAN, alta disponibilidade de VMware e programador de recursos distribuídos (DRS).
Console
Para adicionar nós a uma nuvem privada usando o console do Google Cloud, siga estas etapas:
No console do Google Cloud, acesse a página Nuvens privadas.
Na página de resumo de nuvens privadas, clique em Adicionar nós.
Escolha se você quer adicionar nós a um dos clusters atuais ou criar um novo cluster do vSphere. A medida que você faz alterações, as informações resumidas na página são atualizadas.
Para adicionar nós a um dos clusters, selecione Adicionar nós a atuais. Selecione o cluster que você quer expandir e insira o número de nós a serem adicionados.
Para adicionar um novo cluster, selecione Criar novo. Em seguida, forneça os seguintes detalhes:
- Digite um nome para o cluster.
- Selecione um data center atual do vSphere ou insira um nome para criar um novo data center.
- Selecione o número de nós. Cada novo cluster precisa ter pelo menos três nós.
- Opcional: clique no botão Personalizar núcleos se você quiser reduzir o número de núcleos disponíveis para cada nó no cluster de gerenciamento. Para mais detalhes, consulte Contagens de núcleo personalizados.
Selecione Enviar.
gcloud
O comando Atualizar permite alterar a contagem total de nós do cluster. Esse comando requer o nome do cluster e da nuvem privada.
Liste os clusters inserindo o comando
gcloud vmware private-clouds clusters list
:gcloud vmware private-clouds clusters list \ --private-cloud=PRIVATE_CLOUD_ID \ --location=ZONE
Substitua:
PRIVATE_CLOUD_ID
: o nome da nuvem privadaZONE
: a zona da nuvem privada
Para atualizar o cluster, execute o comando
gcloud vmware private-clouds clusters update
:gcloud vmware private-clouds clusters update CLUSTER_ID \ --location=ZONE \ --private-cloud=PRIVATE_CLOUD_ID \ --update-nodes-config=type=NODE_TYPE,count=NODE_COUNT
Substitua:
CLUSTER_ID
: o ID do cluster a ser atualizado nessa nuvem privada.ZONE
: a zona da nuvem privada.PRIVATE_CLOUD_ID
: o ID da nuvem privada da solicitação.NODE_TYPE
: o tipo de nó. Para mais informações, consulte Tipos de nó.NODE_COUNT
: o número de nós a serem adicionados.
API
A API de atualização permite alterar a contagem total de nós do cluster. Esse comando requer o nome do cluster e da nuvem privada.
Liste os clusters fazendo uma solicitação
GET
:curl -L -X GET -H "Authorization: Bearer TOKEN" "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID/clusters"
Substitua:
PROJECT_ID
: o ID do projeto desta solicitaçãoZONE
: a zona da nuvem privadaPRIVATE_CLOUD_ID
: o ID da nuvem privada da solicitação
Atualize os clusters fazendo uma solicitação
PATCH
. Por exemplo, o comando a seguir atualiza o cluster para o tipo de nóstandard-72
.curl -L -X PATCH -H "Authorization: Bearer TOKEN" \ -H "Content-Type: application/json" \ "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID/clusters/CLUSTER_ID?updateMask=node_type_configs.*.node_count" \ -d '{ "nodeTypeConfigs": { "standard-72" : { "nodeCount": NODE_COUNT } } }'
Substitua:
PROJECT_ID
: o ID do projeto desta solicitaçãoZONE
: a zona da nuvem privadaPRIVATE_CLOUD_ID
: o ID da nuvem privadaCLUSTER_ID
: o ID do cluster a ser atualizado nessa nuvem privadaNODE_COUNT
: o número de nós a serem adicionados
Python
O método de atualização de cluster permite mudar a contagem total de nós. Esse método requer o nome do cluster e da nuvem privada.
- Liste os clusters.
- Atualize os clusters. O método a seguir permite modificar o número de
nós
standard-72
no cluster.
Adicionar um novo cluster a uma nuvem privada
Para adicionar um novo cluster a uma nuvem privada, faça o seguinte:
gcloud
Adicione o novo cluster e atribua um nome a ele executando o
comando gcloud vmware private-clouds clusters create
:
Por exemplo:
gcloud vmware private-clouds clusters create CLUSTER_ID \ --location=ZONE \ --private-cloud=PRIVATE_CLOUD_ID \ --node-type-config=type=NODE_TYPE,count=NODE_COUNT
Substitua:
CLUSTER_ID
: o ID do cluster que você está adicionando à nuvem privada.ZONE
: a zona da nuvem privada.PRIVATE_CLOUD_ID
: o ID da nuvem privada.NODE_TYPE
: o tipo de nó. Para mais informações, consulte Tipos de nó.NODE_COUNT
: o número de nós a serem adicionados.
API
Adicione o novo cluster e dê um nome a ele fazendo uma solicitação POST
. Exemplo:
curl -L -X POST -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" \ "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID/clusters?clusterId=CLUSTER_ID" \ -d '{ "nodeTypeConfigs": { "standard-72": { "nodeCount": NODE_COUNT } } }'
Substitua:
CLUSTER_ID
: o ID do cluster que você está adicionando à nuvem privadaZONE
: a zona da nuvem privadaPRIVATE_CLOUD_ID
: o ID da nuvem privadaNODE_COUNT
: o número de nós a serem adicionados
Python
Adicione o novo cluster e dê um nome a ele.
Criar um cluster com configuração de contagem de núcleos personalizada
Para criar um novo cluster com a configuração personalizada de contagem de núcleos, faça o seguinte:
gcloud
Adicione o novo cluster e especifique a configuração da contagem de núcleos executando o
comando gcloud vmware private-clouds clusters create
:
O exemplo a seguir cria um novo cluster com um tipo de nó standard-72
.
gcloud vmware private-clouds clusters create CLUSTER_ID \ --location=ZONE \ --private-cloud=PRIVATE_CLOUD_ID \ --node-type-config=type=standard-72,count=NODE_COUNT,custom-core-count=CORE_COUNT
Substitua:
CLUSTER_ID
: o ID do cluster que você está adicionando à nuvem privadaZONE
: a zona da nuvem privadaPRIVATE_CLOUD_ID
: o ID da nuvem privadaNODE_COUNT
: o número de nós a serem adicionadosCORES_COUNT
: o número de núcleos personalizados a serem adicionados
API
Adicione o novo cluster e especifique a configuração da contagem de núcleos fazendo uma
solicitação POST
. No exemplo a seguir, criamos um novo cluster do tipo de nó standard-72
.
curl -L -X POST -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" \ "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID/clusters?clusterId=CLUSTER_ID" \ -d '{ "nodeTypeConfigs": { "standard-72": { "nodeCount": NODE_COUNT, "customCoreCount": CORE_COUNT } } }'
Substitua:
PROJECT_ID
: o ID do projeto da nuvem privadaCLUSTER_ID
: o ID do cluster que você está adicionando à nuvem privadaZONE
: a zona da nuvem privadaPRIVATE_CLOUD_ID
: o ID da nuvem privadaNODE_COUNT
: o número de nós a serem adicionadosCORES_COUNT
: o número de núcleos personalizados a serem adicionados
Python
Adicione o novo cluster e especifique a configuração da contagem de núcleos. Por exemplo, o código a seguir cria um novo cluster do tipo de nó standard-72
com uma quantidade configurável de nós e contagem de núcleos.
Remover nós ou excluir um cluster
Ao remover nós de uma nuvem privada, você remove os nós do cluster atual ou exclui o cluster inteiro.
Console
Para remover nós de uma nuvem privada com o console do Google Cloud atualizando o cluster com menos nós, faça o seguinte:
No console do Google Cloud, acesse a página Nuvens privadas.
Na página de resumo da nuvem privada, clique em Remover nós.
Selecione o cluster que você quer reduzir ou excluir.
Clique em Remover um nó.
Verifique a capacidade do cluster.
Clique em Enviar para iniciar o processo de remoção de nós.
Para monitorar o progresso, selecione Atividade > Tarefas. Esse processo requer ressincronização na vSAN e pode levar algumas horas, dependendo dos dados.
gcloud
Para remover um nó de uma nuvem privada usando a Google Cloud CLI,
use o
comando gcloud vmware private-clouds clusters update
:
gcloud vmware private-clouds clusters update CLUSTER_ID \ --location=ZONE \ --private-cloud=PRIVATE_CLOUD_ID \ --update-nodes-config=type=NODE_TYPE,count=NODE_COUNT
Substitua:
CLUSTER_ID
: o ID do cluster a ser atualizado nesta nuvem privada.ZONE
: a zona da nuvem privada.PRIVATE_CLOUD_ID
: o ID da nuvem privada.NODE_TYPE
: o tipo de nó. Para mais informações, consulte Tipos de nó.NODE_COUNT
: a contagem de nós nova. Esse novo valor precisa ser um menor que o valor atual.
API
Para remover um nó de uma nuvem privada usando a API VMware Engine,
faça uma solicitação PATCH
:
curl -L -X PATCH -H "Authorization: Bearer TOKEN" \ -H "Content-Type: application/json" \ "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID/clusters/CLUSTER_ID?update_mask=node_type_configs.*.node_count" \ -d '{ "nodeTypeConfigs": { "standard-72" : { "nodeCount": NODE_COUNT } } }'
Substitua:
CLUSTER_ID
: o ID do cluster a ser atualizado nessa nuvem privadaZONE
: a zona da nuvem privadaPRIVATE_CLOUD_ID
: o ID da nuvem privadaNODE_COUNT
: a contagem de nós nova. Esse novo valor precisa ser um menor que o valor atual
Python
Excluir um cluster
Para excluir um cluster inteiro, faça o seguinte:
Console
No console do Google Cloud, acesse a página Nuvens privadas.
Na página de resumo da nuvem privada, clique em Remover nós.
Selecione o cluster que você quer reduzir ou excluir.
Selecione Excluir todo o cluster.
Verifique a capacidade do cluster.
Clique em Enviar para iniciar o processo de remoção de nós.
gcloud
Para excluir um cluster inteiro usando a Google Cloud CLI, use o
comando gcloud vmware private-clouds clusters delete
:
gcloud vmware private-clouds clusters delete CLUSTER_ID \ --location=ZONE \ --private-cloud=PRIVATE_CLOUD_ID
Substitua:
CLUSTER_ID
: o ID do cluster a ser atualizado nessa nuvem privadaZONE
: a zona da nuvem privadaPRIVATE_CLOUD_ID
: o ID da nuvem privada
API
Para excluir um cluster inteiro usando a API VMware Engine, faça uma solicitação DELETE
:
curl -L -X DELETE -H "Authorization: Bearer TOKEN" \ -H "Content-Type: application/json" \ "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID/clusters/CLUSTER_ID"
Substitua:
PROJECT_ID
: o ID do projeto da nuvem privadaZONE
: a zona da nuvem privadaPRIVATE_CLOUD_ID
: o ID da nuvem privadaCLUSTER_ID
: o ID do cluster a ser atualizado nessa nuvem privada
Python
Listar nós
Para listar os nós de um determinado cluster de nuvem privada e receber informações sobre vários nós ou um nó específico usando o console do Google Cloud, a CLI do Google Cloud ou a API VMware Engine, faça o seguinte.
Console
Para listar os nós de uma ou várias nuvens privadas usando o console do Google Cloud, siga estas etapas:
No console do Google Cloud, acesse a página Nuvens privadas.
Na página de resumo das nuvens particulares, clique no nome da nuvem privada.
Na página de detalhes do cluster, clique na guia Clusters
Na guia "Clusters", clique no nome do cluster. Todos os nós do cluster são listados na tabela de nós do cluster.
gcloud
Para listar os nós de uma ou várias nuvens privadas usando a CLI do Google Cloud, faça o seguinte:
Liste todos os nós vinculados a um PRIVATE_CLOUD_ID específico de uma nuvem privada executando o comando
gcloud vmware private-clouds clusters node list
:gcloud vmware private-clouds clusters node list \ --project=PROJECT_ID\ --location=ZONE \ --private-cloud=PRIVATE_CLOUD_ID \ --cluster=CLUSTER_ID
Substitua:
PROJECT_ID
: o nome do projeto para esta solicitação.ZONE
: a zona em que está localizada a rede.PRIVATE_CLOUD_ID
: o ID de rede dessa solicitação.CLUSTER_ID
: o ID do cluster para esta solicitação.
API
Para listar os nós de uma ou várias nuvens privadas usando a API do VMware Engine, faça o seguinte:
Liste todos os nós vinculados ao PRIVATE_CLOUD_ID específico de uma nuvem privada fazendo uma solicitação
GET
:GET "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID/clusters/CLUSTER_ID/nodes"
Substitua:
PROJECT_ID
: o nome do projeto para esta solicitação.ZONE
: a zona em que está localizada a rede.PRIVATE_CLOUD_ID
: o ID de rede dessa solicitação.CLUSTER_ID
: o ID do cluster para esta solicitação.
Descrever nós
Para conferir uma descrição de um ou mais nós usando o console do Google Cloud, a CLI do Google Cloud ou a API VMware Engine, faça o seguinte:
Console
Para listar os nós de uma ou várias nuvens privadas usando o console do Google Cloud, siga estas etapas:
No console do Google Cloud, acesse a página Nuvens privadas.
Na página de resumo das nuvens particulares, clique no nome da nuvem privada.
Na página de detalhes do cluster, clique na guia Clusters
Na guia "Clusters", clique no nome do cluster. Os detalhes dos nós estão listados na tabela de nós do cluster.
gcloud
Se você quiser a descrição de um ou mais nós usando a CLI do Google Cloud.
Opcional: encontre o nome do nó executando o comando
gcloud vmware private-clouds clusters node list
:gcloud vmware private-clouds clusters node list \ --project=PROJECT_ID\ --location=ZONE \ --private-cloud=PRIVATE_CLOUD_ID \ --cluster=CLUSTER_ID
Substitua:
PROJECT_ID
: o nome do projeto para esta solicitação.ZONE
: a zona em que está localizada a rede.PRIVATE_CLOUD_ID
: o ID de rede dessa solicitação.CLUSTER_ID
: o ID do cluster para esta solicitação.
Para conferir a descrição de um nó específico, execute o comando
gcloud vmware private-clouds clusters nodes describe
:gcloud vmware private-clouds clusters nodes describe NODE_NAME \ --project=PROJECT_ID\ --location=ZONE \ --private-cloud=PRIVATE_CLOUD_ID \ --cluster=CLUSTER_ID
Substitua:
NODE_NAME
: o nome do nó retornado pelo comando anterior. Por exemplo,esxi-1435-f4d250
.PROJECT_ID
: o nome do projeto para esta solicitação.ZONE
: a zona em que está localizada a rede.PRIVATE_CLOUD_ID
: o ID da rede dessa solicitação.CLUSTER_ID
: o ID do cluster para esta solicitação.
API
Se você quiser a descrição de um ou mais nós usando a API VMware Engine.
Opcional: encontre o nome do nó fazendo uma solicitação
GET
:GET "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID/clusters/CLUSTER_ID/nodes"
Substitua:
PROJECT_ID
: o nome do projeto para esta solicitação.ZONE
: a zona em que está localizada a rede.PRIVATE_CLOUD_ID
: o ID da rede dessa solicitação.CLUSTER_ID
: o ID do cluster para esta solicitação.
Para conseguir a descrição de um nó específico, faça uma solicitação
GET
:GET "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID/clusters/CLUSTER_ID/nodes/NODE_NAME"
Substitua:
NODE_NAME
: o nome do nó retornado pelo comando anterior. Por exemplo,esxi-1435-f4d250
.PROJECT_ID
: o nome do projeto para esta solicitação.ZONE
: a zona em que está localizada a rede.PRIVATE_CLOUD_ID
: o ID da rede dessa solicitação.CLUSTER_ID
: o ID do cluster para esta solicitação.
Restrições
O processo de remoção de nós da nuvem privada tem as seguintes restrições:
- O cluster do vSphere precisa ter pelo menos três nós. Não é possível remover nós de um cluster do vSphere com três nós.
- Se você estiver usando o console do Google Cloud, a CLI gcloud ou a API VMware Engine, só será possível remover um nó por vez com cada solicitação de remoção de nó.
- O armazenamento total consumido não pode exceder a capacidade total após a remoção dos nós de um cluster.
- Não é possível excluir o primeiro cluster que foi criado durante a criação da nuvem privada.
- Se as regras de DRS do vSphere (afinidade e antiafinidade) forem aplicadas a todos os nós de um cluster, os nós não poderão ser removidos do cluster. Exclua as regras e tente novamente a operação de remoção de nó.
Como visualizar sub-redes
Para ver a lista de sub-redes de gerenciamento definidas para sua nuvem privada, selecione a guia Sub-redes. A lista inclui as sub-redes do HCX criadas quando a nuvem privada foi criada.
Como visualizar informações de atividades
Para conferir as informações de atividade da sua nuvem privada, clique em Acessar o visualizador de registros. Para uma lista completa de atividades e ações associadas, consulte Como monitorar a atividade do VMware Engine.
Como visualizar a rede de gerenciamento do vSphere
Para conferir a lista de recursos de gerenciamento e máquinas virtuais do VMware configurados na sua nuvem privada, selecione a guia Rede de gerenciamento de vSphere. As informações incluem a versão do software, o nome de domínio totalmente qualificado (FQDN, na sigla em inglês) e o endereço IP dos recursos.