Créer un cloud privé à nœud unique VMware Engine

Ce document explique comment créer un cloud privé à nœud unique. Les clouds privés à nœud unique vous permettent de vous familiariser avec Google Cloud VMware Engine avec une utilisation hors production, telles que des pilotes et des évaluations de démonstration de faisabilité. Les clouds privés à nœud unique ne contiennent qu'un nœud et un cluster. Ils sont limités dans le temps et supprimés automatiquement au bout de 60 jours. Vous pouvez étendre votre cloud privé à nœud unique à trois nœuds à tout moment pour le convertir en cloud privé standard.

Pour obtenir des informations conceptuelles sur les clouds privés à nœud unique, consultez la section Clouds privés à nœud unique.

Exigences concernant gcloud et l'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

  1. Définissez votre ID de projet par défaut :

    gcloud config set project PROJECT_ID
    
  2. Définissez une région et/ou 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. La requête cURL requiert un jeton d'accès valide. Il existe de nombreuses façons d'obtenir un jeton d'accès valide. Les étapes suivantes utilisent l'outil gcloud pour générer un jeton d'accès:

  1. Se connecter à Google Cloud

    gcloud auth login
    
  2. Générer un jeton d'accès et exporter vers TOKEN

    export TOKEN=`gcloud auth print-access-token`
    
  3. Vérifier que TOKEN est correctement défini

    echo $TOKEN
    
    Output:
    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 utiliser cette approche, vous devez installer la bibliothèque et configurer les identifiants par défaut de l'application.

  1. Télécharger et installer la bibliothèque Python

     pip install google-cloud-vmwareengine
    
  2. Configurez les informations ADC en exécutant ces commandes dans votre shell.

      gcloud auth application-default login
    

    ou 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 affichez des exemples de code sur GitHub.

Avant de commencer

Créer un cloud privé à nœud unique

Créez un cloud privé à nœud unique à l'aide de Google Cloud CLI ou de l'API VMware Engine:

gcloud

Pour créer un cloud privé à nœud unique à l'aide de la gcloud CLI, procédez comme suit:

  1. Facultatif: Si vous ne connaissez pas le nom des régions et des zones disponibles pour votre projet, vous pouvez les répertorier en exécutant la commande gcloud vmware locations list:

    gcloud vmware locations list
    
  2. Pour créer un cloud privé à nœud unique, qui expire au bout de 60 jours, utilisez la commande gcloud vmware private-clouds create:

      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

    Remplacez les éléments suivants :

    • CLUSTER_ID: ID du cluster pour cette requête.
    • ZONE: zone de ce cloud privé.
    • IP_ADDRESS: adresse IP et plage d'adresses de ce cloud privé, par exemple 192.168.1.0/24.
    • REGION: région de ce cloud privé.

    Exemple de sortie:

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

  3. Facultatif: Si vous souhaitez vérifier l'état de la création du cloud privé, utilisez les commandes gcloud vmware operations describe et gcloud vmware private-clouds list. Cette opération peut prendre jusqu'à deux heures.

      gcloud vmware operations describe OPERATION_ID 
    --location=ZONE
      gcloud vmware private-clouds list 
    --location=ZONE

    Exemple de sortie:

    NAME                  PROJECT       LOCATION
    CREATE_TIME STATE                   VCENTER_FQDN
    -private-cloud     2023-03-01T13:08:21.507Z
    CREATING .
    
  4. Facultatif: Si vous souhaitez vérifier les détails du cloud privé, exécutez la commande gcloud vmware private-clouds describe suivante:

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

  5. Obtenez respectivement les identifiants vCenter et NSX-T en exécutant les commandes gcloud vmware private-clouds credentials describe:

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

API

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

  1. Créez un cloud privé à nœud unique (expire après 60 jours) en envoyant une requête POST:

    POST "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds?private_cloud_id=PRIVATE_CLOUD_ID-private-cloud
    " -d '{
      "description": "test private cloud for user guide",
      "network_config": {
        "vmware_engine_network": "projects/PROJECT_ID/locations/REGION/vmwareEngineNetworks/REGION-default",
        "management_cidr": "192.168.0.0/24"
    },
        "management_cluster": {
        "cluster_id": "PRIVATE_CLOUD_ID-cluster",
        "node_type_configs": {
          "standard-72": {
            "node_count": 1
          }
        }
      },
      "type": "TIME_LIMITED"
    }'
    

    Remplacez les éléments suivants :

    • PROJECT_ID: projet concerné par cette requête
    • ZONE: zone de ce cloud privé.
    • PRIVATE_CLOUD_ID: ID du cloud privé pour cette requête.
    • REGION: région de ce cloud privé.
  2. Facultatif: Vérifiez l'état de la création du cloud privé (cela peut prendre jusqu'à deux heures) en envoyant une requête POST:

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

    Répertoriez les clouds privés d'une zone en envoyant une requête POST:

    POST "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds
  3. Facultatif: Obtenez des informations sur le cloud privé en envoyant une requête GET:

    GET "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID-private-cloud"
    
  4. Obtenez respectivement les identifiants vCenter et NSX-T en effectuant des requêtes GET distinctes:

    GET "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID-private-cloud:showVcenterCredentials"
    
    GET "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID-private-cloud:showNsxCredentials"
    

Étapes suivantes