Para trabajar con el Administrador de infraestructura (Infra Manager), debes estar familiarizado con Terraform. Para obtener más información sobre Terraform, comienza con ¿Qué es Terraform? de HashiCorp.
Infrastructure Manager implementa recursos y configuraciones de infraestructura que se definen 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 esquema para referirse 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
Si quieres obtener un conjunto de módulos para aprovisionar Google Cloud recursos, consulta Planos y módulos 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 1.2.3 de Terraform
- Versión 1.3.10 de Terraform
- Versión 1.4.7 de Terraform
- Versión 1.5.7 de Terraform
Puedes usar la marca --tf-version-constraint para especificar la versión de Terraform que usa Infra Manager para crear una implementación.
Si no especificas una versión de Terraform, se usa la versión de compatibilidad más reciente de forma predeterminada.
Cuando actualizas una implementación, puedes cambiar la versión de Terraform a una versión más reciente. No puedes cambiar a una versión anterior compatible 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 para implementar una configuración de Terraform, esta debe cumplir con las siguientes restricciones.
- No incluyas información personal ni sensible en los valores de configuración de Terraform. Para obtener más información, consulta la siguiente sección 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 creación de plantillas ni la generación de Terraform.
- La configuración debe poder activarse con una versión compatible de Terraform.
- No se deben definir los bloques de backend.
- No se recomienda el uso de aprovisionadores. Si es posible, usa una solución diferente. Consulta Los aprovisionadores son un último recurso para obtener más detalles sobre los aprovisionadores. Si usas aprovisionadores, ten en cuenta que el entorno de ejecución de Infra Manager puede cambiar en cualquier momento.
Valores de configuración y datos sensibles de Terraform
No incluyas información personal ni sensible en los valores de configuración de Terraform.
La documentación del Google Cloud proveedor indica los valores de configuración que pueden incluir información sensible.
Por ejemplo, el recurso google_storage_bucket_object permite crear 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 para guiarte cuando crees configuraciones de Terraform o cuando revises una configuración de Terraform existente 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.
¿Qué sigue?
- Obtén más información sobre el Administrador de infraestructura.
- Crea una implementación.
- Actualiza una implementación.
- Consulta el estado de una implementación.
- Borra una implementación.