Questa pagina è stata tradotta dall'API Cloud Translation.

Gestisci attività e risorse del cloud privato

Dopo aver creato un cloud privato, puoi visualizzarne informazioni dettagliate, gestirne le risorse e le attività e accedere alle relative appliance di gestione VMware. Ogni cloud privato contiene uno o più cluster e ogni cluster contiene nodi corrispondenti agli host ESXi.

Per visualizzare un elenco dei tuoi cloud privati, inizia accedendo alla pagina di riepilogo delle risorse:

Nella console Google Cloud, vai alla pagina Nuvole private.

Vai a Private Cloud
Seleziona il cloud privato che vuoi gestire dall'elenco dei cloud privati.

Requisiti di gcloud e API

Per utilizzare lo strumento a riga di comando gcloud o l'API per gestire le risorse di VMware Engine, ti consigliamo di configurare gli strumenti come descritto di seguito.

gcloud

Imposta l'ID progetto predefinito:
```
gcloud config set project PROJECT_ID
```

Imposta una regione e una zona predefinite:

gcloud config set compute/region REGION

gcloud config set compute/zone ZONE

Per ulteriori informazioni sullo strumento gcloud vmware, consulta la documentazione di riferimento di Cloud SDK.

API

Gli esempi di API in questo set di documentazione utilizzano lo strumento a riga di comando cURL per eseguire query sull'API. È necessario un token di accesso valido nell'ambito della richiesta cURL. Esistono molti modi per ottenere un token di accesso valido. I passaggi riportati di seguito utilizzano lo strumento gcloud per generare un token di accesso:

Accedi a Google Cloud:
```
gcloud auth login
```
Genera il token di accesso ed esportalo in TOKEN:
```
export TOKEN=`gcloud auth print-access-token`
```
Verifica che TOKEN sia impostato correttamente:
```
echo $TOKEN
```

Ora utilizza il token di autorizzazione nelle richieste all'API. Ad esempio:

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

Gli esempi di codice Python in questa documentazione utilizzano la libreria VMware Engine per comunicare con l'API. Per poter utilizzare questo approccio, la libreria deve essere installata e le Credenziali predefinite dell'applicazione devono essere configurate.

Scarica e installa la libreria Python:
```
pip install google-cloud-vmwareengine
```
Configura le informazioni dell'ADC eseguendo i seguenti comandi nella shell:
```
gcloud auth application-default login
```
In alternativa, utilizza un file della chiave dell'account di servizio:
```
export GOOGLE_APPLICATION_CREDENTIALS="FILE_PATH"
```

Per ulteriori informazioni sulla libreria, visita la pagina di riferimento o visualizza gli esempi di codice su GitHub.

Verifica la versione del layout dell'indirizzo IP

I cloud privati creati dopo novembre 2022 rispettano le allocazioni delle subnet della versione 2.0 del layout degli indirizzi IP (piano IP). Quasi tutti i cloud privati creati prima di novembre 2022 rispettano le allocazioni delle subnet della versione 1.0 del piano IP.

Per scoprire a quale versione è conforme il tuo cloud privato, segui questi passaggi:

Nella console Google Cloud, vai alla pagina Nuvole private.

Vai a Private Cloud
Seleziona il nome del cloud privato che vuoi controllare. Il numero di versione viene visualizzato con Versione piano IP.

Visualizzazione di un riepilogo del cloud privato

Il riepilogo fornisce informazioni sul tuo cloud privato, tra cui nome, numero di cluster vSphere, numero di nodi, posizione, stato di funzionamento e altro ancora. La pagina di riepilogo include anche i server DNS di cui è stato eseguito il deployment nel cloud privato.

Nella pagina di riepilogo del cloud privato puoi eseguire le seguenti azioni:

Lancia vSphere Client. Accedi a vCenter per questo cloud privato.
Aggiungi nodi. Aggiungi nodi a questo cloud privato.
Aggiungi cluster. Aggiungi un nuovo cluster a questo cloud privato.
Crea un cluster con una configurazione personalizzata del numero di core. Crea un nuovo cluster con una configurazione personalizzata del numero di core.
Rimuovi i nodi. Rimuovi i nodi da questo cloud privato.
Elimina il cloud privato. Elimina un cloud privato, incluse tutte le VM, la configurazione di vCenter e i dati. Prima di procedere con l'eliminazione, esegui il backup di tutti i sistemi e i dati.
Modifica i privilegi vSphere. Eleva i tuoi privilegi per eseguire una determinata attività su questo cloud privato.
Copia gli indirizzi IP dei server DNS. Visualizza un elenco dei server DNS sul tuo cloud privato. Puoi configurare l'inoltro DNS dai server DNS on-premise ai tuoi server Cloud DNS privati. Per ulteriori informazioni sul reindirizzamento DNS, consulta Configurare il DNS per la risoluzione dei nomi per l'accesso a vCenter del cloud privato dalle workstation on-premise.

