Faça a gestão dos recursos e da atividade da nuvem privada

Depois de criar uma nuvem privada, pode ver informações detalhadas sobre a mesma, gerir os respetivos recursos e atividade, e aceder aos dispositivos de gestão da VMware. Cada nuvem privada contém um ou mais clusters e cada cluster contém nós que correspondem a anfitriões ESXi.

Para ver uma lista das suas nuvens privadas, comece por aceder à página de resumo dos recursos:

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

    Aceda a Nuvens privadas

  2. Clique em Selecionar um projeto e, de seguida, selecione a organização, a pasta ou o projeto onde quer gerir a nuvem privada.

  3. Selecione a nuvem privada que quer gerir na lista de nuvens privadas.

Requisitos da API e da gcloud

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.

Valide a versão do esquema de endereços IP

As nuvens privadas criadas após novembro de 2022 cumprem o esquema de endereços IP (plano de IP) das atribuições de sub-redes da versão 2.0. Quase todas as nuvens privadas criadas antes de novembro de 2022 cumprem as atribuições de sub-redes da versão 1.0 do plano de IP.

Para saber a que versão a sua nuvem privada cumpre, conclua os seguintes passos:

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

    Aceda a Nuvens privadas

  2. Clique em Selecionar um projeto e, de seguida, selecione a organização, a pasta ou o projeto onde quer gerir a nuvem privada.

  3. Selecione o nome da nuvem privada que quer verificar. O número da versão é apresentado com Versão do plano de IP.

Ver um resumo da nuvem privada

O resumo fornece informações sobre a sua nuvem privada, incluindo o nome, o número de clusters do vSphere, o número de nós, a localização, o estado operacional e muito mais. A página de resumo também inclui os servidores DNS implementados na nuvem privada.

Na página de resumo da nuvem privada, pode realizar as seguintes ações:

Adicionar nós a uma nuvem privada

Uma nuvem privada consiste num ou mais clusters do vSphere, cada um contendo vários nós. Quando adiciona nós a uma nuvem privada, adiciona nós ao cluster existente ou cria um novo cluster. Uma nuvem privada pode ser expandida várias vezes, desde que permaneça dentro dos limites de nós gerais. Sempre que expande uma nuvem privada, adiciona ao cluster existente ou cria um novo.

Como parte da nova configuração do cluster, a Google configura a infraestrutura do VMware. As definições incluem definições de armazenamento para grupos de discos vSAN, alta disponibilidade do VMware e Distributed Resource Scheduler (DRS).

Consola

Para adicionar nós a uma nuvem privada com um cluster existente através da Google Cloud consola, siga estes passos:

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

    Aceda a Nuvens privadas

  2. Clique em Selecionar um projeto e, de seguida, selecione a organização, a pasta ou o projeto que contém a nuvem privada.

  3. Selecione a nuvem privada que quer gerir na lista de nuvens privadas.

  4. Na página de resumo das nuvens privadas, clique no separador Clusters.

  5. Clique no nome do cluster existente para abrir a página de detalhes do cluster.

  6. Clique em Edit.

  7. Selecione a nova quantidade de nós para adicionar nós de HCI ou selecione o tipo de nó de armazenamento e a nova quantidade de nós para adicionar nós apenas de armazenamento e, de seguida, clique em Guardar.

gcloud

O comando update permite-lhe alterar a contagem total de nós do cluster. Este comando requer o nome do cluster e da nuvem privada.

  1. Liste os clusters introduzindo o comando gcloud vmware private-clouds clusters list:

    gcloud vmware private-clouds clusters list \
    --private-cloud=PRIVATE_CLOUD_ID \
    --location=ZONE

Substitua o seguinte:

  • PRIVATE_CLOUD_ID: o nome da nuvem privada
  • ZONE: a zona da nuvem privada
  1. Atualize o cluster executando 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 o seguinte:

    • CLUSTER_ID: o ID do cluster a atualizar nesta nuvem privada.
    • ZONE: a zona da nuvem privada.
    • PRIVATE_CLOUD_ID: o ID da nuvem privada para este pedido.
    • NODE_TYPE: o tipo de nó. Para mais informações, consulte o artigo Tipos de nós.
    • NODE_COUNT: o número de nós a adicionar.

API

