En esta página se describe cómo exportar y revisar los resultados de una vista previa. Una vista previa describe las acciones para activar una configuración de Terraform específica. Antes de crear o actualizar una implementación, puedes previsualizarla para verificar qué cambios se van a realizar.
Si aún no has creado la vista previa que quieres ver, consulta Vista previa de una implementación.
En esta página se da por hecho que conoces Terraform. Para obtener más información, consulta Terraform e Infrastructure Manager.
Antes de empezar
- Habilita Infra Manager.
- Asegúrate de que tienes los permisos de gestión de identidades y accesos necesarios para exportar vistas previas:
roles/config.admin. - Crea una implementación de vista previa.
Exportar los resultados de la vista previa
Para revisar los resultados de una vista previa, primero debes exportarlos. A continuación, consulta los resultados exportados con la herramienta adecuada.
Para exportar una vista previa, su estado debe ser SUCCEEDED o STALE. Puedes ver el estado actual de una vista previa con los comandos describe o list.
Exporta los resultados de una vista previa y guárdalos de forma local con el siguiente comando:
gcloud infra-manager previews export projects/PROJECT_ID/locations/LOCATION/previews/PREVIEW_ID
Sustituye:
- PROJECT_ID: el ID del proyecto en el que se ejecuta Infrastructure Manager.
- LOCATION: la ubicación en la que se ejecuta Infra Manager. Consulta las ubicaciones de Infrastructure Manager para ver la lista de ubicaciones válidas.
- PREVIEW_ID: el identificador de vista previa que especifiques. Consulta Nombre de vista previa para obtener información sobre las restricciones del identificador de vista previa.
Ver los resultados de la vista previa
Los resultados se exportan en dos formatos: el archivo de plan binario y la representación JSON. Puedes usar cualquiera de los dos formatos para revisar los resultados. Para ver los resultados, usa una herramienta adecuada para el formato.
Revisar el archivo de plan binario
Para ver el archivo del plan binario, haz lo siguiente:
Comprueba que has instalado la CLI de Terraform.
Comprueba que la configuración de Terraform que has usado para crear la vista previa esté presente de forma local y se haya inicializado con
terraform init.Imprime el plan propuesto con
terraform show.
Revisa la representación JSON
Para ver la representación JSON, puedes usar tu IDE o herramientas como jq.
Para aplicar las restricciones de las políticas, puedes usar la representación JSON con herramientas como Terraform vet.
Ver los detalles de los cambios y las desviaciones de los recursos
Puedes usar las vistas previas para ver las desviaciones de los recursos de tu implementación. Ver la variación de recursos de tus implementaciones es útil para verificar que los cambios en tus configuraciones son los que quieres y para resumir cómo cambiará tu implementación cuando se actualice con una vista previa concreta.
Cuando creas una vista previa, usas la API Infra Manager para ver los cambios en tus recursos a medida que actualizas tus implementaciones.
Ver la deriva de recursos
Para ver una lista de las desviaciones de recursos de una implementación de vista previa, sigue estos pasos:
gcloud infra-manager resource-drifts list --preview=projects/PROJECT_ID/locations/LOCATION/previews/PREVIEW_ID
Sustituye:
- PROJECT_ID: identificador del proyecto Google Cloud en el que se encuentra tu implementación de vista previa.
- LOCATION: la región o zona de tu implementación de vista previa.
- PREVIEW_ID: el identificador de tu implementación de vista previa.
Ver los detalles de una deriva
Para ver los detalles de una desviación de recursos de una implementación de vista previa, sigue estos pasos:
gcloud infra-manager resource-drifts describe projects/PROJECT_ID/locations/LOCATION/previews/PREVIEW_ID/resourceDrifts/RESOURCE_DRIFT_ID
Sustituye:
- PROJECT_ID: identificador del proyecto Google Cloud en el que se encuentra tu implementación de vista previa.
- LOCATION: la región o zona de tu implementación de vista previa.
- PREVIEW_ID: el identificador de tu implementación de vista previa.
- RESOURCE_DRIFT_ID: el identificador de tu deriva.
Previsualizar los cambios en los recursos
Puedes usar las vistas previas para comprobar cómo cambiarán tus recursos si actualizas una implementación desde la vista previa.
Ver los cambios de recursos
Para ver una lista de los cambios de recursos de una implementación de vista previa, sigue estos pasos:
gcloud infra-manager resource-changes list --preview=projects/PROJECT_ID/locations/LOCATION/previews/PREVIEW_ID
Sustituye:
- PROJECT_ID: identificador del proyecto Google Cloud en el que se encuentra tu implementación de vista previa.
- LOCATION: la región o zona de tu implementación de vista previa.
- PREVIEW_ID: el identificador de tu implementación de vista previa.
Ver los detalles de un cambio de recurso
Para ver los detalles de un cambio de recurso de una implementación de vista previa, sigue estos pasos:
gcloud infra-manager resource-changes describe projects/PROJECT_ID/locations/LOCATION/previews/PREVIEW_ID/resourceChanges/RESOURCE_CHANGE_ID
Sustituye:
- PROJECT_ID: identificador del proyecto Google Cloud en el que se encuentra tu implementación de vista previa.
- LOCATION: la región o zona de tu implementación de vista previa.
- PREVIEW_ID: el identificador de tu implementación de vista previa.
- RESOURCE_CHANGE_ID: el identificador del cambio de recurso.
Siguientes pasos
- Ver y listar vistas previas.
- Implementar recursos.
- Consulta más información sobre Terraform con Google Cloud.
- Actualiza un despliegue.
- Consulta el estado de un despliegue.
- Consulta los recursos implementados.
- Eliminar un despliegue