Estrutura do Projeto

A estrutura recomendada de pastas para um projeto com Terraform depende do tamanho e da complexidade do projeto, bem como da organização dos recursos e ambientes. Abaixo está uma estrutura básica e organizada que pode ser adaptada para projetos de diferentes tamanhos:

---

Estrutura Básica

├── environments/
│   ├── dev/
│   │   ├── main.tf
│   │   ├── variables.tf
│   │   ├── outputs.tf
│   │   └── terraform.tfvars
│   ├── prod/
│   │   ├── main.tf
│   │   ├── variables.tf
│   │   ├── outputs.tf
│   │   └── terraform.tfvars
│   └── staging/
│       ├── main.tf
│       ├── variables.tf
│       ├── outputs.tf
│       └── terraform.tfvars
├── modules/
│   ├── network/
│   │   ├── main.tf
│   │   ├── variables.tf
│   │   ├── outputs.tf
│   │   └── README.md
│   ├── compute/
│   │   ├── main.tf
│   │   ├── variables.tf
│   │   ├── outputs.tf
│   │   └── README.md
│   └── storage/
│       ├── main.tf
│       ├── variables.tf
│       ├── outputs.tf
│       └── README.md
├── global/
│   ├── providers.tf
│   ├── backend.tf
│   └── versions.tf
├── terraform.tfvars
└── README.md

---

Descrição das Pastas e Arquivos

• environments/: Esta pasta contém subpastas para diferentes ambientes (como dev, prod, staging). Cada subpasta tem sua própria configuração Terraform específica para o ambiente.

  • main.tf: Contém a definição dos recursos para o ambiente.

  • variables.tf: Define as variáveis usadas no ambiente.

  • outputs.tf: Define as saídas (outputs) do Terraform para o ambiente.

  • terraform.tfvars: Contém valores específicos das variáveis para o ambiente.

• modules/: Contém módulos reutilizáveis que podem ser usados em diferentes ambientes. Esses módulos são componentes como network, compute, e storage, cada um encapsulando um conjunto de recursos Terraform relacionados.

  • main.tf: Contém a lógica principal do módulo.

  • variables.tf: Define as variáveis usadas pelo módulo.

  • outputs.tf: Define as saídas do módulo.

  • README.md: Explica o propósito do módulo e como utilizá-lo.

• global/: Contém configurações globais que são compartilhadas entre diferentes ambientes.

  • providers.tf: Define os providers, incluindo configurações regionais.

  • backend.tf: Configura o backend remoto para armazenar o estado do Terraform.

  • versions.tf: Especifica as versões do Terraform e dos providers que o projeto suporta.

• terraform.tfvars: Arquivo opcional no diretório raiz que pode conter valores globais padrão que se aplicam a todos os ambientes.

• README.md: Documentação do projeto, descrevendo o propósito e como configurar e executar o Terraform no projeto.

---

Adaptação para Projetos Maiores

Para projetos maiores, você pode adicionar mais subpastas dentro de environments/ e modules/ conforme necessário, ou até mesmo dividir o projeto em repositórios separados para diferentes serviços ou equipes.

---

Benefícios Dessa Estrutura

Modularidade: Módulos reutilizáveis promovem a reutilização de código. Escalabilidade: A estrutura facilita o crescimento do projeto, permitindo adicionar novos ambientes e módulos sem desorganização. Isolamento: Diferentes ambientes são isolados, o que minimiza o risco de configurações incorretas entre ambientes (e.g., produção e desenvolvimento). Manutenção: Código mais organizado e documentado facilita a manutenção e o onboarding de novos membros da equipe.