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

Como criar um ambiente efémero de testes com Terraform e GitHub Actions

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

Este tutorial mostra como criar um ambiente efémero (temporário) de testes em Azure usando Terraform e GitHub Actions, útil para validar alterações isoladas em pull requests e reduzir interferências em ambientes partilhados. Iremos explicar o porquê e dar um fluxo prático para criar, testar e destruir infraestruturas automaticamente.

Pré-requisitos

  • Conta Azure com permissões para criar recursos (Contributor numa Subscription).
  • Instalar Azure CLI e Terraform localmente para testes.
  • Repositório GitHub com permissões para Actions e secrets configurados (AZURE_CLIENT_ID, AZURE_CLIENT_SECRET, AZURE_TENANT_ID, AZURE_SUBSCRIPTION_ID).
  • Conhecimentos básicos de Terraform, Git e YAML.

Passo 1: Porquê um ambiente efémero para PRs

Ambientes efémeros permitem que cada pull request tenha a sua própria cópia de infra para testar funcionalidades sem afetar o ambiente comum. Isto evita conflitos, facilita validação manual/automática e reduz custos porque a infra é removida após os testes.

Passo 2: Estrutura mínima do Terraform

Crie uma pasta no repositório, por exemplo infra/pr-env, com um main.tf simples que crie um Resource Group e um App Service Plan + Web App como exemplo.

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
}

Passo 3: Outputs e state remoto

Defina outputs úteis (ex.: URL) e configure o backend remoto do Terraform (ex.: Azure Storage Account) para partilhar state entre runs. Aqui um exemplo de output.

output "app_default_site_hostname" {
  value = azurerm_app_service.app.default_site_hostname
}

Passo 4: GitHub Actions para criar e destruir (workflow)

Crie um workflow YAML que execute para pull_request: criar o ambiente no evento opened ou synchronize e destruir no evento closed. Use o login com service principal via Azure/login e execute 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}"

Passo 5: Variáveis, naming e limpeza de recursos

Use um prefixo consistente e limite o tempo de vida: pode combinar destruição imediata quando PR fechar e uma job noturna que remove ambientes antigos por idade. Verifique quotas e naming para evitar colisões.

Verificar o resultado

Abra um pull request e veja as Actions a correr: deve haver uma run que faz terraform init/plan/apply e, no final, os outputs aparecem nos logs (hostname). Depois de fechar o PR, confirme que a run de destroy executa e que o Resource Group é removido no portal Azure ou via az cli:

az group show -n rg-pr-123 --subscription $AZURE_SUBSCRIPTION_ID
# deve falhar se removido

Conclusão

Com este fluxo tem um exemplo prático de como criar ambientes efémeros com Terraform e GitHub Actions para validar PRs automaticamente. Próximos passos: adicionar testes automatizados (ex.: testes de integração), proteger secrets com OIDC (substituir service principal) e usar uma política de ciclo de vida para recursos críticos. Dica: comece com recursos económicos (B1) e valide quotas antes de ampliar.