POC (Proof of Concept) - Terraform

O que é o Terraform?

O Terraform é uma ferramenta criada pela HashiCorp de infraestrutura como código (IaC) que nos permite provisionar e gerenciar recursos de infraestrutura de maneira automatizada através de linguagem declarativa. O terraform garante a idempotencia, graças a ter estado declarativo, grafo de dependências, fase de planejamento do terraform entre outras características.

Propósito e resumo

Esta POC foi feita com o intuito de registrar meus estudos/contato inicial com o Terraform servindo como base para maiores aprofundamentos no futuro. Este provisiona tanto um arquivo local, quanto uma estrutura na AWS. Sendo que a estrutura de arquivos para o provisionamento na AWS esta disponível em dois formatos, um com arquivos declarativos mais diretos (configuração monolítica) disponível na branch main e com um formato usando module (configuração modular) disponível na branch feature/module.

Principais comandos

terraform init

terraform plan

terraform apply

terraform destroy

Elementos/blocos usados na POC

• Resource

  Usado para declarar um recurso que será gerenciado pelo Terraform. Recursos podem ser máquinas virtuais, redes, bancos de dados, entre outros.

resource "local_file" "example" {
    content = exampleContent
    filename = "${path.module}/exemple.txt"
}

• Data

  Usado para consultar dados externos que não são gerenciados diretamente pelo Terraform. Pode ser usado para obter informações sobre recursos existentes, como subnets, AMIs, etc.

data "local_file" "read_example_file" {
  filename = "${path.module}/exemple.txt"
}

• Output

  Usado para expor informações sobre os recursos gerenciados pelo Terraform.

output "data-source-result" {
    value = data.local_file.read_example_file.content_base64
}

• Variable

  Permite definir variáveis que podem ser usadas para parametrizar sua configuração

variable "conteudo" {
  type = string
  default = "Texto que ira aparecer dentro do arquivo"
}

.:

resource "local_file" "exemplo" {
    content = var.conteudo
    filename = "${path.module}/exemplo.txt"
}

• Provider

  Usado para configurar o provedor de infraestrutura que o Terraform utilizará para gerenciar os recursos

provider "aws" {
  region = "us-east-1"
}

• Backend

  Usado para configurar o backend onde o estado do Terraform será armazenado.

terraform {
  backend "s3" {
    bucket = "my-terraform-state-bucket"
    key    = "terraform.tfstate"
    region = "us-east-1"
  }
}

• Modules

  Permitem organizar e reutilizar blocos de configuração Terraform.

module "example" {
  source = "./modules/example"
  // Configurações específicas do módulo
}

Tipos de arquivos

• *.tf

  Arquivos de configuração com linguagem declarativa criado pelo dev.

• *.tfvars

  Arquivo de variáveis do Terraform

• *.tfstate (gerado pelo Terraform)

  Arquivo com o estado atual da infra

• *.tfstate.backup (gerado pelo Terraform)

  Backup do arquivo .tfstate

Links úteis

• Calculadora de subnets