Como criar um ambiente efémero de testes com Terraform e GitHub Actions
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.