Aggiunta di nodi a un cloud privato

Un cloud privato è costituito da uno o più cluster vSphere, ciascuno contenente più nodi. Quando aggiungi nodi a un cloud privato, li aggiungi al cluster esistente o crei un nuovo cluster. Un cloud privato può essere espanso più volte, a condizione che tu rispetti i limiti di nodi complessivi. Ogni volta che espandi un cloud privato, aggiungi un nodo al cluster esistente o ne crei uno nuovo.

Nell'ambito della configurazione del nuovo cluster, Google configura l'infrastruttura VMware. Le impostazioni includono le impostazioni di archiviazione per i gruppi di dischi vSAN, l'alta disponibilità di VMware e Distributed Resource Scheduler (DRS).

Console

Per aggiungere nodi a un cloud privato utilizzando la console Google Cloud, segui questi passaggi:

Nella console Google Cloud, vai alla pagina Nuvole private.

Vai a Private Cloud
Nella pagina di riepilogo dei cloud privati, fai clic su Aggiungi nodi.
Scegli se aggiungere nodi a uno dei tuoi cluster esistenti o creare un nuovo cluster vSphere. Man mano che apporti modifiche, le informazioni di riepilogo nella pagina vengono aggiornate.
Per aggiungere nodi a uno dei tuoi cluster esistenti, seleziona Aggiungi nodi ai esistenti. Seleziona il cluster da espandere e inserisci il numero di nodi da aggiungere.
Per aggiungere un nuovo cluster, seleziona Crea nuovo. Quindi, fornisci i seguenti dettagli:
1. Inserisci un nome per il cluster.
2. Seleziona un data center vSphere esistente o inserisci un nome per creare un nuovo data center.
3. Seleziona il numero di nodi. Ogni nuovo cluster deve avere almeno tre nodi.
4. (Facoltativo) Fai clic sul pulsante di attivazione/disattivazione Personalizza core se vuoi ridurre il numero di core disponibili per ogni nodo del cluster di gestione. Per maggiori dettagli, consulta Conteggi core personalizzati.
Fai clic su Invia.

gcloud

Il comando update consente di modificare il numero totale di nodi del cluster. Questo comando richiede il nome del cluster e del cloud privato.

Elenca i cluster inserendo il comando gcloud vmware private-clouds clusters list:

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

Sostituisci quanto segue:

PRIVATE_CLOUD_ID: il nome del cloud privato
ZONE: la zona per il cloud privato

Aggiorna il cluster eseguendo il 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
```
Sostituisci quanto segue:
- CLUSTER_ID: l'ID del cluster da aggiornare in questo cloud privato.
- ZONE: la zona per il cloud privato.
- PRIVATE_CLOUD_ID: l'ID del cloud privato per questa richiesta.
- NODE_TYPE: il tipo di nodo. Per ulteriori informazioni, consulta Tipi di nodi.
- NODE_COUNT: il numero di nodi da aggiungere.

API

L'API di aggiornamento ti consente di modificare il numero totale di nodi del cluster. Questo comando richiede il nome del cluster e del cloud privato.

Elenca i cluster inviando una richiesta GET:

curl -L -X GET -H "Authorization: Bearer TOKEN" "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID/clusters"

Sostituisci quanto segue:

PROJECT_ID: l'ID progetto per questa richiesta
ZONE: la zona per il cloud privato
PRIVATE_CLOUD_ID: l'ID del cloud privato per questa richiesta

Aggiorna i cluster inviando una richiesta PATCH. Ad esempio, il seguente aggiorna il cluster al tipo di nodo 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
  }
}
}'
```
Sostituisci quanto segue:
- PROJECT_ID: l'ID progetto per questa richiesta
- ZONE: la zona per il cloud privato
- PRIVATE_CLOUD_ID: l'ID del cloud privato per il cloud privato
- CLUSTER_ID: l'ID del cluster da aggiornare in questo cloud privato
- NODE_COUNT: il numero di nodi da aggiungere

