Créer un cloud privé VMware Engine

Un cloud privé est une pile VMware isolée constituée d'hôtes ESXi, d'un serveur vCenter et des composants vSAN, NSX-T et HCX. Vous gérez les clouds privés via la console Google Cloud. Lorsque vous créez un cloud privé, vous obtenez un seul cluster vSphere et toutes les VM de gestion créées dans ce cluster.

VMware Engine déploie les composants de gestion sur le réseau que vous sélectionnez pour les sous-réseaux vSphere/vSAN. La plage d'adresses IP du réseau est divisée en différents sous-réseaux pendant le déploiement.

Avant de commencer

Avant d'effectuer les tâches indiquées sur cette page, suivez les étapes préalables suivantes.

Allouez une plage d'adresses IP unique pour les sous-réseaux vSphere/vSAN du cloud privé que vous souhaitez créer.
- Préfixe de la plage CIDR minimale : /24
- Préfixe de plage CIDR maximale:/20
Si vous souhaitez effectuer une résolution d'adresses globale à l'aide de Cloud DNS, activez l'API Cloud DNS et terminez la configuration de Cloud DNS avant de créer votre cloud privé.

L'espace d'adressage de sous-réseau vSphere/vSAN ne doit chevaucher aucun réseau qui communique avec le cloud privé, tel que des réseaux sur site et les réseaux de cloud privés virtuels (VPC) Google Cloud. Pour en savoir plus sur les sous-réseaux vSphere ou vSAN, consultez la page VLAN et sous-réseaux sur VMware Engine.

Conditions requises pour la Google Cloud CLI et les API

Pour gérer vos ressources VMware Engine à l'aide de l'outil de ligne de commande gcloud ou de l'API, nous vous recommandons de configurer les outils comme décrit ci-dessous.

gcloud

Définissez votre ID de projet par défaut :
```
gcloud config set project PROJECT_ID
```

Définissez une région et une zone par défaut :

gcloud config set compute/region REGION

gcloud config set compute/zone ZONE

Pour en savoir plus sur l'outil gcloud vmware, consultez la documentation de référence de Cloud SDK Cloud.

API

Les exemples d'API de cette documentation utilisent l'outil de ligne de commande cURL pour interroger l'API. Vous devez indiquer un jeton d'accès valide dans la requête cURL. Il existe de nombreuses façons d'obtenir un jeton d'accès valide. Les étapes suivantes font appel à l'outil gcloud pour générer un jeton d'accès:

Connectez-vous à Google Cloud:
```
gcloud auth login
```
Générez un jeton d'accès et exportez-le vers TOKEN:
```
export TOKEN=`gcloud auth print-access-token`
```
Vérifiez que TOKEN est correctement défini:
```
echo $TOKEN
```

À présent, utilisez le jeton d'autorisation dans vos requêtes adressées à l'API. Exemple :

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

Les exemples de code Python présentés dans cette documentation utilisent la bibliothèque VMware Engine pour communiquer avec l'API. Pour que vous puissiez utiliser cette approche, la bibliothèque doit être installée et les identifiants par défaut de l'application doivent être configurés.

Téléchargez et installez la bibliothèque Python:
```
pip install google-cloud-vmwareengine
```
Configurez les informations relatives à l'ADC en exécutant ces commandes dans votre shell:
```
gcloud auth application-default login
```
Vous pouvez également utiliser un fichier de clé de compte de service:
```
export GOOGLE_APPLICATION_CREDENTIALS="FILE_PATH"
```

Pour en savoir plus sur la bibliothèque, consultez la page de référence ou les exemples de code sur GitHub.

Créer un cloud privé

Console

Pour créer un cloud privé à l'aide de la console Google Cloud, procédez comme suit:

