# Atributos
attribute = "value"

# Bloco
type ["value" ...] {
    (outros atributos ou blocos)
}

# Operações entre valores
soma = 1 + valor

# Interpolação de strings
mensagem = "Olá, ${nome}"

# Utilização de funções
mensagem_gritando = upper(mensagem)

terraform {
    # Declara a versão requerida do terraform
    required_version = "..."
    # Configuração do backend
    backend "<tipo>" {
        ...
    }
}

terraform {
    # Define a versão do provedor
    required_providers {
        <nome> = {
            source  = <endereço>
            version = <versão>
        }
    }
}

# Configurações do provedor
provider "<nome>" {
    ...
}

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

provider "aws" {
    # Define um alias para esta configuração
    alias  = "west"
    region = "us-east-2"
}

resource "aws_instance" "foo" {
    # Declara que este recurso faz uso da configuração
    # com alias "west" do provedor "aws"
    provider = aws.west
    ...
}

terraform {
    required_providers {
        aws = {
            source  = "hashicorp/aws"
            version = "~> 5.0"
            # Declara um provedor com alias para o módulo,
            # já que módulos não possuem blocos provider
            configuration_aliases = [aws.backup]
        }
    }
}

data "aws_ami" "amazon_linux" {
    provider = aws.backup
}

provider "aws" {
    alias  = "west"
    region = "us-west-2"
}

module "web-server" {
    source    = "./modules/web-server"
    # Passa o provedor com alias para o módulo
    providers = {
        aws.backup = aws.west
    }
}

# Deve ser referenciado como "tipo.nome"
resource "<tipo>" "<nome>" {
    ...

    # Permite definir timeouts para operações
    # específicas. Disponível apenas em alguns
    # recursos
    timeouts {
        create = "60m"
        delete = "2h
    }

}

# Deve ser referenciado como "data.tipo.nome"
data "<tipo>" "<nome>" {
    ...
}

# Deve ser referenciado como var.nome
variable "<nome>" {
    type        = string|number|bool|list(...)|tuple([...])|set(...)|map(...)|object({...})
    description = "..."

    # Opcionais

    # Declara um valor padrão, caso nenhum valor seja definido
    default   = ...
    # Marca o valor como sensível e previne que seja exibido
    # em saída da CLI
    sensitive = true
    # Declara que o valor pode ser nulo
    nullable  = true
    # Declara como o valor será validado
    validation {
        # Expressão que retorna verdadeiro ou falso
        condition     = ...
        # Mensagem que será exibida, caso o valor não seja válido
        error_message = "..." 
    }
}

locals {
    # Deve ser referenciado como local.nome
    <nome> = <valor>
    ...
}

output "<nome>" {
    description = "..."
    value       = ...
    # Marca o valor como sensível e previne que seja exibido
    # em saída da CLI
    sensitive   = true
}

# Deve ser referenciado como module.nome
module "<nome>" {
    source  = "..."
    version = "..."
    ...
}

# Deve ser referenciado como ephemeral.nome
ephemeral "<tipo>" "<nome>" {
    ...
}

# Deve estar em um arquivo com extensão .tfquery.hcl
# Deve ser referenciado como list.tipo.nome
list "<tipo>" "<nome>" {
    provider         = ...
    config           = ...
    include_resource = ...
    limit            = ...
}

import {
    id = "<id do recurso>"
    to = tipo.nome
}

resource "<tipo>" "<nome>" {
    ...
}

# Declara um recurso como removido
removed {
    from = tipo.nome
    lifecycle {
        destroy = false
    }
}

# Declara um recurso como movido
moved {
    from = <endereço antigo>
    to   = <endereço novo>
}

action "<tipo>" "<nome>" {
    config {
        ...
    }
}

check "<nome>" {
    data "<tipo>" "<nome>" {
        ...
    }

    assert {
        condition = ...
        error_message = "..."
    }
}

# Deve estar em um arquivo com extensão .tftest.hcl
mock_provider "<nome>" {}

run "<nome>" {
    command = ...

    assert {
        condition = ...
        error_message = "..."
    }
}

# String
"Olá"

# String heredoc
<<EOT
Essa string
pode abranger
várias linhas
EOT
<<-EOT
    Essa string
    pode ser identada
EOT

# Interpolação
"Olá, ${var.nome}"