A API de atualização permite alterar a contagem total de nós do cluster. Este comando requer o nome do cluster e da nuvem privada.

  1. Liste os clusters fazendo um pedido 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 o seguinte:

  • PROJECT_ID: o ID do projeto para este pedido
  • ZONE: a zona da nuvem privada
  • PRIVATE_CLOUD_ID: o ID da nuvem privada para este pedido
  1. Atualize os clusters fazendo um pedido PATCH. Por exemplo, o seguinte 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 o seguinte:

    • PROJECT_ID: o ID do projeto para este pedido
    • ZONE: a zona da nuvem privada
    • PRIVATE_CLOUD_ID: o ID da nuvem privada para a nuvem privada
    • CLUSTER_ID: o ID do cluster para o cluster a atualizar nesta nuvem privada
    • NODE_COUNT: o número de nós a adicionar

Python

O método de atualização do cluster permite-lhe alterar a contagem total de nós do cluster. Este método requer o nome do cluster e da nuvem privada.

  1. Liste os clusters.
from typing import Iterable

from google.cloud import vmwareengine_v1


def list_clusters(
    project_id: str, zone: str, private_cloud_name: str
) -> Iterable[vmwareengine_v1.Cluster]:
    """
    Retrieves a list of clusters in private cloud.

    Args:
        project_id: name of the project hosting the private cloud.
        zone: zone in which the private cloud is located.
        private_cloud_name: name of the cloud of which you want to list cluster.

    Returns:
        An iterable collection of Cluster objects.
    """
    client = vmwareengine_v1.VmwareEngineClient()
    return client.list_clusters(
        parent=f"projects/{project_id}/locations/{zone}/privateClouds/{private_cloud_name}"
    )

  1. Atualize os clusters. O método seguinte permite-lhe modificar o número de nós no cluster.standard-72
from google.api_core import operation
from google.cloud import vmwareengine_v1


def update_cluster_node_count(
    project_id: str,
    zone: str,
    private_cloud_name: str,
    cluster_name: str,
    node_count: int,
) -> operation.Operation:
    """
    Modify the number of nodes in a cluster in a private cloud.

    Modifying a cluster is a long-running operation and it may take over an hour.

    Args:
        project_id: name of the project you want to use.
        zone: zone in which your private cloud is located.
        private_cloud_name: name of the private cloud hosting the cluster.
        cluster_name: name of the cluster.
        node_count: desired number of nodes in the cluster.

    Returns:
        An Operation object related to cluster modification operation.
    """
    if node_count < 3:
        raise RuntimeError("Cluster needs to have at least 3 nodes")
    client = vmwareengine_v1.VmwareEngineClient()
    request = vmwareengine_v1.UpdateClusterRequest()
    request.cluster = vmwareengine_v1.Cluster()
    request.cluster.name = (
        f"projects/{project_id}/locations/{zone}/privateClouds/{private_cloud_name}"
        f"/clusters/{cluster_name}"
    )
    request.cluster.node_type_configs = {
        "standard-72": vmwareengine_v1.NodeTypeConfig()
    }
    request.cluster.node_type_configs["standard-72"].node_count = node_count
    request.update_mask = "nodeTypeConfigs.*.nodeCount"
    return client.update_cluster(request)

Adicione um novo cluster a uma nuvem privada

Para adicionar um novo cluster a uma nuvem privada existente, faça o seguinte:

Consola

Para adicionar um novo cluster através da Google Cloud consola, siga estes passos:

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

    Aceda a Nuvens privadas

  2. Clique em Selecionar um projeto e, de seguida, selecione a organização, a pasta ou o projeto que contém a nuvem privada.

  3. Selecione a nuvem privada que quer gerir na lista de nuvens privadas.

  4. Na página de resumo das nuvens privadas, clique no separador Clusters.

  5. Clique em Adicionar cluster. Em seguida, indique os seguintes detalhes:

    1. Introduza um nome para o cluster.
    2. Selecione o tipo de nó para o novo cluster.
    3. Selecione o número de nós. Cada novo cluster tem de ter, pelo menos, três nós.
  6. Clique em Criar.

gcloud

Adicione o novo cluster e atribua-lhe um nome 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 o seguinte:

  • CLUSTER_ID: o ID do cluster que está a adicionar à nuvem privada.
  • ZONE: a zona da nuvem privada.
  • PRIVATE_CLOUD_ID: o ID da nuvem privada para a nuvem privada.
  • NODE_TYPE: o tipo de nó. Para mais informações, consulte o artigo Tipos de nós.
  • NODE_COUNT: o número de nós a adicionar.

