Cómo crear un entorno efímero de pruebas con Terraform y GitHub Actions
Este tutorial muestra cómo crear un entorno efímero (temporal) de pruebas en Azure usando Terraform y GitHub Actions, útil para validar cambios aislados en pull requests y reducir interferencias en entornos compartidos. Explicaremos el porqué y daremos un flujo práctico para crear, probar y destruir infraestructuras automáticamente.
Prerequisitos
- Cuenta Azure con permisos para crear recursos (Contributor en una Subscription).
- Instalar Azure CLI y Terraform localmente para pruebas.
- Repositorio GitHub con permisos para Actions y secrets configurados (AZURE_CLIENT_ID, AZURE_CLIENT_SECRET, AZURE_TENANT_ID, AZURE_SUBSCRIPTION_ID).
- Conocimientos básicos de Terraform, Git y YAML.
Paso 1: Por qué un entorno efímero para PRs
Los entornos efímeros permiten que cada pull request tenga su propia copia de infra para probar funcionalidades sin afectar el entorno común. Esto evita conflictos, facilita la validación manual/automática y reduce costes porque la infra se elimina tras las pruebas.
Paso 2: Estructura mínima de Terraform
Cree una carpeta en el repositorio, por ejemplo infra/pr-env, con un main.tf simple que cree un Resource Group y un App Service Plan + Web App como ejemplo.
provider "azurerm" {
features {}
}
variable "env_name" {}
variable "location" { default = "northeurope" }
resource "azurerm_resource_group" "rg" {
name = "rg-${var.env_name}"
location = var.location
}
resource "azurerm_app_service_plan" "plan" {
name = "plan-${var.env_name}"
location = azurerm_resource_group.rg.location
resource_group_name = azurerm_resource_group.rg.name
sku {
tier = "Basic"
size = "B1"
}
}
resource "azurerm_app_service" "app" {
name = "web-${var.env_name}"
location = azurerm_resource_group.rg.location
resource_group_name = azurerm_resource_group.rg.name
app_service_plan_id = azurerm_app_service_plan.plan.id
}
Paso 3: Outputs y state remoto
Defina outputs útiles (p. ej.: URL) y configure el backend remoto de Terraform (p. ej.: Azure Storage Account) para compartir state entre ejecuciones. Aquí un ejemplo de output.
output "app_default_site_hostname" {
value = azurerm_app_service.app.default_site_hostname
}
Paso 4: GitHub Actions para crear y destruir (workflow)
Genere un workflow YAML que se ejecute para pull_request: crear el entorno en el evento opened o synchronize y destruir en el evento closed. Use el login con service principal vía Azure/login y ejecute terraform init/apply/destroy.
name: PR ephemeral env
on:
pull_request:
types: [opened, synchronize, closed]
jobs:
terraform:
runs-on: ubuntu-latest
steps:
- name: Checkout
uses: actions/checkout@v4
- name: Login Azure
uses: azure/login@v1
with:
client-id: ${{ secrets.AZURE_CLIENT_ID }}
tenant-id: ${{ secrets.AZURE_TENANT_ID }}
client-secret: ${{ secrets.AZURE_CLIENT_SECRET }}
subscription-id: ${{ secrets.AZURE_SUBSCRIPTION_ID }}
- name: Setup Terraform
uses: hashicorp/setup-terraform@v2
with:
terraform_version: 1.5.0
- name: Terraform Init
working-directory: infra/pr-env
run: terraform init -input=false
- name: Terraform Apply for PR
if: ${{ github.event.action != 'closed' }}
working-directory: infra/pr-env
run: |
ENV_NAME=pr-${{ github.event.number }}
terraform plan -var "env_name=${ENV_NAME}" -out=plan.tfplan
terraform apply -auto-approve plan.tfplan
- name: Terraform Destroy for closed PR
if: ${{ github.event.action == 'closed' }}
working-directory: infra/pr-env
run: |
ENV_NAME=pr-${{ github.event.number }}
terraform destroy -auto-approve -var "env_name=${ENV_NAME}"
Paso 5: Variables, naming y limpieza de recursos
Use un prefijo consistente y limite el tiempo de vida: puede combinar la destrucción inmediata cuando se cierre el PR y un job nocturno que elimine entornos antiguos por antigüedad. Verifique cuotas y naming para evitar colisiones.
Verificar el resultado
Abra un pull request y observe las Actions en ejecución: debe haber una run que haga terraform init/plan/apply y, al final, los outputs aparecen en los logs (hostname). Tras cerrar el PR, confirme que la run de destroy se ejecuta y que el Resource Group se elimina en el portal Azure o vía az cli:
az group show -n rg-pr-123 --subscription $AZURE_SUBSCRIPTION_ID
# debe fallar si eliminado
Conclusión
Con este flujo tiene un ejemplo práctico de cómo crear entornos efímeros con Terraform y GitHub Actions para validar PRs automáticamente. Próximos pasos: añadir pruebas automatizadas (p. ej.: pruebas de integración), proteger secrets con OIDC (sustituir service principal) y usar una política de ciclo de vida para recursos críticos. Consejo: comience con recursos económicos (B1) y valide cuotas antes de ampliar.