Creare un cloud privato a nodo singolo di VMware Engine

Questo documento descrive come creare un cloud privato a nodo singolo. I cloud privati a nodo singolo ti aiutano a iniziare a utilizzare Google Cloud VMware Engine per un utilizzo non di produzione, ad esempio per valutazioni pilota e proof of concept. I cloud privati a nodo singolo contengono un solo nodo e un solo cluster. Puoi espandere il cloud privato a nodo singolo a tre nodi in qualsiasi momento per convertirlo in un cloud privato standard.

Per informazioni concettuali sui cloud privati a nodo singolo, consulta Cloud privati a nodo singolo.

Requisiti di Google Cloud CLI e dell'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

  1. Imposta l'ID progetto predefinito:

    gcloud config set project PROJECT_ID

  2. Imposta una regione e una zona predefinite:

    gcloud config set compute/region REGION

    gcloud config set compute/zone ZONE

Per saperne di più 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 come parte della richiesta cURL. Esistono molti modi per ottenere un token di accesso valido; i seguenti passaggi utilizzano lo strumento gcloud per generare un token di accesso:

  1. Accedi a Google Cloud:

    gcloud auth login

  2. Genera il token di accesso ed esportalo in TOKEN:

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

  3. 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, è necessario installare la libreria e configurare le credenziali predefinite dell'applicazione.

  1. Scarica e installa la libreria Python:

    pip install google-cloud-vmwareengine

  2. Configura le informazioni ADC eseguendo questi comandi nella shell:

    gcloud auth application-default login

    In alternativa, utilizza un file di chiave dell'account di servizio:

    export GOOGLE_APPLICATION_CREDENTIALS="FILE_PATH"

Per saperne di più sulla libreria, visita la pagina di riferimento o visualizza gli esempi di codice su GitHub.

Prima di iniziare

Creare un cloud privato a nodo singolo

Crea un cloud privato a nodo singolo seguendo queste istruzioni.

Console

  1. Nella Google Cloud console, vai alla pagina Cloud privati.

    Vai a Cloud privati

  2. Fai clic su Seleziona un progetto e poi seleziona l'organizzazione, la cartella o il progetto
    in cui vuoi creare il cloud privato a nodo singolo.

  3. Fai clic su Crea.

  4. Seleziona Cloud privato standard.

  5. Seleziona una località in cui vuoi eseguire il deployment del cloud privato.

  6. Seleziona il tipo di nodo per il cluster primario.

  7. Seleziona Nodo singolo per creare un cloud privato a nodo singolo.

  8. Compila il resto dei dettagli del cloud privato e fai clic su Salva.

gcloud

Per creare un cloud privato a nodo singolo utilizzando gcloud CLI:

  1. (Facoltativo) Se non conosci i nomi delle regioni e delle zone disponibili per il tuo progetto, puoi elencarle eseguendo il comando gcloud vmware locations list:

    gcloud vmware locations list

  2. Per creare un cloud privato a nodo singolo, che scade dopo 60 giorni, utilizza il gcloud vmware private-clouds create comando:

    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

    Sostituisci quanto segue:

    • PRIVATE_CLOUD_ID: il nome di questo cloud privato.
    • CLUSTER_ID: l'ID cluster per questa richiesta
    • ZONE: la zona per questo cloud privato
    • IP_ADDRESS: l'indirizzo IP e l'intervallo per questo cloud privato, ad esempio 192.168.1.0/24
    • REGION: la regione per questo cloud privato

    Esempio di output:

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

  3. (Facoltativo) Se vuoi controllare lo stato della creazione del cloud privato, utilizza i comandi 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

    L'output è simile al seguente:

    NAME                  PROJECT       LOCATION  CREATE_TIME STATE         VCENTER_FQDN
PRIVATE_CLOUD_ID      PROJECT_ID    ZONE      2023-03-01T13:08:21.507Z  CREATING VCENTER_FQDN

  4. (Facoltativo) Se vuoi controllare i dettagli del cloud privato, esegui il gcloud vmware private-clouds describe comando:

    gcloud vmware private-clouds describe PRIVATE_CLOUD_ID \
   --location=ZONE

  5. Recupera le credenziali di vCenter e NSX, rispettivamente, eseguendo gcloud vmware private-clouds credentials describe comando:

    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

Per creare un cloud privato a nodo singolo utilizzando l'API VMware Engine:

  1. Crea un cloud privato a nodo singolo (scade dopo 60 giorni) effettuando una richiesta 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"
}

    Sostituisci quanto segue:

    • PROJECT_ID: il progetto per questa richiesta
    • ZONE: la zona per questo cloud privato
    • PRIVATE_CLOUD_ID: il nome del cloud privato per questa richiesta
    • REGION: la regione per questo cloud privato
    • CLUSTER_ID: l'ID cluster per questa richiesta

  2. (Facoltativo) Controlla lo stato della creazione del cloud privato (potrebbe richiedere fino a due ore) effettuando una richiesta POST all'operazione:

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

    Elenca i cloud privati in una zona effettuando una richiesta POST:

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

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID per questa richiesta
    • ZONE: la zona per questo cloud privato
    • OPERATION_ID: l'ID operazione per questo cloud privato

  3. (Facoltativo) Recupera i dettagli del cloud privato effettuando una richiesta GET:

    GET https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID
    • PROJECT_ID: l'ID per questo progetto
    • PRIVATE_CLOUD_ID: l'ID per questo cloud privato
    • ZONE: la zona per questo cloud privato

  4. Recupera le credenziali di vCenter e NSX, rispettivamente, effettuando richieste GET separate:

    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

Sono necessari circa 30 minuti o 2 ore prima che VMware Engine impieghi per creare il cloud privato e renderlo disponibile per l'accesso dalla Google Cloud console.

Passaggi successivi