API

Adicione o novo cluster e atribua-lhe um nome fazendo um pedido POST. Por 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 o seguinte:

  • CLUSTER_ID: o ID do cluster que está a adicionar à nuvem privada
  • ZONE: a zona da nuvem privada
  • PRIVATE_CLOUD_ID: o ID da nuvem privada para a nuvem privada
  • NODE_COUNT: o número de nós a adicionar

Python

Adicione o novo cluster e atribua-lhe um nome.

from google.api_core import operation
from google.cloud import vmwareengine_v1


def create_cluster(
    project_id: str,
    zone: str,
    private_cloud_name: str,
    cluster_name: str,
    node_count: int = 4,
) -> operation.Operation:
    """
    Create a new cluster in a private cloud.

    Creation of a new cluster is a long-running operation and it may take over an hour.

    Args:
        project_id: name of the project you want to use.
        zone: region in which your private cloud is located.
        private_cloud_name: name of the private cloud hosting the new cluster.
        cluster_name: name of the new cluster.
        node_count: number of nodes in the new cluster. (Must be >= 3)

    Returns:
        An Operation object related to started cluster creation operation.

    Raises:
        ValueError in case an incorrect number of nodes is provided.
    """
    if node_count < 3:
        raise ValueError("Cluster needs to have at least 3 nodes")

    request = vmwareengine_v1.CreateClusterRequest()
    request.parent = (
        f"projects/{project_id}/locations/{zone}/privateClouds/{private_cloud_name}"
    )

    request.cluster = vmwareengine_v1.Cluster()
    request.cluster.name = cluster_name

    # Currently standard-72 is the only supported node type.
    request.cluster.node_type_configs = {
        "standard-72": vmwareengine_v1.NodeTypeConfig()
    }
    request.cluster.node_type_configs["standard-72"].node_count = node_count

    client = vmwareengine_v1.VmwareEngineClient()
    return client.create_cluster(request)

Crie um novo cluster com uma configuração de contagem de núcleos personalizada

Para criar um novo cluster com uma configuração de número de núcleos personalizada, faça o seguinte:

Consola

Para adicionar um novo cluster através da Google Cloud consola, siga estes passos:

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

    Aceda a Nuvens privadas

  2. Clique em Selecionar um projeto e, de seguida, selecione a organização, a pasta ou o projeto que contém a nuvem privada.

  3. Selecione a nuvem privada que quer gerir na lista de nuvens privadas.

  4. Na página de resumo das nuvens privadas, clique no separador Clusters.

  5. Clique em Adicionar cluster. Em seguida, indique os seguintes detalhes:

    1. Introduza um nome para o cluster.
    2. Selecione o número de nós. Cada novo cluster tem de ter, pelo menos, três nós.
    3. Selecione o tipo de nó para o cluster.
  6. Selecione a caixa Personalizar núcleos para reduzir o número de núcleos disponíveis para cada nó no cluster de gestão. Para mais detalhes, consulte o artigo Contagens de núcleos personalizadas.

  7. Clique em Criar.

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 seguinte 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 o seguinte:

  • CLUSTER_ID: o ID do cluster que está a adicionar à nuvem privada
  • ZONE: a zona da nuvem privada
  • PRIVATE_CLOUD_ID: o ID da nuvem privada para a nuvem privada
  • NODE_COUNT: o número de nós a adicionar
  • CORES_COUNT: o número de núcleos personalizados a adicionar

API

Adicione o novo cluster e especifique a configuração da contagem de núcleos fazendo um pedido POST. O exemplo seguinte cria 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 o seguinte:

  • PROJECT_ID: o ID do projeto da nuvem privada
  • CLUSTER_ID: o ID do cluster que está a adicionar à nuvem privada
  • ZONE: a zona da nuvem privada
  • PRIVATE_CLOUD_ID: o ID da nuvem privada para a nuvem privada
  • NODE_COUNT: o número de nós a adicionar
  • CORES_COUNT: o número de núcleos personalizados a adicionar

Python

Adicione o novo cluster e especifique a configuração da contagem de núcleos. Por exemplo, o seguinte cria um novo cluster do tipo de nó standard-72 com uma quantidade configurável de nós e contagem de núcleos.

from google.api_core import operation
from google.cloud import vmwareengine_v1


