Creazione di un cloud privato VMware Engine

Un cloud privato è uno stack VMware isolato composto da host ESXi, vCenter, vSAN, NSX-T e HCX. Puoi gestire i cloud privati tramite nella console Google Cloud. Quando crei un cloud privato, ottieni Cluster vSphere e tutte le VM di gestione create nel cluster.

VMware Engine esegue il deployment dei componenti di gestione nella rete per le subnet vSphere/vSAN. L'intervallo di indirizzi IP di rete è suddiviso in da subnet diverse durante il deployment.

Prima di iniziare

Prima di eseguire le attività in questa pagina, esegui il prerequisito seguente passaggi.

Lo spazio di indirizzi della subnet vSphere/vSAN non deve sovrapporsi a nessuna rete comunicherà con il cloud privato, ad esempio le reti on-premise Reti VPC (Virtual Private Cloud) di Google Cloud. Per ulteriori informazioni Subnet vSphere o vSAN, vedi VLAN e subnet su VMware Engine.

Requisiti delle API e di Google Cloud CLI

Per utilizzare lo strumento a riga di comando gcloud o l'API per gestire VMware Engine per le risorse, 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 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 una query sull'API. È richiesto un token di accesso valido nell'ambito di cURL richiesta. Esistono molti modi per ottenere un token di accesso valido; quanto segue 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 esporta 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 chiavi dell'account di servizio:

    export GOOGLE_APPLICATION_CREDENTIALS="FILE_PATH"

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

Crea un cloud privato

Console

Per creare un cloud privato utilizzando la console Google Cloud, segui questi passaggi:

  1. Accedi alla console Google Cloud.
  2. Nella barra di navigazione principale, fai clic su Cloud privati.
  3. Fai clic su Crea.
  4. Seleziona la località in cui vuoi eseguire il deployment del cloud privato.
  5. Seleziona il tipo di nodo per il cluster principale.
  6. Seleziona il numero di nodi per il cloud privato. Per i carichi di lavoro di produzione, il tuo cloud privato con almeno tre nodi. VMware Engine elimina i cloud privati contenenti un solo nodo dopo 60 giorni.
  7. (Facoltativo) Fai clic sul pulsante di attivazione/disattivazione Personalizza i core se vuoi ridurre il di core disponibili per ciascun nodo nel cluster di gestione. Per Per maggiori dettagli, consulta Conteggio dei core personalizzati.
  8. Inserisci un intervallo CIDR per la rete di gestione VMware. Per informazioni su limitazioni applicate a questo intervallo, consulta la sezione Prima di iniziare. .
  9. Inserisci un intervallo CIDR per la rete di deployment HCX, utilizzato per deployment dei componenti HCX. Assicurati che l'intervallo CIDR non si sovrapponga con qualsiasi subnet on-premise o cloud. L'intervallo CIDR deve essere /27 o successiva.
  10. Fai clic su Rivedi e crea.
  11. Rivedi le impostazioni. Per modificare le impostazioni, fai clic su Indietro.
  12. Fai clic su Crea per avviare il provisioning del cloud privato.

Nell'elenco seguente vengono descritti tutti i campi presenti durante la creazione del cloud privato dettaglio:

  • Nome: identificatore univoco permanente del cloud privato.
  • Descrizione: informazioni aggiuntive visibili nella pagina dei dettagli del cloud privato.
  • Regione: la regione geografica in cui VMware Engine ospita il tuo e cloud privato.
  • Zona: sottoinsieme di una regione fisicamente isolata da altre zone della nella stessa regione. Una zona è un singolo dominio in errore all'interno di una regione.
  • Nome del cluster principale: il nome assegnato al cluster vSphere iniziale nella tua e cloud privato. Le appliance di gestione VMware del tuo cloud privato vengono eseguite su questo in un cluster Kubernetes.
  • Tipo di nodo: configurazione hardware dei nodi nel cluster principale.
  • Nodi: numero di nodi nel cluster principale.

  • Intervallo di indirizzi IP di gestione: intervallo di indirizzi IP utilizzato per vCenter Server, NSX Manager, host ESXi e altre parti dell'infrastruttura del cloud privato. Questo intervallo non viene utilizzato per le VM dei carichi di lavoro e non deve sovrapporsi a nessuna parte dei la tua rete VPC o qualsiasi altra rete a cui prevedi di connettere cloud.
  • Rete VMware Engine: risorsa di rete che gestisce le risorse private connessioni cloud in base a un criterio di rete. Tu e le risorse connessi a questa rete VMware Engine possono accedere al cloud privato all'interno di Google Cloud.

