Para trabajar con Infrastructure Manager (Infra Manager), debes estar familiarizado con Terraform. Para obtener más información sobre Terraform, comienza con ¿Qué es Terraform?.
Infrastructure Manager implementa recursos y parámetros de configuración 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 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 que aprovisionen recursos de Google Cloud , 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 de Terraform | Nivel de precios | Fecha disponible | Fecha de baja | Fecha de finalización de la asistencia | Migra automáticamente a la versión |
|---|---|---|---|---|---|
1.2.3 |
Nivel gratuito | 21/8/2023 | 8/1/2026 | 8/2/2026 | 1.5.7 |
1.3.10 |
Nivel gratuito | 14/3/2024 | Por definir | Por definir | Por definir |
1.4.7 |
Nivel gratuito | 14/3/2024 | Por definir | Por definir | Por definir |
1.5.7 |
Nivel gratuito | 14/3/2024 | Por definir | Por definir | Por definir |
1.16.5 |
Pago | 2/11/2026 | Por definir | Por definir | Por definir |
Para obtener información sobre las funciones que se introdujeron en cada versión de Terraform, consulta la documentación de HashiCorp Terraform y las versiones de Terraform.
Puedes especificar la versión de Terraform que usa el Administrador de infraestructura cuando
creas una implementación,
actualizas una implementación o
obtienes una vista previa de una implementación en la
consola deGoogle Cloud o con la marca --tf-version-constraint en la
gcloud CLI.
Si no especificas una versión de Terraform cuando creas una implementación o
versión preliminar nuevas, el Administrador de infraestructura usa la versión más reciente compatible del nivel gratuito
(1.5.7) de forma predeterminada. Para usar una versión pagada (como 1.16.5), debes
especificar de forma explícita la restricción de versión.
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 la versión 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 Visualiza los detalles de una implementación y Visualiza los detalles de una revisión.
Licencias y precios de las versiones de Terraform
Las versiones de Terraform 1.5.7 y anteriores se distribuyen como código abierto según la
Licencia pública de Mozilla (MPL 2.0) y están disponibles en el nivel gratuito sin
tarifa de administración de Infra Manager.
La versión 1.16.5 de Terraform se distribuye bajo la
Licencia de fuente empresarial (BUSL) y se
ofrece como una versión pagada en Infra Manager. Si usas una versión pagada de Terraform,
se generarán cargos por implementación y administración según la cantidad de
recursos que administre Infra Manager:
Asignación del nivel gratuito: Cada cuenta de facturación recibe una asignación del nivel gratuito de hasta 500 recursos por mes sin cargo.
Cargos por uso: Más allá de la asignación mensual del nivel gratuito de 500 recursos, los recursos administrados por implementaciones que usan una versión pagada de Terraform generan cargos por administración de recursos que se miden por hora por recurso.
No se cobran las vistas previas: Las versiones pagadas de Terraform (como
1.16.5) generan cargos solo por las implementaciones de Infra Manager, no por las vistas previas de las implementaciones.
Para obtener más información sobre los precios, consulta Precios de Infrastructure Manager.
Restricciones en los parámetros de configuración de Terraform
Para usar Infrastructure Manager con el objetivo de implementar una configuración de Terraform, la configuración tiene las siguientes restricciones:
- No incluyas información de identificación personal ni sensible 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 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 recomendamos usar aprovisionadores. Cuando sea posible, usa otra solución. Para obtener más información sobre esta recomendación, consulta Los aprovisionadores son un último recurso. Si usas aprovisionadores, 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 de identificación personal ni sensible en los valores de configuración de Terraform.
La documentación del proveedor de Google Cloud 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 como guía cuando crees configuraciones de Terraform o cuando revises una configuración de Terraform existente antes de usarla.
Consulta el Aviso de Privacidad deGoogle Cloud para obtener información sobre cómo Google Cloud trata 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 versiones preliminares para usar los proveedores de Terraform mantenidos por Infra Manager para Google Cloud.
Infra Manager admite proveedores de Terraform para Google Cloud:
googlegoogle-beta
Omite este campo para usar el proveedor de Terraform que mantiene HashiCorp para Google Cloud.
Para aprender a especificar el uso de un proveedor de Terraform mantenido por 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 el 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 un objeto Deployment.
- Consulta el estado de una implementación.
- Borra una implementación.