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

Ce document explique comment créer un cloud privé à un seul nœud. Les clouds privés à nœud unique vous aident à commencer à utiliser Google Cloud VMware Engine pour un usage non productif, comme les pilotes et les évaluations de preuve de concept. Les clouds privés à nœud unique ne contiennent qu'un seul nœud et un seul cluster. Ils sont limités dans le temps et supprimés automatiquement au bout de 60 jours. Vous pouvez à tout moment passer de votre cloud privé à nœud unique à trois nœuds pour le convertir en cloud privé standard.

Pour en savoir plus sur les clouds privés à nœud unique, consultez la section Clouds privés à nœud unique.

Configuration requise pour la Google Cloud CLI et les API

Pour utiliser l'outil de ligne de commande gcloud ou l'API pour gérer vos ressources VMware Engine, 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 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 cet ensemble de documentation utilisent l'outil de ligne de commande cURL pour interroger l'API. Un jeton d'accès valide est requis dans la requête cURL. 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. Connectez-vous à Google Cloud:

    gcloud auth login
    
  2. Générez un jeton d'accès et exportez-le vers TOKEN:

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

    echo $TOKEN
    

Utilisez maintenant le jeton d'autorisation dans vos requêtes à 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 de cette documentation utilisent la bibliothèque VMware Engine pour communiquer avec l'API. Pour pouvoir utiliser cette approche, la bibliothèque doit être installée et les identifiants par défaut de l'application doivent être configurés.

  1. Téléchargez et installez 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
    

    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.

Avant de commencer

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

Créez un cloud privé à un seul nœud en suivant les instructions ci-dessous.

Console

  1. Dans la console Google Cloud, accédez à la page Clouds privés.

    Accéder à "Private Clouds" (Clouds privés)

  2. Cliquez sur Créer.

  3. Sélectionnez Cloud privé standard.

  4. Sélectionnez l'emplacement où vous souhaitez déployer le cloud privé.

  5. Sélectionnez le type de nœud pour votre cluster principal.

  6. Sélectionnez Nœud unique pour créer un cloud privé à nœud unique.

  7. Renseignez le reste des informations sur votre cloud privé, puis cliquez sur Save (Enregistrer).

gcloud

Pour créer un cloud privé à un seul nœud à l'aide de gcloud CLI:

  1. Facultatif: Si vous ne connaissez pas les noms des régions et des zones disponibles pour votre projet, vous pouvez les lister 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 :

    • PRIVATE_CLOUD_ID: nom de ce cloud privé.
    • CLUSTER_ID: ID du cluster pour cette requête
    • ZONE: zone de ce cloud privé
    • IP_ADDRESS: adresse IP et plage d'adresses IP 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/PROJECT_ID/locations/ZONE/operations/OPERATION_ID].
    
  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.

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

    Le résultat ressemble à ce qui suit :

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

    gcloud vmware private-clouds describe PRIVATE_CLOUD_ID \
       --location=ZONE
    
  5. Obtenez les identifiants vCenter et NSX-T, respectivement, en exécutant la commande gcloud vmware private-clouds credentials describe:

    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

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é à un seul nœud (qui expire au bout de 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
    
    {
     "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"
    }
    

    Remplacez les éléments suivants :

    • PROJECT_ID: projet de cette requête
    • ZONE: zone de ce cloud privé
    • PRIVATE_CLOUD_ID: nom du cloud privé pour cette requête
    • REGION: région de ce cloud privé
    • CLUSTER_ID: ID du cluster pour cette requête
  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 à l'opération:

    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
    

    Remplacez les éléments suivants :

    • PROJECT_ID: ID de cette requête
    • ZONE: zone de ce cloud privé
    • OPERATION_ID: ID de l'opération pour ce cloud privé
  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
    
    • PROJECT_ID: ID de ce projet
    • PRIVATE_CLOUD_ID: ID de ce cloud privé
    • ZONE: zone de ce cloud privé
  4. Obtenez les identifiants vCenter et NSX-T, respectivement, en envoyant des requêtes GET distinctes:

    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
    

Il faut compter entre 30 minutes et deux heures pour que VMware Engine crée votre cloud privé et le rende accessible dans la console Google Cloud.

Étape suivante