Quando Usar

• Provisionar, proteger ou operar a infraestrutura descrita nesta habilidade dentro de um ambiente autorizado.

Terraform AWS

Provisione e gerencie infraestrutura AWS com Terraform.

Configuração do Provedor

terraform {
  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = "~> 5.0"
    }
  }
  
  backend "s3" {
    bucket = "terraform-state"
    key    = "prod/terraform.tfstate"
    region = "us-east-1"
  }
}

provider "aws" {
  region = var.region
  
  default_tags {
    tags = {
      Environment = var.environment
      ManagedBy   = "terraform"
    }
  }
}

Exemplos de Recursos

resource "aws_vpc" "main" {
  cidr_block           = "10.0.0.0/16"
  enable_dns_hostnames = true
  
  tags = { Name = "main-vpc" }
}

resource "aws_instance" "web" {
  ami           = data.aws_ami.amazon_linux.id
  instance_type = "t3.micro"
  subnet_id     = aws_subnet.public.id
  
  tags = { Name = "web-server" }
}

Módulos

module "vpc" {
  source = "terraform-aws-modules/vpc/aws"
  
  name = "my-vpc"
  cidr = "10.0.0.0/16"
  
  azs             = ["us-east-1a", "us-east-1b"]
  private_subnets = ["10.0.1.0/24", "10.0.2.0/24"]
  public_subnets  = ["10.0.101.0/24", "10.0.102.0/24"]
  
  enable_nat_gateway = true
}

Comandos

terraform init
terraform plan -out=plan.tfplan
terraform apply plan.tfplan
terraform destroy

Melhores Práticas

• Use estado remoto com bloqueio
• Implemente estrutura de módulos
• Use workspaces ou estados separados por ambiente
• Fixe versões do provedor
• Use fontes de dados para AMIs

Habilidades Relacionadas

• aws-vpc (aws-vpc) - Rede VPC
• aws-iam (aws-iam) - Políticas IAM

Quando Usar

• Você está provisionando, configurando ou solucionando problemas do componente de infraestrutura coberto por esta habilidade (servidores, armazenamento, bancos de dados, rede, nuvem, IA local).

Limitações

• Comandos de infraestrutura podem interromper serviços: confirme o host/escopo alvo e tenha backups/snapshots antes de mutar o estado.
• Importação apenas de documentação: scripts e templates upstream não estão incluídos.