Python

Il metodo di aggiornamento del cluster consente di modificare il numero totale di nodi del cluster. Questo metodo richiede il nome del cluster e del cloud privato.

Elenca i cluster.

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}"
    )

Aggiorna i cluster. Il seguente metodo consente di modificare il numero di nodistandard-72 nel cluster.

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)

Aggiungere un nuovo cluster a un cloud privato

Per aggiungere un nuovo cluster a un cloud privato esistente:

gcloud

Aggiungi il nuovo cluster e assegnagli un nome eseguendo il comando gcloud vmware private-clouds clusters create: Ad esempio:

gcloud vmware private-clouds clusters create CLUSTER_ID \
   --location=ZONE \
   --private-cloud=PRIVATE_CLOUD_ID \
   --node-type-config=type=NODE_TYPE,count=NODE_COUNT

Sostituisci quanto segue:

CLUSTER_ID: l'ID del cluster che stai aggiungendo al cloud privato.
ZONE: la zona per il cloud privato.
PRIVATE_CLOUD_ID: l'ID del cloud privato per il cloud privato.
NODE_TYPE: il tipo di nodo. Per ulteriori informazioni, consulta Tipi di nodi.
NODE_COUNT: il numero di nodi da aggiungere.

API

Aggiungi il nuovo cluster e assegnagli un nome inviando una richiesta POST. Ad esempio:

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
      }
  }
}'

Sostituisci quanto segue:

CLUSTER_ID: l'ID del cluster che stai aggiungendo al cloud privato
ZONE: la zona per il cloud privato
PRIVATE_CLOUD_ID: l'ID del cloud privato per il cloud privato
NODE_COUNT: il numero di nodi da aggiungere

Python

Aggiungi il nuovo cluster e assegnagli un 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)

Creare un nuovo cluster con una configurazione personalizzata del numero di core

Per creare un nuovo cluster con una configurazione personalizzata del numero di core:

gcloud

Aggiungi il nuovo cluster e specifica la configurazione del numero di core eseguendo il comando gcloud vmware private-clouds clusters create: L'esempio seguente crea un nuovo cluster con un tipo di nodo 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

Sostituisci quanto segue:

CLUSTER_ID: l'ID del cluster che stai aggiungendo al cloud privato
ZONE: la zona per il cloud privato
PRIVATE_CLOUD_ID: l'ID del cloud privato per il cloud privato
NODE_COUNT: il numero di nodi da aggiungere
CORES_COUNT: il numero di core personalizzati da aggiungere

API

Aggiungi il nuovo cluster e specifica la configurazione del numero di core inviando una richiesta POST. L'esempio seguente crea un nuovo cluster di tipo di nodo 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
        }
    }
}'

Sostituisci quanto segue:

PROJECT_ID: l'ID progetto per il cloud privato
CLUSTER_ID: l'ID del cluster che stai aggiungendo al cloud privato
ZONE: la zona per il cloud privato
PRIVATE_CLOUD_ID: l'ID del cloud privato per il cloud privato
NODE_COUNT: il numero di nodi da aggiungere
CORES_COUNT: il numero di core personalizzati da aggiungere

Python

Aggiungi il nuovo cluster e specifica la configurazione del numero di core. Ad esempio, la seguente istruzione crea un nuovo cluster di tipo di nodo standard-72 con un numero configurabile di nodi e core.

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)

Rimuovere nodi o eliminare un cluster

Quando rimuovi i nodi da un cloud privato, li rimuovi dal cluster esistente o elimini l'intero cluster.

Console

Per rimuovere i nodi da un cloud privato utilizzando la console Google Cloud aggiornando il cluster con meno nodi, segui questi passaggi:

Nella console Google Cloud, vai alla pagina Nuvole private.

Vai a Private Cloud
Nella pagina di riepilogo dei cloud privati, fai clic su Rimuovi nodi.
Seleziona il cluster che vuoi ridurre o eliminare.
Fai clic su Rimuovi un nodo.
Verifica la capacità del cluster.
Fai clic su Invia per iniziare la procedura di rimozione dei nodi.

Per monitorare l'avanzamento, seleziona Attività > Attività. Questa procedura richiede la risincronizzazione in vSAN e può richiedere alcune ore, a seconda dei dati.

gcloud

