Para trabajar con Infrastructure Manager (Infra Manager), debes conocer Terraform. Para obtener más información sobre Terraform, comienza con ¿Qué es Terraform?.
Infra Manager implementa recursos y configuraciones de infraestructura definidos en una configuración de Terraform. Estas configuraciones pueden constar de varios archivos y directorios, pero su punto de entrada debe ser un módulo raíz de Terraform.
Infra Manager usa el término blueprint para hacer referencia a una configuración de Terraform.
Para obtener más información sobre Terraform con Google Cloud, consulta Terraform en Google Cloud.
Módulos de Terraform para Google Cloud
Para obtener un conjunto de módulos para aprovisionar recursos de Google Cloud , consulta Módulos y planos de Terraform para Google Cloud.
También puedes crear tus propios módulos de Terraform para Google Cloud. Para obtener más detalles, consulta Cómo crear módulos.
Versiones de Terraform compatibles
Infra Manager admite las siguientes versiones de Terraform:
| Versión de Terraform | Fecha disponible | Fecha de baja | Fecha de finalización de la asistencia | Migración automática a la versión |
|---|---|---|---|---|
1.2.3 |
21/8/2023 | 8/1/2026 | 8/2/2026 | 1.5.7 |
1.3.10 |
14/3/2024 | Por definir | Por definir | Por definir |
1.4.7 |
14/3/2024 | Por definir | Por definir | Por definir |
1.5.7 |
14/3/2024 | Por definir | Por definir | Por definir |
Puedes usar la marca --tf-version-constraint para especificar la versión de Terraform que Infra Manager usa para crear una implementación.
Antes de usar Infrastructure Manager para implementar una configuración de Terraform, asegúrate de que la configuración tenga las siguientes restricciones:
Si no especificas una versión de Terraform, se usará de forma predeterminada la versión compatible más reciente.
Cuando actualizas una implementación, puedes actualizar a una versión posterior de Terraform, pero no puedes cambiar a una versión anterior compatible. Para obtener información sobre la baja de versiones de Terraform, consulta la documentación de la política de administración de versiones de Terraform.
Para ver la versión de Terraform que se usó para crear una implementación o revisión específica, consulta Cómo ver los detalles de una implementación y Cómo ver los detalles de una revisión.
Restricciones en las configuraciones de Terraform
Para usar Infrastructure Manager y, así, implementar una configuración de Terraform, esta debe cumplir con las siguientes restricciones:
- No incluyas información sensible ni de identificación personal en los valores de configuración de Terraform. Para obtener más información, consulta Valores de configuración de Terraform y datos sensibles.
- Se debe proporcionar un módulo raíz de Terraform válido. No se admite la generación ni el uso de plantillas de Terraform.
- La configuración debe poder activarse con una versión compatible de Terraform.
- No se deben definir bloques de backend.
- No recomendamos usar provisioners. Cuando sea posible, usa otra solución. Para obtener más información sobre esta recomendación, consulta Los aprovisionadores son el último recurso. Si usas provisioners, ten en cuenta que el entorno de ejecución de Infra Manager puede cambiar en cualquier momento.
Valores de configuración de Terraform y datos sensibles
No incluyas información sensible ni de identificación personal en los valores de configuración de Terraform.
La documentación del Google Cloud proveedor indica valores de configuración que pueden incluir información sensible.
Por ejemplo, el recurso google_storage_bucket_object permite la creación de un objeto de Cloud Storage con el argumento content. Este argumento se etiqueta como sensible en la página google_storage_bucket_object de la Google Cloud documentación del proveedor.
Puedes usar estas etiquetas como guía cuando crees configuraciones de Terraform o cuando revises una configuración existente de Terraform antes de usarla.
Consulta el Google Cloud Aviso de Privacidad para obtener información sobre cómo Google Cloud procesa la información personal que recopila o genera durante el aprovisionamiento y la administración de los Servicios de Cloud.
Usa el proveedor de Terraform para Google Cloud
De manera opcional, puedes usar gcloud CLI para configurar implementaciones y vistas previas de modo que usen proveedores de Terraform mantenidos por Infra Manager paraGoogle Cloud.
Infra Manager admite proveedores de Terraform para Google Cloud:
googlegoogle-beta
Omite este campo para usar el proveedor de Terraform para Google Cloudque mantiene HashiCorp.
Para obtener información sobre cómo especificar el uso de un proveedor de Terraform que mantiene Infra Manager, consulta Implementa infraestructura con Infrastructure Manager, Actualiza una implementación o Obtén una vista previa de una implementación.
Verifica las versiones compatibles del proveedor
Para verificar las versiones de un proveedor de Terraform para Google Cloud que admite Infra Manager, consulta manifest.json en el bucket de Cloud Storage que mantiene Infra Manager asociado con la región de tu implementación en el siguiente formato:
https://storage.googleapis.com/LOCATION-im-providers/hashicorp/PROVIDER_VERSION/manifest.json
Puedes encontrar una lista completa de las versiones compatibles en el campo versions del archivo manifest.json.
Por ejemplo, si tu implementación se encuentra en la región africa-south1 y usas el proveedor google-beta, navega a https://storage.googleapis.com/africa-south1-im-providers/hashicorp/google-beta/manifest.json para ver las regiones disponibles.
¿Qué sigue?
- Obtén más información sobre Infrastructure Manager.
- Crea una implementación.
- Actualiza una implementación.
- Consulta el estado de una implementación.
- Borra una implementación.