def create_custom_cluster(
    project_id: str,
    zone: str,
    private_cloud_name: str,
    cluster_name: str,
    node_count: int = 4,
    core_count: int = 28,
) -> operation.Operation:
    """
    Create a new cluster with custom number of cores in its nodes
    in a private cloud.

    Creation of a new cluster is a long-running operation and it may take over an hour.

    Args:
        project_id: name of the project you want to use.
        zone: region in which your private cloud is located.
        private_cloud_name: name of the private cloud hosting the new cluster.
        cluster_name: name of the new cluster.
        node_count: number of nodes in the new cluster.
        core_count: number of CPU cores in the new cluster nodes.

    Returns:
        An Operation object related to started cluster creation operation.

    Raises:
        ValueError in case an incorrect number of nodes is provided.
    """
    if node_count < 3:
        raise ValueError("Cluster needs to have at least 3 nodes")

    request = vmwareengine_v1.CreateClusterRequest()
    request.parent = (
        f"projects/{project_id}/locations/{zone}/privateClouds/{private_cloud_name}"
    )

    request.cluster = vmwareengine_v1.Cluster()
    request.cluster.name = cluster_name

    # Currently standard-72 is the only supported node type.
    request.cluster.node_type_configs = {
        "standard-72": vmwareengine_v1.NodeTypeConfig()
    }
    request.cluster.node_type_configs["standard-72"].node_count = node_count
    request.cluster.node_type_configs["standard-72"].custom_core_count = core_count

    client = vmwareengine_v1.VmwareEngineClient()
    return client.create_cluster(request)

Remova nós de um cluster

Quando remove nós de uma nuvem privada, remove nós do cluster existente.

Consola

Para remover nós de uma nuvem privada através da Google Cloud consola, atualize o cluster com menos nós. Para tal, faça o seguinte:

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

    Aceda a Nuvens privadas

  2. Clique em Selecionar um projeto e, de seguida, selecione a organização, a pasta ou o projeto que contém a nuvem privada.

  3. Selecione a nuvem privada que quer gerir na lista de nuvens privadas.

  4. Clique no separador Clusters e selecione o cluster que quer reduzir.

  5. Clique em Editar e reduza a contagem de nós em um. Só pode remover um nó de cada vez.

  6. Clique em Guardar.

Para monitorizar o progresso, selecione Atividade > Tarefas. Este processo requer a resincronização no vSAN e pode demorar algumas horas, dependendo dos dados.

gcloud

Para remover um nó de uma nuvem privada através da CLI do Google Cloud, 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 o seguinte:

  • CLUSTER_ID: o ID do cluster para atualizar nesta nuvem privada.
  • ZONE: a zona da nuvem privada.
  • PRIVATE_CLOUD_ID: o ID da nuvem privada para a nuvem privada.
  • NODE_TYPE: o tipo de nó. Para mais informações, consulte o artigo Tipos de nós.
  • NODE_COUNT: o novo número de nós. Este novo valor tem de ser inferior em uma unidade ao valor atual.

API

Para remover um nó de uma nuvem privada através da API VMware Engine, faça um pedido 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 o seguinte:

  • CLUSTER_ID: o ID do cluster a atualizar nesta nuvem privada
  • ZONE: a zona da nuvem privada
  • PRIVATE_CLOUD_ID: o ID da nuvem privada para a nuvem privada
  • NODE_COUNT: o novo número de nós. Este novo valor tem de ser inferior em uma unidade ao valor atual

Python

from google.api_core import operation
from google.cloud import vmwareengine_v1


def update_cluster_node_count(
    project_id: str,
    zone: str,
    private_cloud_name: str,
    cluster_name: str,
    node_count: int,
) -> operation.Operation:
    """
    Modify the number of nodes in a cluster in a private cloud.

    Modifying a cluster is a long-running operation and it may take over an hour.

    Args:
        project_id: name of the project you want to use.
        zone: zone in which your private cloud is located.
        private_cloud_name: name of the private cloud hosting the cluster.
        cluster_name: name of the cluster.
        node_count: desired number of nodes in the cluster.

    Returns:
        An Operation object related to cluster modification operation.
    """
    if node_count < 3:
        raise RuntimeError("Cluster needs to have at least 3 nodes")
    client = vmwareengine_v1.VmwareEngineClient()
    request = vmwareengine_v1.UpdateClusterRequest()
    request.cluster = vmwareengine_v1.Cluster()
    request.cluster.name = (
        f"projects/{project_id}/locations/{zone}/privateClouds/{private_cloud_name}"
        f"/clusters/{cluster_name}"
    )
    request.cluster.node_type_configs = {
        "standard-72": vmwareengine_v1.NodeTypeConfig()
    }
    request.cluster.node_type_configs["standard-72"].node_count = node_count
    request.update_mask = "nodeTypeConfigs.*.nodeCount"
    return client.update_cluster(request)