gcloud

Per creare un cloud privato esteso utilizzando Google Cloud CLI, segui questi passaggi passaggi:

  1. (Facoltativo) Elenca le regioni e le zone disponibili per il tuo progetto in base a eseguendo il comando gcloud vmware locations list.

    gcloud vmware locations list \
    --project=PROJECT_ID

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID progetto per questa richiesta

  2. Crea una rete per il cloud privato eseguendo Comando gcloud vmware networks create.

    gcloud vmware networks create NETWORK_NAME \
    --type=LEGACY \
    --location=REGION \
    --description="DESCRIPTION"

    Sostituisci quanto segue:

    • NETWORK_NAME: il nome della rete per cloud privato
    • REGION: la regione per il cloud privato
    • DESCRIPTION: una descrizione per l'elemento privato cloud

    La richiesta restituisce un ID operazione.

  3. Verifica lo stato dell'operazione eseguendo il comando Comando gcloud vmware operations describe. Quando l'operazione restituisce DONE, controlla la risposta per verificare se operazione riuscita:

    gcloud vmware operations describe OPERATION_ID \
    --location REGION

    Sostituisci quanto segue:

    • OPERATION_ID: l'ID del passaggio precedente
    • REGION: la regione per il cloud privato

  4. Crea un cloud privato a tre nodi eseguendo il comando Comando gcloud vmware private-clouds create.

    gcloud vmware private-clouds create PRIVATE_CLOUD_ID \
  --location=ZONE \
  --cluster=CLUSTER_ID \
  --node-type-config=type=NODE_TYPE,count=NODE_COUNT \
  --management-range=`IP_ADDRESS` \
  --vmware-engine-network=NETWORK_NAME

    Sostituisci quanto segue:

    • PRIVATE_CLOUD_ID: il nome del privato cloud.
    • ZONE: la zona per il cloud privato.
    • CLUSTER_ID: il nome del nuovo cluster in questo cloud privato.
    • NODE_TYPE: tipo di nodo. Per ulteriori informazioni per ulteriori informazioni, consulta Tipi di nodi.
    • NODE_COUNT: il numero di nodi. Specifica un valore di tre o più.
    • IP_ADDRESS: l'indirizzo IP, ad esempio 192.168.0.0/24, per questa richiesta.
    • NETWORK_NAME: nome della rete per questa cloud.

    La richiesta restituisce un ID operazione che puoi utilizzare per verificare l'avanzamento dell'operazione.

  5. Verifica lo stato dell'operazione eseguendo il comando Comando gcloud vmware operations describe. Quando l'operazione restituisce DONE, controlla la risposta per verificare se operazione completata correttamente.

    gcloud vmware operations describe OPERATION_ID \
    --location REGION

    Sostituisci quanto segue:

    • OPERATION_ID: l'ID del passaggio precedente
    • REGION: la regione per il cloud privato

  6. Connetti la rete VMware Engine al tuo VPC tramite configurazione dell'accesso privato ai servizi.

  7. Recupera le credenziali vCenter e NSX-T eseguendo il comando gcloud vmware private-clouds vcenter credentials describe e gcloud vmware private-clouds nsx credentials describe.

    gcloud vmware private-clouds vcenter credentials describe \
    --private-cloud=PRIVATE_CLOUD_ID \
    --location=ZONE
    gcloud vmware private-clouds nsx credentials describe \
    --private-cloud=PRIVATE_CLOUD_ID \
    --location=ZONE

    Sostituisci quanto segue:

    • PRIVATE_CLOUD_ID: l'ID per il privato cloud
    • ZONE: la zona per il cloud privato

API

Per creare un cloud privato esteso utilizzando l'API VMware Engine, segui questi passaggi:

  1. Crea una rete legacy effettuando una richiesta POST.

    curl -X POST -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json; charset=utf-8" https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/vmwareEngineNetworks?vmwareEngineNetworkId=NETWORK_NAME -d "{"type": "legacy"}"

    Sostituisci quanto segue:

    • TOKEN: il token di autorizzazione per questa richiesta richiesta
    • PROJECT_ID: il progetto per questa richiesta
    • REGION: la regione in cui creare questa rete
    • NETWORK_NAME: il nome della rete per cloud privato

    La richiesta restituisce un ID operazione che puoi utilizzare per verificare l'avanzamento dell'operazione.

  2. Controlla lo stato dell'operazione effettuando una richiesta GET. Quando l'operazione restituisce DONE, controlla la risposta per verificare se Operazione riuscita:

    curl -X GET -H "Authorization: Bearer TOKEN"  -H "Content-Type: application/json; charset=utf-8" https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/operations/OPERATION_ID

    Sostituisci OPERATION_ID con l'ID del passaggio precedente.

  3. Crea un cloud privato a tre nodi effettuando una richiesta POST:

    curl -X POST -H "Authorization: Bearer TOKEN"  -H "Content-Type: application/json; charset=utf-8" https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds?privateCloudId=PRIVATE_CLOUD_ID -d "{
