(+351) 21 24 10006  ·  info@bconcepts.pt
Carnaxide, Lisboa

Cómo crear un entorno efímero de pruebas con Terraform y GitHub Actions

João Barros 18 de November de 2026 4 min de lectura

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.