Se usó la API de Cloud Translation para traducir esta página.

Obtén una vista previa de una implementación

En esta página, se describe cómo usar Infrastructure Manager para obtener una vista previa de la implementación de los recursos definidos en una configuración de Terraform.

Una vista previa describe las acciones para activar una configuración específica de Terraform. Antes de crear o actualizar una implementación, puedes obtener una vista previa de ella para verificar los recursos que se planean aprovisionar.

Una vista previa ejecuta el comando Terraform plan. En esta página, se supone que estás familiarizado con Terraform. Para obtener más detalles, consulta Terraform y Infrastructure Manager.

Para crear una vista previa, la configuración de Terraform debe ser compatible con una de las versiones de Terraform admitidas.

Antes de comenzar

Habilita Infra Manager.
Asegúrate de tener los permisos de Identity and Access Management necesarios para crear vistas previas: roles/config.admin.
Asegúrate de tener una cuenta de servicio con los permisos necesarios. Para obtener más información, consulta Configura la cuenta de servicio.
Identifica la configuración de Terraform de la que deseas obtener una vista previa. Asegúrate de que esta configuración de Terraform cumpla con las restricciones, lo que incluye que no contenga datos sensibles.
Si deseas almacenar la configuración de Terraform en un bucket de almacenamiento, asegúrate de que se suba a un bucket de Cloud Storage. Consulta Cómo subir una configuración a un bucket de almacenamiento para obtener más detalles.

Un bucket de almacenamiento te permite controlar el acceso a la configuración. También puedes implementar una configuración de Terraform que se almacene en un repositorio de Git o en tu máquina local.

Obtén una vista previa de una implementación nueva

La configuración de Terraform que obtienes en la vista previa puede estar en un bucket de almacenamiento o en un repositorio de Git.

Obtén una vista previa con una configuración de Terraform almacenada en un bucket de Cloud Storage

Asegúrate de que la configuración de Terraform se suba a un bucket de Cloud Storage. Consulta Cómo subir una configuración a un bucket de almacenamiento para obtener más detalles.

Un bucket de almacenamiento te permite controlar el acceso a la configuración. También puedes implementar una configuración de Terraform que se almacene en un repositorio de Git o en tu máquina local.
Para obtener una vista previa de la actualización, sigue estos pasos:
```
gcloud infra-manager previews create projects/PROJECT_ID/locations/LOCATION/previews/PREVIEW_ID \
    --service-account projects/SERVICE_ACCOUNT_PROJECT_ID/serviceAccounts/SERVICE_ACCOUNT \
    --gcs-source gs://BUCKET_NAME/OBJECT_NAME \
    --input-values=INPUT_1_NAME=VALUE,INPUT_2_NAME=VALUE \
    --tf-version-constraint=TERRAFORM_VERSION \
    --annotations="ANNOTATION_KEY=ANNOTATION_VALUE"
    --provider-source=SERVICE_MAINTAINED
```
Reemplaza lo siguiente:
- PROJECT_ID es el ID del proyecto en el que se ejecuta Infrastructure Manager.
- LOCATION es la ubicación en la que se ejecuta Infra Manager. Consulta Ubicaciones de Infrastructure Manager para obtener la lista de ubicaciones válidas.
- PREVIEW_ID es el identificador de vista previa que especificas. Consulta Nombre de vista previa para obtener detalles sobre las restricciones del identificador de vista previa.
- SERVICE_ACCOUNT es el nombre de la cuenta de servicio que usas para llamar a Infra Manager.
- SERVICE_ACCOUNT_PROJECT_ID es el ID del proyecto de la cuenta de servicio. Es común que este sea el mismo proyecto en el que se ejecuta Infra Manager.
- BUCKET_NAME es el nombre del bucket de almacenamiento en el que se almacena la configuración.
- OBJECT_NAME es el nombre del objeto del archivo de configuración. Este objeto puede ser un directorio o un archivo ZIP, pero no un archivo de Terraform. Si usas el control de versiones de objetos, también puedes especificar el número de generación del objeto. Para obtener más detalles, consulta Usa objetos con versión.
  
  Si el bucket de almacenamiento es la ruta raíz de la configuración de Terraform, OBJECT_NAME es opcional.
- INPUT_1_NAME=VALUE y INPUT_2_NAME=VALUE: Cualquier valor de entrada en la configuración de Terraform, incluidos los que no están definidos de forma predeterminada. Por ejemplo, puedes especificar el proyecto en el que implementas los recursos como project_id=my-project.
  
  Si todos los valores de entrada se definen de forma predeterminada en la configuración, esta marca es opcional.