# Diretivas
"Olá, %{ if var.name != "" }${ var.name }%{ else }unnamed%{ endif }"
<<EOT
%{ for ip in aws_instance.exemplo[*].private_ip }
server ${ip}
%{ endfor }
EOT

<condição> ? <valor se verdadeiro> : <valor se falso>

# Criando uma tupla
[for <variável> in <coleção> : <resultado>]

# Criando um objeto
{for <variável> in {coleção} : <chave> => <valor>}

# Filtrando elementos
[for <variável> in <coleção> : <resultado> if <condição>]
{for <variável> in {coleção} : <chave> => <valor> if <condição>}

# Agrupando na mesma chave
{for <variável> in {coleção} : <chave> => <valor>...}

# Equivalente a [for o in <coleção> : o.<atributo>]
<coleção>[*].<atributo>

resource "<tipo>" "<valor>" {
    dynamic "<bloco>" {
        for_each = <coleção>
        content {
            ...
        }
    }
}

# Executando funções internas
<nome>(<argumentos>...)

# Funções de provedores
# Disponível a partir do terraform v1.8
provider::<nome provedor>::<nome função>(<argumentos>...)

# Prepara o diretório atual
terraform init      [opções]
# Checa se a configuração é válida
terraform validate  [opções]
# Reformata a configuração no estilo padrão
terraform fmt       [opções] [alvo...]
# Mostra as mudanças requeridas pela configuração atual
terraform plan      [opções]
# Cria ou atualiza a infraestrutura
terraform apply     [opções] [arquivo]
# Destroi infraestrutura criada anteriormente
terraform destroy   [opções]

# Permite testar expressões em um prompt interativo
terraform console   [opções]
# Exibe o estado atual ou um plano
terraform show      [opções] [arquivo]
# Mostra informações sobre os provedores requeridos
terraform providers
# Mostra informações sobre os módulos
# Disponível a partir do terraform v1.10
terraform modules
# Permite alterar o estado
terraform state     <subcomando> [opções] [argumentos]
# Permite utilizar workspaces
terraform workspace <subcomando> [opções] [argumentos]

terraform {
    cloud {
        organization = "..."

        workspaces {
            project = "..."
            name    = "..."
        }
    }
}

# Deve estar em um arquivo com extensão .tfcomponent.hcl
required_providers {
    <nome_local> = {
        source  = "..."
        version = "..."
    }
}

provider "<nome_local>" "<nome>" {
    config {
        ...
    }
}

variable "<nome>" {
    ...
}

locals {
    ...
}

removed {
    source = "..."
    from   = ...

    providers = {
        ...
    }
}

component "<nome>" {
    source = "..."
    inputs = {
        ...
    }
    providers = {
        <nome> = provider.nome_local.nome
    }
}

output "<nome>" {
    ...
}

# Deve estar em um arquivo com extensão .tfdeploy.hcl
# Deve ser referenciado como store.varset.nome
store "varset" "<nome>" {
    id       = "..."
    name     = "..."
    category = "..."
}

# Deve ser referenciado como identity_token.tipo.jwt
identity_token "<tipo>" {
    audience = [...]
}

# Deve ser referenciado como deployment_auto_approve.nome
deployment_auto_approve "<nome>" {
    check {
        condition = ...
        reason    = "..."
    }
}

# Deve ser referenciado como deployment_group.nome
deployment_group "<nome>" {
    auto_approve_checks = [
        deployment_auto_approve.nome
    ]
}

# Deve ser referenciado como upstream_input.nome
upstream_input "<nome>" {
    type   = "..."
    source = "..."
}

locals {
    ...
}

deployment "<nome>" {
    inputs = {
        ...
    }

    deployment_group = deployment_group.nome
}

publish_output "<nome>" {
    description = "..."
    value       = ...
}

# Inicializa a stack
terraform stacks init               [opções]
# Cria uma stack
terraform stacks create             -organization-name ... -project-name ... -stack-name ... [opções]
# Lista as stacks
terraform stacks list               -organization-name ... [opções]
# Valida a stack
terraform stacks validate           [opções]
# Formata a stack
terraform stacks fmt                [opções] [arquivo...]
# Exibe as versões dos provedores da stack
terraform stacks provider-lock      [opções]
# Gerencia os deployments
terraform stacks deployment-run     <subcomando>
# Gerencia os grupos de deployment
terraform stacks deployment-group   <subcomando> [opções]
# Gerencia configurações
terraform stacks configuration      <subcomando> [opções]