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
Définissez votre ID de projet par défaut :
gcloud config set project PROJECT_ID
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:
Se connecter à Google Cloud
gcloud auth login
Générer un jeton d'accès et exporter vers TOKEN
export TOKEN=`gcloud auth print-access-token`
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.
Télécharger et installer la bibliothèque Python
pip install google-cloud-vmwareengine
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éez un réseau VMware Engine si ce n'est pas déjà fait.
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:
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
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_LIMITEDRemplacez 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 exemple192.168.1.0/24
.REGION
: région de ce cloud privé.
Exemple de sortie:
Create in progress for private cloud [projects/
/locations/ /operations/ ]. Facultatif: Si vous souhaitez vérifier l'état de la création du cloud privé, utilisez les commandes
gcloud vmware operations describe
etgcloud vmware private-clouds list
. Cette opération peut prendre jusqu'à deux heures.gcloud vmware operations describe OPERATION_ID
--location=ZONEgcloud vmware private-clouds list
--location=ZONEExemple de sortie:
NAME PROJECT LOCATION CREATE_TIME STATE VCENTER_FQDN
-private-cloud 2023-03-01T13:08:21.507Z CREATING . 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=ZONEObtenez 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=ZONEgcloud 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:
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êteZONE
: zone de ce cloud privé.PRIVATE_CLOUD_ID
: ID du cloud privé pour cette requête.REGION
: région de ce cloud privé.
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
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"
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
- Obtenez des identifiants de connexion pour les dispositifs de gestion.
- Gérez vos ressources et votre activité de cloud privé.