- Opcional: TERRAFORM_VERSION: Es la versión de Terraform que Infra Manager usará para crear la implementación. Consulta la versión de Terraform compatible para obtener la lista de versiones compatibles. Si quitas esta marca opcional, se usará la versión más reciente compatible de Terraform.
- Opcional: ANNOTATION_KEY y ANNOTATION_VALUE representan un par clave-valor de texto de formato libre que se puede adjuntar a tus implementaciones de Infra Manager. Para obtener más información sobre el uso y las restricciones de las anotaciones y las etiquetas, consulta Anotaciones y etiquetas.
- Opcional: PROVIDER_SOURCE: Determina qué proveedor de Terraform usa Google Cloud para la implementación. Se establece en SERVICE_MAINTAINED para usar el proveedor de Terraform que mantiene Infra Manager. Omite este campo para usar el proveedor de Terraform que mantiene HashiCorp. Para obtener más información, consulta Usa el proveedor de Terraform para Google Cloud.
Los campos de la implementación, como la configuración de Terraform, las variables y la cuenta de servicio, se combinan automáticamente en la vista previa, a menos que especifiques valores nuevos en el comando de vista previa.

Ahora que creaste una vista previa, puedes exportar y ver los resultados para revisar el plan de implementación.

Obtén una vista previa con una configuración de Terraform almacenada en un repositorio de Git

Cuando actualizas una implementación, es posible que algunos de los recursos existentes no cambien. La vista previa de una actualización te muestra qué recursos se planean aprovisionar o borrar, y qué recursos no se planean modificar.

Para actualizar una implementación almacenada en un repositorio de Git, sigue estos pasos:

Si usas un repositorio de Git privado, asegúrate de haberte conectado a tu host de GitHub y a tu repositorio de GitHub con Cloud Build para proporcionar acceso de Infra Manager a tu repositorio.

Para obtener una vista previa de la implementación, haz lo siguiente:

gcloud infra-manager previews create projects/PROJECT_ID/locations/LOCATION/previews/PREVIEW_ID \
    --service-account projects/SERVICE_ACCOUNT_PROJECT_ID/serviceAccounts/SERVICE_ACCOUNT \
    --git-source-repo="GIT_REPO" \
    --git-source-directory="DIRECTORY" \
    --git-source-ref="REF" \
    --input-values=INPUT_1_NAME=VALUE,INPUT_2_NAME=VALUE \
    --tf-version-constraint=TERRAFORM_VERSION \
    --annotations="ANNOTATION_KEY=ANNOTATION_VALUE"
    --provider-source=SERVICE_MAINTAINED

Reemplaza lo siguiente:

PROJECT_ID es el ID del proyecto en el que se ejecuta Infrastructure Manager.
LOCATION es la ubicación en la que se ejecuta Infra Manager. Consulta Ubicaciones de Infrastructure Manager para obtener la lista de ubicaciones válidas.
PREVIEW_ID es el identificador de vista previa que especificas. Consulta Nombre de vista previa para obtener detalles sobre las restricciones del identificador de vista previa.
SERVICE_ACCOUNT es el nombre de la cuenta de servicio que usas para llamar a Infra Manager.
SERVICE_ACCOUNT_PROJECT_ID es el ID del proyecto de la cuenta de servicio. Es común que este sea el mismo proyecto en el que se ejecuta Infra Manager.
GIT_REPO: Es el repositorio de Git.
DIRECTORY: Es el directorio que tiene la configuración de Terraform.
REF: Es la referencia de Git de la configuración. La referencia es opcional. Si no especificas la referencia, se usa la rama configurada de forma predeterminada del repositorio de Git.
INPUT_1_NAME=VALUE y INPUT_2_NAME=VALUE: Cualquier valor de entrada en la configuración de Terraform, incluidos los que no están definidos de forma predeterminada. Por ejemplo, puedes especificar el proyecto en el que implementas los recursos como project_id=my-project.

Si todos los valores de entrada se definen de forma predeterminada en la configuración, esta marca es opcional.
Opcional: TERRAFORM_VERSION: Es la versión de Terraform que Infra Manager usará para crear la implementación. Consulta la versión de Terraform compatible para obtener la lista de versiones compatibles. Si quitas esta marca opcional, se usará la versión más reciente compatible de Terraform.
Opcional: ANNOTATION_KEY y ANNOTATION_VALUE representan un par clave-valor de texto de formato libre que se puede adjuntar a tus implementaciones de Infra Manager. Para obtener más información sobre el uso y las restricciones de las anotaciones y las etiquetas, consulta Anotaciones y etiquetas.
Opcional: PROVIDER_SOURCE: Determina qué proveedor de Terraform usa Google Cloud para la implementación. Se establece en SERVICE_MAINTAINED para usar el proveedor de Terraform que mantiene Infra Manager. Omite este campo para usar el proveedor de Terraform que mantiene HashiCorp. Para obtener más información, consulta Usa el proveedor de Terraform para Google Cloud.

Los campos de la implementación, como la configuración de Terraform, las variables y la cuenta de servicio, se combinan automáticamente en la vista previa, a menos que especifiques valores nuevos en el comando de vista previa.