"networkConfig":{
  "vmwareEngineNetwork":"projects/PROJECT_ID/locations/REGION/vmwareEngineNetworks/NETWORK_NAME",
  "managementCidr":"10.241.0.0/22"
   },
"managementCluster":{
  "clusterId": "CLUSTER_ID",
  "nodeTypeConfigs": {
  "standard-72": {
    "nodeCount": NODE_COUNT
   }
  }
 }
}"

    Sostituisci quanto segue:

    • TOKEN: il token di autorizzazione per questa richiesta richiesta.
    • PROJECT_ID: l'ID progetto per questa richiesta
    • ZONE: la zona per il cloud privato
    • PRIVATE_CLOUD_ID: l'ID per il cloud privato
    • REGION: la regione della rete per questo cloud privato
    • NETWORK_NAME: il nome della rete per cloud privato
    • CLUSTER_ID: l'ID del nuovo cluster in questo cloud privato
    • NODE_COUNT: il numero di nodi. Specifica un valore di tre o più.

    La richiesta restituisce un ID operazione che puoi utilizzare per verificare l'avanzamento dell'operazione.

  4. Controlla lo stato dell'operazione effettuando una richiesta GET. Quando l'operazione restituisce DONE, controlla la risposta per verificare se ha avuto esito positivo:

    curl -X GET -H "Authorization: Bearer TOKEN"  -H "Content-Type: application/json; charset=utf-8" https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/operations/OPERATION_ID

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID progetto per questa richiesta
    • REGION: la regione per il cloud privato
    • OPERATION_ID: l'ID del passaggio precedente

  5. Connetti la rete VMware Engine al tuo VPC tramite configurazione dell'accesso privato ai servizi.

  6. Recupera le credenziali vCenter e NSX-T effettuando richieste GET:

    curl -X GET -H "Authorization: Bearer \"TOKEN"\"  -H "Content-Type: application/json; charset=utf-8" "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID:showVcenterCredentials"

    curl -X GET -H "Authorization: Bearer \"TOKEN"\"  -H "Content-Type: application/json; charset=utf-8" "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID:showNsxCredentials"

    Sostituisci quanto segue:

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

Python

  1. Crea una rete legacy.

    from google.cloud import vmwareengine_v1

TIMEOUT = 1200  # 20 minutes


def create_legacy_network(
    project_id: str, region: str
) -> vmwareengine_v1.VmwareEngineNetwork:
    """
    Creates a new legacy network.

    Args:
        project_id: name of the project you want to use.
        region: name of the region you want to use. I.e. "us-central1"

    Returns:
        The newly created VmwareEngineNetwork object.
    """
    network = vmwareengine_v1.VmwareEngineNetwork()
    network.description = (
        "Legacy network created using vmwareengine_v1.VmwareEngineNetwork"
    )
    network.type_ = vmwareengine_v1.VmwareEngineNetwork.Type.LEGACY

    request = vmwareengine_v1.CreateVmwareEngineNetworkRequest()
    request.parent = f"projects/{project_id}/locations/{region}"
    request.vmware_engine_network_id = f"{region}-default"
    request.vmware_engine_network = network

    client = vmwareengine_v1.VmwareEngineClient()
    result = client.create_vmware_engine_network(request, timeout=TIMEOUT).result()

    return result

  2. Creare un cloud privato a tre nodi.

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

DEFAULT_MANAGEMENT_CIDR = "192.168.0.0/24"
DEFAULT_NODE_COUNT = 3


