Obtener la vista previa de una configuración

En esta página se describe cómo obtener una vista previa de un archivo de configuración antes de crear una implementación. Para obtener más información sobre las configuraciones, consulta el artículo Descripción general de las configuraciones.

Una vez que hayas escrito un archivo de configuración, puedes previsualizar la configuración antes de crear una implementación. La vista previa de una configuración te permite ver los recursos que crearía Deployment Manager, pero no crea ningún recurso real. El servicio Deployment Manager obtiene una vista previa de la configuración de la siguiente forma:

  1. Ampliar la configuración completa, incluidas las plantillas.
  2. Crear un despliegue y recursos de "shell".

Puedes previsualizar tu configuración usando el parámetro de consulta preview al hacer una solicitud insert().

Antes de empezar

Obtener la vista previa de una configuración nueva

Puedes previsualizar una configuración mediante la CLI de Google Cloud o haciendo una solicitud directa a la API.

gcloud

Si usas Google Cloud CLI, utiliza el subcomando create con la marca --preview:

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

El servidor devuelve una lista de recursos cuyo estado es IN_PREVIEW para que la revises:

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

En la API, usa el método insert() con un cuerpo de solicitud que contenga los campos target y name, así como el parámetro de consulta preview=true. Indica tu configuración en el campo target.

Por ejemplo, la siguiente solicitud a la API muestra una vista previa de una plantilla sencilla:

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

{
 "name": "example-config",
 "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"
   }
  }
}

Cuando un despliegue está en modo de vista previa, puedes continuar con el despliegue de tres formas:

Realizar varias vistas previas

Si quieres cambiar la configuración y realizar otra vista previa, usa el comando update con la marca --preview:

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

En la API, haz una solicitud PUT() con una implementación y proporciona el parámetro de consulta preview=true. El cuerpo de la solicitud debe contener los campos intent, target y name. Por ejemplo, la siguiente solicitud a la API muestra una vista previa de una actualización sencilla:

PUT https://www.googleapis.com/deploymentmanager/v2/projects/myproject/global/deployments/example-config?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-config"
}

Desplegar o cancelar una vista previa

Después de obtener una vista previa de un despliegue, puedes continuar con el despliegue actualizando y confirmando la configuración. Por ejemplo, supongamos que tiene un despliegue llamado example-config que está en modo de vista previa. Para continuar con la implementación, ejecuta el siguiente comando:

gcloud deployment-manager deployments update example-config

Deployment Manager usa la última configuración vista para crear un despliegue.

Si no quieres continuar con la configuración, puedes cancelar la vista previa y, a continuación, eliminar el despliegue:

gcloud deployment-manager deployments cancel-preview example-config

Mientras una implementación esté en modo de vista previa, no podrás continuar con otra configuración. Por ejemplo, supongamos que tienes una implementación llamada example-config que está en modo de vista previa y usa una configuración llamada vm.yaml. Decides que quieres implementar una nueva configuración llamada two_vms.yaml en la misma implementación, omitiendo el proceso de vista previa. Mientras example-config esté en modo de vista previa, no podrás implementar una configuración nueva. Cancela la vista previa y, a continuación, actualiza la implementación con la nueva configuración.

Siguientes pasos