Accédez à la console Google Cloud.
Dans le menu de navigation principal, cliquez sur Private clouds (Clouds privés).
Cliquez sur Créer.
Sélectionnez l'emplacement où vous souhaitez déployer le cloud privé.
Sélectionnez le type de nœud pour votre cluster principal.
Sélectionnez le nombre de nœuds du cloud privé. Pour les charges de travail de production, créez votre cloud privé avec au moins trois nœuds. VMware Engine supprime les clouds privés qui ne contiennent qu'un seul nœud après 60 jours.
Facultatif : Cliquez sur le bouton d'activation Personnaliser les cœurs si vous souhaitez réduire le nombre de cœurs disponibles pour chaque nœud du cluster de gestion. Pour en savoir plus, consultez la section Nombre de cœurs personnalisé.
Saisissez une plage CIDR pour le réseau de gestion VMware. Pour en savoir plus sur les restrictions de cette plage, consultez la section Avant de commencer.
Saisissez une plage CIDR pour le réseau de déploiement HCX, qui sera utilisée pour déployer les composants HCX. Assurez-vous que la plage CIDR ne chevauche aucun de vos sous-réseaux sur site ou dans le cloud. La plage CIDR doit être /27 ou supérieure.
Cliquez sur Review and Create (Vérifier et créer).
Vérifiez les paramètres. Pour modifier les paramètres, cliquez sur Retour.
Cliquez sur Créer pour commencer à provisionner le cloud privé.

La liste suivante décrit plus en détail chaque champ à renseigner lors de la création du cloud privé :

Name (Nom) : identifiant unique et permanent du cloud privé.
Description:informations supplémentaires visibles sur la page d'informations du cloud privé.
Region (Région) : région géographique dans laquelle VMware Engine héberge votre cloud privé.
Zone:sous-ensemble d'une région physiquement isolé des autres zones de la même région. Une zone est un domaine de défaillance unique au sein d'une région.
Nom du cluster principal:nom donné au cluster vSphere initial dans votre cloud privé. Les dispositifs de gestion VMware de votre cloud privé s'exécutent sur ce cluster.
Type de nœud: configuration matérielle des nœuds de votre cluster principal.
Nodes (Nœuds) : nombre de nœuds dans le cluster principal.