Per rimuovere un nodo da un cloud privato utilizzando Google Cloud CLI, utilizza il 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

Sostituisci quanto segue:

CLUSTER_ID: l'ID del cluster da actualizare in questo cloud privato.
ZONE: la zona per il cloud privato.
PRIVATE_CLOUD_ID: l'ID del cloud privato per il cloud privato.
NODE_TYPE: il tipo di nodo. Per ulteriori informazioni, consulta Tipi di nodi.
NODE_COUNT: il nuovo numero di nodi. Questo nuovo valore deve essere inferiore di uno rispetto al valore corrente.

API

Per rimuovere un nodo da un cloud privato utilizzando l'API VMware Engine, invia una richiesta 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
    }
  }
}'

Sostituisci quanto segue:

CLUSTER_ID: l'ID del cluster da actualizare in questo cloud privato
ZONE: la zona per il cloud privato
PRIVATE_CLOUD_ID: l'ID del cloud privato per il cloud privato
NODE_COUNT: il nuovo numero di nodi. Questo nuovo valore deve essere inferiore di uno rispetto al valore corrente

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)

Elimina un cluster

Per eliminare un intero cluster:

Console

Nella console Google Cloud, vai alla pagina Nuvole private.

Vai a Private Cloud
Nella pagina di riepilogo dei cloud privati, fai clic su Rimuovi nodi.
Seleziona il cluster che vuoi ridurre o eliminare.
Seleziona Elimina l'intero cluster.
Verifica la capacità del cluster.
Fai clic su Invia per iniziare la procedura di rimozione dei nodi.

gcloud

Per eliminare un intero cluster utilizzando Google Cloud CLI, utilizza il comando gcloud vmware private-clouds clusters delete:

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

Sostituisci quanto segue:

CLUSTER_ID: l'ID del cluster da aggiornare in questo cloud privato
ZONE: la zona per il cloud privato
PRIVATE_CLOUD_ID: l'ID del cloud privato per il cloud privato

API

Per eliminare un intero cluster utilizzando l'API VMware Engine, effettua una richiesta 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"

Sostituisci quanto segue:

PROJECT_ID: l'ID progetto per il cloud privato
ZONE: la zona per il cloud privato
PRIVATE_CLOUD_ID: l'ID del cloud privato per il cloud privato
CLUSTER_ID: l'ID del cluster da aggiornare in questo cloud privato

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)

Elenca nodi

Per elencare i nodi del cluster di un determinato cloud privato e ottenere informazioni su più nodi o su un nodo specifico utilizzando la console Google Cloud, Google Cloud CLI o l'API VMware Engine, procedi nel seguente modo.

Console

Per elencare i nodi di uno o più cloud privati utilizzando la console Google Cloud:

Nella console Google Cloud, vai alla pagina Nuvole private.

Vai a Private Cloud
Nella pagina di riepilogo dei cloud privati, fai clic sul nome del cloud privato.
Nella pagina dei dettagli del cluster, fai clic sulla scheda Cluster.
Nella scheda Cluster, fai clic sul nome del cluster. Tutti i nodi del cluster sono elencati nella tabella dei nodi del cluster.

gcloud

Per elencare i nodi di uno o più private cloud utilizzando Google Cloud CLI, segui questi passaggi:

