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

Ce document explique comment créer un cloud privé à nœud unique. 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 développer votre nœud vers trois nœuds à tout moment 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.

Conditions requises pour la Google Cloud CLI et les API

Pour gérer votre instance VMware Engine à l'aide de l'outil de ligne de commande gcloud ou de l'API ressources, 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 présentés dans cette documentation utilisent la bibliothèque VMware Engine pour communiquer avec l'API. Pour pouvoir utiliser cette approche, vous devez installer la bibliothèque et configurer les identifiants par défaut de l'application.

  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é à nœud unique en suivant les instructions ci-dessous.

Console

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

    Accéder à 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 concernant votre cloud privé, puis cliquez sur Save (Enregistrer).

gcloud

Pour créer un cloud privé à nœud unique à l'aide de la 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 résultat:

    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 l'gcloud vmware operations describe et gcloud vmware private-clouds list commandes.

    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 respectivement les identifiants vCenter et NSX-T en exécutant 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é à nœud unique (qui 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

{
 "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 demande
    • REGION: région de ce cloud privé
    • CLUSTER_ID: ID de cluster pour cette requête

  2. Facultatif: vérifiez l'état de la création du cloud privé (cela peut prendre à 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

    Pour répertorier les clouds privés d'une zone, envoyez 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 cet élément privé cloud
    • 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