Importando recursos existentes

Às vezes, você tem recursos de nuvem que foram criados manualmente ou por outras ferramentas. O Terraform import permite trazer esses recursos existentes para o gerenciamento do Terraform.

Isso significa que o Terraform passará a acompanhar o estado desses recursos, e alterações futuras poderão ser aplicadas por meio dos seus arquivos de configuração. Essa é uma etapa fundamental para adotar Infrastructure as Code (IaC) em um ambiente de greenfield convertido a partir de uma infraestrutura existente.

A importação é útil em várias situações:

• Migração da infraestrutura existente: trazer recursos criados fora do Terraform para o seu fluxo de trabalho de IaC.
• Adoção gradual do Terraform: começar com os recursos existentes em vez de recriar tudo.
• Recuperação após perda do estado: reassociar o Terraform aos recursos caso o arquivo de estado seja perdido, embora isso seja raro quando se usa estado remoto.

A estrutura básica do comando terraform import é simples. Ele instrui o Terraform a localizar um recurso existente no seu provedor de nuvem e adicioná-lo ao arquivo de estado, associando-o a um bloco de recurso na sua configuração.

São necessárias duas informações principais: o endereço do recurso no Terraform e o ID desse recurso no provedor de nuvem.

O endereço do recurso é a forma como o Terraform identifica um recurso específico dentro da sua configuração. Ele segue o padrão resource_type.resource_name.

• resource_type: o tipo de recurso, por exemplo, aws_s3_bucket e azurerm_resource_group.
• resource_name: o nome local que você atribui ao recurso na configuração do Terraform, por exemplo, my_bucket e web_app.

Esse endereço já deve existir nos seus arquivos .tf.

Cada recurso em um provedor de nuvem, como AWS, Azure e GCP, tem um identificador exclusivo, geralmente chamado de ID. Você precisará desse ID para informar ao Terraform qual recurso existente específico deve ser importado.

Você pode encontrar esse ID no console do provedor de nuvem, por meio da CLI dele ou usando a API. Por exemplo, o ID de um bucket S3 da AWS é o seu nome, enquanto uma instância do EC2 tem um ID de instância como i-0abcdef1234567890.

Etapa crucial: antes de executar terraform import, você deve ter um bloco de recurso correspondente definido nos arquivos de configuração do Terraform, que são arquivos .tf.

Esse bloco informa ao Terraform qual tipo de recurso esperar e quais atributos ele deve ter. O Terraform usa essa definição para entender o esquema do recurso durante a importação.

Suponha que você tenha um bucket S3 existente da AWS chamado my-existing-coddykit-bucket-123. Primeiro, defina um bloco de recurso para ele no seu main.tf:

Agora que você tem a definição em HCL, pode executar o comando terraform import. Substitua my-existing-coddykit-bucket-123 pelo nome/ID real do seu bucket existente.

Certifique-se de já ter executado terraform init no seu diretório!

Após uma importação bem-sucedida, o Terraform terá adicionado o recurso ao seu arquivo de estado. Você pode verificar isso usando terraform state show, que exibe os atributos do recurso importado conforme são vistos pelo Terraform.

Em seguida, é essencial executar terraform plan para garantir que não haja diferenças inesperadas entre o seu HCL e o estado real do recurso importado.

Você deseja importar uma instância EC2 existente para o Terraform. Qual das etapas a seguir MUST ser concluída antes de executar o comando terraform import?

Você aprendeu a trazer recursos de nuvem existentes para o gerenciamento do Terraform usando terraform import.

• Primeiro, defina o bloco de recurso no seu HCL.
• Em seguida, identifique o ID do recurso no provedor de nuvem.
• Por fim, execute terraform import ADDRESS ID.
• Sempre execute terraform plan depois para reconciliar eventuais diferenças.

Esse comando poderoso ajuda a diminuir a distância entre uma infraestrutura gerenciada manualmente e um ambiente totalmente orientado por IaC.