Elimine um cluster

Para eliminar um cluster inteiro, faça o seguinte:

Consola

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

    Aceda a Nuvens privadas

  2. Clique em Selecionar um projeto e, de seguida, selecione a organização, a pasta ou o projeto que contém a nuvem privada.

  3. Selecione a nuvem privada que quer gerir na lista de nuvens privadas.

  4. Clique no separador Clusters e selecione o cluster que quer eliminar.

  5. Clique em Eliminar e verifique a capacidade do cluster. Tenha em atenção que não é possível eliminar um cluster de gestão.

  6. Clique em Guardar.

gcloud

Para eliminar um cluster completo através da CLI gcloud, 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 o seguinte:

  • CLUSTER_ID: o ID do cluster a atualizar nesta nuvem privada
  • ZONE: a zona da nuvem privada
  • PRIVATE_CLOUD_ID: o ID da nuvem privada para a nuvem privada

API

Para eliminar um cluster inteiro através da API VMware Engine, faça um pedido 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 o seguinte:

  • PROJECT_ID: o ID do projeto da nuvem privada
  • ZONE: a zona da nuvem privada
  • PRIVATE_CLOUD_ID: o ID da nuvem privada para a nuvem privada
  • CLUSTER_ID: o ID do cluster a atualizar nesta nuvem privada

Python

from google.api_core import operation
from google.cloud import vmwareengine_v1


def delete_cluster(
    project_id: str, zone: str, private_cloud_name: str, cluster_name: str
) -> operation.Operation:
    """
    Delete a cluster from private cloud.

    Deleting a cluster is a long-running operation and it may take over an hour..

    Args:
        project_id: name of the project you want to use.
        zone: region in which your private cloud is located.
        private_cloud_name: name of the private cloud hosting the new cluster.
        cluster_name: name of the new cluster.

    Returns:
        An Operation object related to started cluster deletion operation.
    """
    client = vmwareengine_v1.VmwareEngineClient()
    request = vmwareengine_v1.DeleteClusterRequest()
    request.name = (
        f"projects/{project_id}/locations/{zone}/privateClouds/{private_cloud_name}"
        f"/clusters/{cluster_name}"
    )
    return client.delete_cluster(request)

Listar nós

Para listar os nós do cluster de uma nuvem privada específica e obter informações sobre vários nós ou um nó específico através da Google Cloud consola, da CLI Google Cloud ou da API VMware Engine, faça o seguinte.

Consola

Para listar os nós de uma ou várias nuvens privadas através da Google Cloud consola, siga estes passos:

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

    Aceda a Nuvens privadas

  2. Na página de resumo das nuvens privadas, clique no nome da nuvem privada.

  3. Clique no separador Clusters.

  4. Clique no nome do cluster. Todos os nós no cluster estão listados na tabela de nós do cluster.

gcloud

Para listar os nós de uma ou várias nuvens privadas através da CLI do Google Cloud, faça o seguinte:

  1. Apresente uma lista de todos os nós associados a uma nuvem privada específica PRIVATE_CLOUD_ID 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 o seguinte:

    • PROJECT_ID: o nome do projeto para este pedido.
    • ZONE: a zona onde esta rede está localizada.
    • PRIVATE_CLOUD_ID: o ID da rede para este pedido.
    • CLUSTER_ID: o ID do cluster para este pedido.

API

Para listar os nós de uma ou várias nuvens privadas através da VMware Engine API, faça o seguinte:

  1. Liste todos os nós associados a uma nuvem privada específica PRIVATE_CLOUD_ID fazendo um pedido GET:

    GET "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID/clusters/CLUSTER_ID/nodes"

    Substitua o seguinte:

    • PROJECT_ID: o nome do projeto para este pedido.
    • ZONE: a zona onde esta rede está localizada.
    • PRIVATE_CLOUD_ID: o ID da rede para este pedido.
    • CLUSTER_ID: o ID do cluster para este pedido.