def create_private_cloud(
    project_id: str, zone: str, network_name: str, cloud_name: str, cluster_name: str
) -> operation.Operation:
    """
    Creates a new Private Cloud using VMWare Engine.

    Creating a new Private Cloud is a long-running operation and it may take over an hour.

    Args:
        project_id: name of the project you want to use.
        zone: the zone you want to use, i.e. "us-central1-a"
        network_name: name of the VMWareNetwork to use for the new Private Cloud
        cloud_name: name of the new Private Cloud
        cluster_name: name for the new cluster in this Private Cloud

    Returns:
        An operation object representing the started operation. You can call its .result() method to wait for it to finish.
    """
    request = vmwareengine_v1.CreatePrivateCloudRequest()
    request.parent = f"projects/{project_id}/locations/{zone}"
    request.private_cloud_id = cloud_name

    request.private_cloud = vmwareengine_v1.PrivateCloud()
    request.private_cloud.management_cluster = (
        vmwareengine_v1.PrivateCloud.ManagementCluster()
    )
    request.private_cloud.management_cluster.cluster_id = cluster_name

    node_config = vmwareengine_v1.NodeTypeConfig()
    node_config.node_count = DEFAULT_NODE_COUNT

    # Currently standard-72 is the only supported node type.
    request.private_cloud.management_cluster.node_type_configs = {
        "standard-72": node_config
    }

    request.private_cloud.network_config = vmwareengine_v1.NetworkConfig()
    request.private_cloud.network_config.vmware_engine_network = network_name
    request.private_cloud.network_config.management_cidr = DEFAULT_MANAGEMENT_CIDR

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

    La funzione create_private_cloud restituisce un oggetto operazioni che puoi per verificare l'avanzamento dell'operazione.

  3. Controlla lo stato dell'operazione. Recupera informazioni attuali su un operativa.

    from google.cloud import vmwareengine_v1
from google.longrunning.operations_pb2 import GetOperationRequest


def get_operation_by_name(operation_name: str) -> Operation:
    """
    Retrieve detailed information about an operation.

    Args:
        operation_name: name identifying an operation you want to check.
            Expected format: projects/{project_id}/locations/{region}/operations/{operation_id}

    Returns:
        Operation object with details.
    """
    client = vmwareengine_v1.VmwareEngineClient()
    request = GetOperationRequest()
    request.name = operation_name
    return client.get_operation(request)


def get_operation(project_id: str, region: str, operation_id: str) -> Operation:
    """
    Retrieve detailed information about an operation.

    Args:
        project_id: name of the project running the operation.
        region: name of the region in which the operation is running.
        operation_id: identifier of the operation.

    Returns:
        Operation object with details.
    """
    return get_operation_by_name(
        f"projects/{project_id}/locations/{region}/operations/{operation_id}"
    )

    Puoi utilizzare il metodo membro .result() dell'oggetto dell'operazione da attendere completarlo.

  4. Connetti la rete VMware Engine al tuo VPC tramite configurazione dell'accesso privato ai servizi.

  5. Recupera le credenziali vCenter e NSX-T.

    from google.cloud import vmwareengine_v1


def get_vcenter_credentials(
    project_id: str, zone: str, private_cloud_name: str
) -> vmwareengine_v1.Credentials:
    """
    Retrieves VCenter credentials for a Private Cloud.

    Args:
        project_id: name of the project hosting the private cloud.
        zone: name of the zone hosting the private cloud.
        private_cloud_name: name of the private cloud.

    Returns:
        A Credentials object.
    """
    client = vmwareengine_v1.VmwareEngineClient()
    credentials = client.show_vcenter_credentials(
        private_cloud=f"projects/{project_id}/locations/{zone}/privateClouds/{private_cloud_name}"
    )
    return credentials


    from google.cloud import vmwareengine_v1


def get_nsx_credentials(
    project_id: str, zone: str, private_cloud_name: str
) -> vmwareengine_v1.Credentials:
    """
    Retrieves NSX credentials for a Private Cloud.

    Args:
        project_id: name of the project hosting the private cloud.
        zone: name of the zone hosting the private cloud.
        private_cloud_name: name of the private cloud.

    Returns:
        A Credentials object.
    """
    client = vmwareengine_v1.VmwareEngineClient()
    credentials = client.show_nsx_credentials(
        private_cloud=f"projects/{project_id}/locations/{zone}/privateClouds/{private_cloud_name}"
    )
    return credentials

Durante la creazione del nuovo cloud privato, VMware Engine esegue il deployment numero di componenti VMware e divide di indirizzi IP fornito nelle subnet. La creazione del cloud privato può richiedere 30 minuti o 2 ore. Al termine del provisioning, riceverai email.

Passaggi successivi