Recursos nulos e gatilhos

O null_resource do Terraform é um tipo especial de recurso que não cria nem gerencia diretamente nenhum objeto de infraestrutura no seu provedor de nuvem.

Em vez disso, ele atua como um espaço reservado para executar comandos ou scripts arbitrários, sendo frequentemente usado em tarefas que ficam fora do escopo do provisionamento típico de recursos.

Você pode se perguntar por que precisaria de um recurso “nulo”. Ele é extremamente útil para:

• Executar scripts locais: executar comandos na máquina em que o Terraform é executado, por exemplo, para preparar arquivos de configuração.
• Realizar ações após a implantação: executar tarefas de configuração ou limpeza depois que os recursos reais forem provisionados.
• Interagir com APIs externas: quando não existe um provedor dedicado do Terraform para um serviço específico.
• Implementar lógica personalizada: orquestrar etapas personalizadas que não estão vinculadas a um recurso de nuvem específico.

Um bloco null_resource se parece com qualquer outro recurso do Terraform. Sozinho, sem provisioners ou triggers, ele simplesmente cria um objeto “nulo” no estado do Terraform e não faz mais nada.

Normalmente, ele é combinado com provisioners para executar comandos e com triggers para controlar quando esses comandos são executados.

Aqui está um null_resource mínimo. Se você executar terraform apply, ele será criado no estado, mas nenhuma ação externa ocorrerá.

Ele é apenas um espaço reservado, pronto para ser aprimorado com ações.

O verdadeiro poder do null_resource aparece quando você o combina com provisioners.

Os provisioners permitem executar scripts ou comandos na máquina que executa o Terraform (local-exec) ou no próprio recurso remoto (remote-exec, embora seja menos comum com null_resource).

Isso permite que o null_resource se torne um executor de ações.

triggers são um mapa de pares arbitrários de chave e valor definidos dentro de um bloco null_resource.

A finalidade deles é informar ao Terraform: “Se algum valor deste mapa mudar, este null_resource e seus provisioners precisarão ser executados novamente”.

Isso é essencial para fazer o null_resource reagir às mudanças na sua infraestrutura.

Quando um valor no mapa de triggers muda, o Terraform detecta uma modificação no null_resource.

Durante um terraform apply, o Terraform irá:

• Destruir o null_resource existente, se ele existir.
• Criar novamente o null_resource.
• Executar novamente todos os provisioners associados.

Esse mecanismo garante que suas ações personalizadas sejam executadas somente quando as dependências relevantes mudarem.

Aqui, usamos um null_resource para simular a atualização de um arquivo de configuração com base em uma variável simples. O provisioner local-exec executa um comando, e os triggers garantem que ele seja executado novamente se var.app_version mudar.

Embora seja poderoso, use o null_resource com critério:

• Prefira provedores: se existir um provedor ou recurso dedicado do Terraform para uma tarefa, use-o.
• Mantenha a idempotência: garanta que os scripts executados pelos provisioners possam ser executados novamente várias vezes com segurança e sem efeitos colaterais.
• Evite gerenciar o estado: não tente gerenciar estado externo com o null_resource; essa é a finalidade dos backends de estado remoto.
• Considere a fonte de dados external: para lógica externa complexa que retorna dados estruturados, a fonte de dados external pode ser uma alternativa mais simples.

Você aprendeu sobre null_resource e triggers. Vamos testar sua compreensão.

Nesta lição, você descobriu a versatilidade do null_resource do Terraform, uma ferramenta poderosa para executar comandos e scripts personalizados que não correspondem a recursos concretos de nuvem.

Você também aprendeu sobre triggers, um mecanismo dentro de null_resource que permite definir dependências e garantir que os provisioners sejam executados novamente sempre que essas dependências mudarem. Isso possibilita uma automação personalizada, dinâmica e reativa na sua infraestrutura como código.