Elenca tutti i nodi associati al PRIVATE_CLOUD_ID di un determinato cloud privato eseguendo il 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
```
Sostituisci quanto segue:
- PROJECT_ID: il nome del progetto per questa richiesta.
- ZONE: la zona in cui si trova questa rete.
- PRIVATE_CLOUD_ID: l'ID rete per questa richiesta.
- CLUSTER_ID: l'ID cluster per questa richiesta.

API

Per elencare i nodi di uno o più cloud privati utilizzando l'API VMware Engine:

Elenca tutti i nodi associati al PRIVATE_CLOUD_ID di un determinato cloud privato inviando una richiesta GET:
```
GET "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID/clusters/CLUSTER_ID/nodes"
```
Sostituisci quanto segue:
- PROJECT_ID: il nome del progetto per questa richiesta.
- ZONE: la zona in cui si trova questa rete.
- PRIVATE_CLOUD_ID: l'ID rete per questa richiesta.
- CLUSTER_ID: l'ID cluster per questa richiesta.

Descrivere i nodi

Per ottenere una descrizione di uno o più nodi utilizzando la console Google Cloud, Google Cloud CLI o l'API VMware Engine, segui questi passaggi:

Console

Per elencare i nodi di uno o più cloud privati utilizzando la console Google Cloud:

Nella console Google Cloud, vai alla pagina Nuvole private.

Vai a Private Cloud
Nella pagina di riepilogo dei cloud privati, fai clic sul nome del cloud privato.
Nella pagina dei dettagli del cluster, fai clic sulla scheda Cluster.
Nella scheda Cluster, fai clic sul nome del cluster. I dettagli dei nodi sono elencati nella tabella dei nodi del cluster.

gcloud

Se vuoi ottenere la descrizione di uno o più nodi utilizzando Google Cloud CLI.

(Facoltativo) Trova il nome del nodo eseguendo il 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
```
Sostituisci quanto segue:
- PROJECT_ID: il nome del progetto per questa richiesta.
- ZONE: la zona in cui si trova questa rete.
- PRIVATE_CLOUD_ID: l'ID rete per questa richiesta.
- CLUSTER_ID: l'ID cluster per questa richiesta.
Per ottenere la descrizione di un nodo specifico, esegui il 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
```
Sostituisci quanto segue:
- NODE_NAME: il nome del nodo restituito dal comando precedente. Ad esempio, esxi-1435-f4d250.
- PROJECT_ID: il nome del progetto per questa richiesta.
- ZONE: la zona in cui si trova questa rete.
- PRIVATE_CLOUD_ID: l'ID rete per questa richiesta.
- CLUSTER_ID: l'ID cluster per questa richiesta.

API

Se vuoi ottenere la descrizione di uno o più nodi utilizzando l'API VMware Engine.

(Facoltativo) Trova il nome del nodo inviando una richiesta GET:
```
GET "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID/clusters/CLUSTER_ID/nodes"
```
Sostituisci quanto segue:
- PROJECT_ID: il nome del progetto per questa richiesta.
- ZONE: la zona in cui si trova questa rete.
- PRIVATE_CLOUD_ID: l'ID rete per questa richiesta.
- CLUSTER_ID: l'ID cluster per questa richiesta.
Per ottenere la descrizione di un nodo specifico, invia una richiesta GET:
```
GET "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID/clusters/CLUSTER_ID/nodes/NODE_NAME"
```
Sostituisci quanto segue:
- NODE_NAME: il nome del nodo restituito dal comando precedente. Ad esempio, esxi-1435-f4d250.
- PROJECT_ID: il nome del progetto per questa richiesta.
- ZONE: la zona in cui si trova questa rete.
- PRIVATE_CLOUD_ID: l'ID rete per questa richiesta.
- CLUSTER_ID: l'ID cluster per questa richiesta.

Limitazioni

La procedura di rimozione dei nodi dal cloud privato presenta le seguenti limitazioni:

Il cluster vSphere deve avere almeno tre nodi. Non puoi rimuovere i nodi da un cluster vSphere con tre nodi.
Indipendentemente dall'utilizzo della console Google Cloud, della gcloud CLI o dell'API VMware Engine, puoi rimuovere un solo nodo alla volta con ogni richiesta di rimozione del nodo.
Lo spazio di archiviazione totale consumato non può superare la capacità totale dopo la rimozione di nodi da un cluster.
Non puoi eliminare il primo cluster creato al momento della creazione del cloud privato.
Se le regole DRS di vSphere (affinità e anti-affinità) vengono applicate a tutti i nodi di un cluster, i nodi non possono essere rimossi dal cluster. Puoi eliminare le regole e riprovare l'operazione di rimozione dei nodi.

Visualizzazione delle subnet

Per visualizzare l'elenco delle subnet di gestione definite per il tuo cloud privato, seleziona la scheda Subnet. L'elenco include le subnet HCX create al momento della creazione del cloud privato.

Visualizzazione delle informazioni sulle attività

Per visualizzare le informazioni sull'attività del tuo cloud privato, fai clic su Vai a Visualizzatore dei log. Per un elenco completo delle attività e delle azioni associate, consulta Monitorare l'attività di VMware Engine.

Visualizzazione della rete di gestione vSphere

Per visualizzare l'elenco delle risorse di gestione VMware e delle macchine virtuali configurate sul tuo cloud privato, seleziona la scheda Rete di gestione vSphere. Le informazioni includono la versione del software, il nome di dominio completo (FQDN) e l'indirizzo IP delle risorse.