Descrever nós

Para obter uma descrição de um ou mais nós através da Google Cloud consola, da CLI do Google Cloud ou da API VMware Engine, faça o seguinte:

Consola

Para listar os nós de uma ou várias nuvens privadas através da Google Cloud consola, siga estes passos:

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

    Aceda a Nuvens privadas

  2. Na página de resumo das nuvens privadas, clique no nome da nuvem privada.

  3. Clique no separador Clusters.

  4. Clique no nome do cluster. Os detalhes dos nós são apresentados na tabela de nós do cluster.

gcloud

Se quiser obter a descrição de um ou mais nós através da CLI do Google Cloud.

  1. 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 o seguinte:

    • PROJECT_ID: o nome do projeto para este pedido.
    • ZONE: a zona onde esta rede está localizada.
    • PRIVATE_CLOUD_ID: o ID da rede para este pedido.
    • CLUSTER_ID: o ID do cluster para este pedido.
  2. Execute o comando gcloud vmware private-clouds clusters nodes describe para obter a descrição de um nó específico:

    gcloud vmware private-clouds clusters nodes describe NODE_NAME \
     --project=PROJECT_ID\
     --location=ZONE \
     --private-cloud=PRIVATE_CLOUD_ID \
     --cluster=CLUSTER_ID

    Substitua o seguinte:

    • NODE_NAME: o nome do nó devolvido pelo comando anterior. Por exemplo, esxi-1435-f4d250.
    • PROJECT_ID: o nome do projeto para este pedido.
    • ZONE: a zona onde esta rede está localizada.
    • PRIVATE_CLOUD_ID: o ID da rede para este pedido.
    • CLUSTER_ID: o ID do cluster para este pedido.

API

Se quiser obter a descrição de um ou mais nós através da API VMware Engine.

  1. Opcional: encontre o nome do nó fazendo um pedido GET:

    GET "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID/clusters/CLUSTER_ID/nodes"
    

    Substitua o seguinte:

    • PROJECT_ID: o nome do projeto para este pedido.
    • ZONE: a zona onde esta rede está localizada.
    • PRIVATE_CLOUD_ID: o ID da rede para este pedido.
    • CLUSTER_ID: o ID do cluster para este pedido.
  2. Obtenha a descrição de um nó específico fazendo um pedido GET:

    GET "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID/clusters/CLUSTER_ID/nodes/NODE_NAME"

    Substitua o seguinte:

    • NODE_NAME: o nome do nó devolvido pelo comando anterior. Por exemplo, esxi-1435-f4d250.
    • PROJECT_ID: o nome do projeto para este pedido.
    • ZONE: a zona onde esta rede está localizada.
    • PRIVATE_CLOUD_ID: o ID da rede para este pedido.
    • CLUSTER_ID: o ID do cluster para este pedido.

Restrições

O processo de remoção de nós da sua nuvem privada tem as seguintes restrições:

  • O cluster do vSphere tem de ter, pelo menos, três nós. Não pode remover nós de um cluster do vSphere com três nós.
  • Quer esteja a usar a Google Cloud consola, a CLI gcloud ou a API VMware Engine, só pode remover um nó de cada vez com cada pedido de remoção de nó.
  • O armazenamento total consumido não pode exceder a capacidade total após a remoção de nós de um cluster.
  • Não pode eliminar o primeiro cluster criado quando a nuvem privada foi criada.
  • Se as regras do vSphere DRS (afinidade e antiafinidade) forem aplicadas a todos os nós de um cluster, não é possível remover nós do cluster. Pode eliminar as regras e tentar novamente a operação de remoção do nó.

Ver sub-redes

Para ver a lista de sub-redes de gestão definidas para a sua nuvem privada, selecione o separador Sub-redes. A lista inclui as sub-redes do HCX criadas quando a nuvem privada foi criada.

Ver informações de atividade

Para ver as informações de atividade da sua nuvem privada, clique em Aceder ao Logs Viewer. Para ver uma lista completa de atividades e ações associadas, consulte o artigo Monitorizar a atividade do VMware Engine.

A ver a rede de gestão do vSphere

Para ver a lista de recursos de gestão do VMware e máquinas virtuais que estão configurados na sua nuvem privada, selecione o separador Rede de gestão do vSphere. As informações incluem a versão do software, o nome de domínio totalmente qualificado (FQDN) e o endereço IP dos recursos.