Prévisualiser une configuration

Cette page explique comment prévisualiser un fichier de configuration avant de créer un déploiement. Pour en savoir plus sur les configurations, consultez la section Présentation des configurations.

Après avoir écrit un fichier de configuration, vous pouvez le prévisualiser avant de créer un déploiement. L'aperçu d'une configuration vous permet de voir les ressources que Deployment Manager créera, mais n'instancie aucune ressource réelle. Le service Deployment Manager affiche l'aperçu de la configuration en effectuant les opérations suivantes :

  1. Développement de la configuration complète, y compris des modèles
  2. Création d'un déploiement et de ressources "shell"

Vous pouvez prévisualiser votre configuration en exécutant une requête preview avec le paramètre insert().

Avant de commencer

Prévisualiser une nouvelle configuration

Prévisualisez une configuration à l'aide de l'outil de ligne de commande gcloud ou en envoyant une requête directe à l'API.

gcloud

Dans l'outil de ligne de commande gcloud, exécutez la sous-commande create avec le paramètre --preview :

gcloud deployment-manager deployments create example-deployment --config configuration-file.yaml \
     --preview

Le serveur renvoie la liste des ressources dont l'état est IN_PREVIEW afin que vous puissiez les examiner :

The fingerprint of the deployment is ulPDrJON8E5ySHKC5fcukw==
Waiting for create [operation-1492785372594-54dae2ddbff50-58d45d53-12d483cf]...done.
Create operation operation-1492785372594-54dae2ddbff50-58d45d53-12d483cf completed successfully.
NAME                      TYPE                 STATE       ERRORS  INTENT
datadisk-example  compute.v1.disk      IN_PREVIEW  []      CREATE_OR_ACQUIRE
vm-example        compute.v1.instance  IN_PREVIEW  []      CREATE_OR_ACQUIRE

API

Dans l'API, utilisez la méthode insert() avec un corps de requête contenant les champs target et name, ainsi que le paramètre de requête preview=true. Spécifiez la configuration dans le champ target.

Par exemple, la requête d'API suivante affiche l'aperçu d'un modèle simple :

POST https://www.googleapis.com/deploymentmanager/v2/projects/myproject/global/deployments?preview=true

{
 "name": "example-deployment",
 "target": {
  "config": {
    "content":  "resources:\n- name: vm-created-by-cloud-config\n  type: compute.v1.instance\n  properties:\n    zone: us-central1-a\n    machineType: https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/machineTypes/n1-standard-1\n    disks:\n    - deviceName: boot\n      type: PERSISTENT\n      boot: true\n      autoDelete: true\n      initializeParams:\n        diskName: disk-created-by-cloud-config\n        sourceImage: https://www.googleapis.com/compute/v1/projects/debian-cloud/global/images/debian-7-wheezy-v20140619\n    networkInterfaces:\n    networkInterfaces:\n    - network: https://www.googleapis.com/compute/v1/projects/myproject/global/networks/default"
   }
  }
}

Lorsqu'un déploiement est en mode aperçu, vous disposez de l'une des trois options suivantes :

Générer plusieurs aperçus

Si vous souhaitez modifier votre configuration et générer un autre aperçu, exécutez la commande update avec le paramètre --preview :

gcloud deployment-manager deployments update example-config \
    --config new-config.yaml --preview

Dans l'API, exécutez une requête PUT() avec un déploiement existant en indiquant le paramètre de requête preview=true. Le corps de la requête doit contenir les champs intent, target et name. Par exemple, la requête d'API suivante affiche l'aperçu d'une simple mise à jour :

PUT https://www.googleapis.com/deploymentmanager/v2/projects/myproject/global/deployments/example-deployment?preview=true

{
 "target": {
  "config": {
   "content": "resources:\n- name: vm-created-by-cloud-config\n  type: compute.v1.instance\n  properties:\n    zone: us-central1-a\n    machineType: https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/machineTypes/n1-standard-1\n    disks:\n    - deviceName: boot\n      type: PERSISTENT\n      boot: true\n      autoDelete: true\n      initializeParams:\n        diskName: disk-created-by-cloud-config\n        sourceImage: https://www.googleapis.com/compute/v1/projects/debian-cloud/global/images/debian-7-wheezy-v20140619\n    networkInterfaces:\n    - network: https://www.googleapis.com/compute/v1/projects/myproject/global/networks/default"
  }
 },
 "name": "example-deployment"
}

Déployer ou annuler un aperçu

Après avoir prévisualisé un déploiement, vous pouvez poursuivre en le mettant à jour et en abandonnant la configuration. Par exemple, supposons que vous possédez un déploiement intitulé "example-config" qui est actuellement en mode aperçu. Vous pouvez poursuivre ce déploiement en exécutant la commande suivante :

gcloud deployment-manager deployments update example-config

Deployment Manager utilisera la dernière configuration prévisualisée pour créer le déploiement.

Vous pouvez également annuler l'aperçu, puis supprimer le déploiement si vous ne souhaitez pas poursuivre la configuration :

gcloud deployment-manager deployments cancel-preview example-config

Lorsqu'un déploiement est en mode aperçu, vous ne pouvez pas déployer une autre configuration. Par exemple, supposons que vous disposez d'un déploiement intitulé "example-deployment" en mode aperçu et utilisant une configuration nommée "vm.yaml". Vous souhaitez déployer une nouvelle configuration intitulée "two_vms.yaml" dans le même déploiement sans passer par l'étape de prévisualisation. Tant que le déploiement "example-deployment" est en mode aperçu, vous ne pouvez pas déployer de nouvelle configuration. Vous devez d'abord annuler l'aperçu, puis mettre à jour le déploiement avec la nouvelle configuration.

Étapes suivantes

Cette page vous a-t-elle été utile ? Évaluez-la :

Envoyer des commentaires concernant…

Documentation Cloud Deployment Manager