Management IP address range (Plage d'adresses IP de gestion) : plage d'adresses IP utilisée pour vCenter Server, NSX Manager, les hôtes ESXi et d'autres parties de l'infrastructure du cloud privé. Cette plage n'est pas utilisée pour les VM de charge de travail et ne doit chevaucher aucune partie de votre réseau VPC, ni de tout autre réseau auquel vous prévoyez de connecter votre cloud privé.
Réseau VMware Engine: ressource réseau qui gère les connexions cloud privées conformément à une règle de réseau. Vous et les ressources connectées à ce réseau VMware Engine pouvez accéder au cloud privé depuis Google Cloud.

gcloud

Pour créer un cloud privé étendu à l'aide de la Google Cloud CLI, procédez comme suit:

(Facultatif) Répertoriez les régions et les zones disponibles pour votre projet en exécutant la commande gcloud vmware locations list.
```
gcloud vmware locations list \
    --project=PROJECT_ID
```
Remplacez les éléments suivants :
- PROJECT_ID : ID du projet pour cette requête
Créez un réseau pour votre cloud privé en exécutant la commande gcloud vmware networks create.
```
gcloud vmware networks create NETWORK_NAME \
    --type=LEGACY \
    --location=REGION \
    --description="DESCRIPTION"
```
Remplacez les éléments suivants :
- NETWORK_NAME: nom du réseau pour le cloud privé
- REGION: région du cloud privé
- DESCRIPTION: description du cloud privé
La requête renvoie un ID d'opération.
Vérifiez l'état de l'opération en exécutant la commande gcloud vmware operations describe. Lorsque l'opération est renvoyée sous la forme DONE, vérifiez la réponse pour voir si l'opération a réussi:
```
gcloud vmware operations describe OPERATION_ID \
    --location REGION
```
Remplacez les éléments suivants :
- OPERATION_ID: ID de l'étape précédente
- REGION: région du cloud privé
Créez un cloud privé à trois nœuds en exécutant la commande gcloud vmware private-clouds create.
```
gcloud vmware private-clouds create PRIVATE_CLOUD_ID \
  --location=ZONE \
  --cluster=CLUSTER_ID \
  --node-type-config=type=standard-72,count=NODE_COUNT \
  --management-range=`IP_ADDRESS` \
  --vmware-engine-network=NETWORK_NAME
```
Remplacez les éléments suivants :
- PRIVATE_CLOUD_ID: nom du cloud privé
- ZONE: zone du cloud privé
- CLUSTER_ID: nom du nouveau cluster dans ce cloud privé
- NODE_COUNT: nombre de nœuds. Spécifiez une valeur de trois ou plus.
- IP_ADDRESS: adresse IP (par exemple, 192.168.0.0/24) pour cette requête
- NETWORK_NAME: nom du réseau pour ce cloud.
La requête renvoie un ID d'opération que vous pouvez utiliser pour vérifier la progression de l'opération.
Vérifiez l'état de l'opération en exécutant la commande gcloud vmware operations describe. Lorsque l'opération est renvoyée avec l'état DONE, vérifiez la réponse pour voir si l'opération a réussi.
```
gcloud vmware operations describe OPERATION_ID \
    --location REGION
```
Remplacez les éléments suivants :
- OPERATION_ID: ID de l'étape précédente
- REGION: région du cloud privé
Connectez le réseau VMware Engine à votre VPC en configurant l'accès aux services privés.
Récupérez les identifiants vCenter et NSX-T en exécutant respectivement les commandes gcloud vmware private-clouds vcenter credentials describe et 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
```
Remplacez les éléments suivants :
- PRIVATE_CLOUD_ID: ID du cloud privé
- ZONE: zone du cloud privé

API

Pour créer un cloud privé étendu à l'aide de l'API VMware Engine, procédez comme suit:

Créez un ancien réseau en envoyant une requête 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"}"
```
Remplacez les éléments suivants :
- TOKEN: jeton d'autorisation pour cette requête.
- PROJECT_ID: projet concerné par cette requête
- REGION: région dans laquelle créer ce réseau.
- NETWORK_NAME: nom du réseau pour le cloud privé
La requête renvoie un ID d'opération que vous pouvez utiliser pour vérifier la progression de l'opération.
Vérifiez l'état de l'opération en envoyant une requête GET. Lorsque l'opération est renvoyée sous la forme DONE, vérifiez la réponse pour voir si l'opération a réussi:
```
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
```
Remplacez OPERATION_ID par l'ID de l'étape précédente.
Créez un cloud privé à trois nœuds en effectuant une requête 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
   }
  }
 }
}"
```
Remplacez les éléments suivants :
- TOKEN: jeton d'autorisation pour cette requête.
- PROJECT_ID : ID du projet pour cette requête
- ZONE: zone du cloud privé
- PRIVATE_CLOUD_ID: ID du cloud privé
- REGION: région du réseau pour ce cloud privé
- NETWORK_NAME: nom du réseau pour le cloud privé
- CLUSTER_ID: ID du nouveau cluster dans ce cloud privé
- NODE_COUNT: nombre de nœuds. Spécifiez une valeur de trois ou plus.
La requête renvoie un ID d'opération que vous pouvez utiliser pour vérifier la progression de l'opération.
Vérifiez l'état de l'opération en envoyant une requête GET. Lorsque l'opération est renvoyée sous la forme DONE, vérifiez la réponse pour voir si l'opération a réussi:
```
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
```
Remplacez les éléments suivants :
- PROJECT_ID : ID du projet pour cette requête
- REGION: région du cloud privé
- OPERATION_ID: ID de l'étape précédente
Connectez le réseau VMware Engine à votre VPC en configurant l'accès aux services privés.

Récupérez les identifiants vCenter et NSX-T en effectuant des requêtes 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"

Remplacez les éléments suivants :

PROJECT_ID : ID du projet pour cette requête
ZONE: zone du cloud privé
PRIVATE_CLOUD_ID: ID du cloud privé

Python

Créez un ancien réseau.

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

Créer un cloud privé à trois nœuds

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 fonction create_private_cloud renvoie un objet Operations que vous pouvez utiliser pour vérifier la progression de l'opération.

Vérifiez l'état de l'opération. Récupérez les informations actuelles sur une opération.

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

Vous pouvez utiliser la méthode membre .result() de l'objet d'opération pour attendre la fin de l'opération.

Connectez le réseau VMware Engine à votre VPC en configurant l'accès aux services privés.

Récupérez les identifiants vCenter et 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

Lorsque VMware Engine crée votre cloud privé, il déploie plusieurs composants VMware et divise la plage d'adresses IP fournie en sous-réseaux. La création d'un cloud privé peut prendre de 30 minutes à 2 heures. Une fois le provisionnement terminé, vous recevrez un e-mail.

Créer un cloud privé VMware Engine

Avant de commencer

Conditions requises pour la Google Cloud CLI et les API

gcloud

API

Python

Créer un cloud privé

Console

gcloud

API

Python

Étapes suivantes