Terragrunt

Terragrunt es un envoltorio para Terraform y OpenTofu que mantiene las configuraciones DRY y gestiona las dependencias entre módulos. Semaphore lo ejecuta igual que Terraform/OpenTofu, con algunas diferencias que se describen aquí.

Requisitos previos

1. Instale el binario terragrunt y un binario terraform o tofu en el servidor de Semaphore o en el runner que ejecute las tareas.
2. Habilite la aplicación Terragrunt Code: está deshabilitada de forma predeterminada. Abra Aplicaciones desde el menú de la cuenta y active el interruptor; consulte Aplicaciones.

Crear una plantilla de Terragrunt

1. Vaya a Plantillas de tareas y haga clic en Nueva plantilla.
2. Seleccione Terragrunt Code como aplicación.
3. Indique el Repositorio y el subdirectorio que contiene su terragrunt.hcl.
4. Seleccione o cree un Espacio de trabajo en el campo Inventario. Las plantillas de Terragrunt usan inventarios de tipo terragrunt-workspace; consulte Espacios de trabajo.
5. Haga clic en Crear y luego en Ejecutar.

Ejecutar tareas

El cuadro de diálogo Nueva tarea ofrece las mismas opciones que en Terraform: Plan, Destroy, Auto Approve, Upgrade y Reconfigure.

Semaphore invoca terragrunt run -- <terraform arguments> y pasa el binario de Terraform u OpenTofu con --tf-path, a menos que ya haya establecido --tf-path en los argumentos de la CLI de la plantilla. La selección del espacio de trabajo se realiza con terragrunt run -- workspace select -or-create=true <name>.

Las variables de los Grupos de variables seleccionados se pasan como variables de entorno, así que use el prefijo TF_VAR_ para las variables de entrada. Las variables adicionales y las variables de encuesta se pasan como argumentos -var name=value.

Notas

• terragrunt ejecuta init automáticamente antes de cada comando.
• El backend de estado HTTP y la lista de estados de la pestaña Espacios de trabajo funcionan igual que en Terraform; consulte Backend HTTP.
• Para usar run-all en varios módulos, añada los argumentos en los CLI args de la plantilla.