O que é importação do Terraform?

A importação do Terraform é um comando crucial no kit de ferramentas do Terraform. Ele permite que os usuários levem a infraestrutura existente para o gerenciamento do Terraform, o que é essencial para integrar o Terraform aos ambientes existentes sem precisar reconstruir a infraestrutura do zero.

Neste artigo, analisaremos detalhadamente a importação do Terraform, sua importância e como usá-lo de maneira eficaz para automatizar e melhorar a consistência do gerenciamento da sua infraestrutura.

Entendendo a importação do Terraform

A importação do Terraform permite que você use recursos que foram criados fora do Terraform e os coloque sob seu gerenciamento. Esse processo envolve mapear os recursos de infraestrutura existentes para as configurações correspondentes do Terraform. Ao fazer isso, o Terraform pode rastrear o estado desses recursos, incluindo seus atributos e relacionamentos, e gerenciá-los juntamente com recursos explicitamente definidos no código do Terraform.

Esse processo oferece vários benefícios, incluindo:

• Integração contínua: A importação do Terraform permite integrar a infraestrutura existente ao fluxo de trabalho do Terraform sem precisar reconstruir tudo do zero. Isso é particularmente útil ao assumir ambientes existentes ou migrar cargas de trabalho para uma nova plataforma. Você pode importar recursos gradualmente, garantindo o mínimo de interrupção das operações contínuas.
• Gerenciamento unificado: Depois de importados, todos os recursos de infraestrutura podem ser gerenciados por meio dos arquivos de configuração do Terraform. Isso elimina a necessidade de alternar entre ferramentas separadas ou processos manuais para gerenciar diferentes partes da infraestrutura.
• Consistência: O Terraform aplica uma abordagem declarativa ao gerenciamento de infraestrutura. Ao importar recursos existentes, você pode garantir que todos sejam definidos e gerenciados de maneira uniforme usando as configurações do Terraform. Isso melhora a capacidade de manutenção, reduz erros e simplifica as mudanças de infraestrutura. Por exemplo, imagine gerenciar uma combinação de máquinas virtuais (VMs, Virtual Machines) provisionadas manualmente e VMs criadas com o Terraform. A importação das VMs existentes garante que todas as VMs sejam definidas consistentemente, permitindo aproveitar os recursos do Terraform, como controle de versão e provisionamento automatizado para todas as suas VMs.

Introdução à importação do Terraform

A importação do Terraform permite que você coloque a infraestrutura existente sob gerenciamento do Terraform sem ter que recriar recursos. Este breve tutorial guiará você pelo processo de uso da importação do Terraform para gerenciar uma instância existente do AWS EC2. Ao final do guia, você entenderá como importar recursos para o Terraform e gerenciá-los com eficácia.

Pré-requisitos

Antes de começar, certifique-se de ter o seguinte:

1. Terraform instalado: Faça download e instale o Terraform no site oficial do Terraform.
2. CLI da AWS instalada: Instale e configure a CLI da AWS com as credenciais adequadas.
3. Instância existente do AWS EC2: Tenha uma instância do EC2 existente que você deseja importar para o gerenciamento do Terraform.

 

Etapa 1: Configure sua configuração do Terraform

Primeiro, crie um diretório para seu projeto Terraform e navegue até ele. Depois, crie um novo arquivo chamado main.tf:

$ mkdir terraform-import-tutorial
 $ cd terraform-import-tutorial
 $ touch main.tf

Etapa 2: Escreva a configuração do Terraform

No arquivo main.tf, defina o provedor e o recurso que você planeja importar. Para este tutorial, usaremos uma instância do AWS EC2.

provider "aws" {
 region = "us-west-2"
 }
 resource "aws_instance" "example" {
 # The configuration will be filled in after importing the instance.
 }

Etapa 3: Inicialize o Terraform

Antes de usar o Terraform, inicialize seu diretório de trabalho com os plug-ins necessários:

$ terraform init

Etapa 4: Identifique a instância do EC2 a ser importada

Localize a ID da instância do EC2 que deseja importar. Você pode encontrar isso no Console de gerenciamento da AWS ou usando a CLI da AWS. Por exemplo, vamos supor que a ID da instância seja i-1234567890abcdef0.

Etapa 5: Importe a instância do EC2

Use o comando de importação do terraform para importar a instância do EC2 existente para o Terraform. Execute o seguinte comando em seu terminal:

$ terraform import aws_instance.example i-1234567890abcdef0

Este comando diz ao Terraform para associar o recurso aws_instance.example em sua configuração com a instância EC2 existente i-1234567890abcdef0.

Etapa 6: Verifique a importação

Após a importação, o Terraform atualizará o arquivo de estado com as informações sobre o recurso importado. No entanto, seu arquivo main.tf ainda estará incompleto. Para preencher a configuração, use o comando terraform show para inspecionar o recurso importado e atualizar main.tf adequadamente:

$ terraform show

Você verá os detalhes do recurso importado. Atualize o main.tf para corresponder à configuração real do recurso. Veja um exemplo de como ele pode ser:

provider "aws" {
 region = "us-west-2"
 }
 resource "aws_instance" "example" {
 ami           = "ami-0c55b159cbfafe1f0"  # Replace with your instance's AMI ID
 instance_type = "t2.micro"                # Replace with your instance type
 key_name      = "my-key-pair"             # Replace with your key pair name
 # Additional attributes as per the `terraform show` output
 }

Etapa 7: Aplicar alterações de configuração

Agora que seu arquivo de configuração reflete com precisão o recurso importado, você pode gerenciá-lo com o Terraform. Execute o plano de terraforme para ver as ações planejadas:

$ terraform plan

Se tudo estiver bem, aplique as mudanças:

$ terraform apply

Etapa 8: Gerencie sua infraestrutura

Agora você pode gerenciar seu recurso importado usando o Terraform. Por exemplo, você pode atualizar o tipo de instância ou outros atributos em main.tf e aplicar as alterações com o terraform.

Considerações ao trabalhar com recursos importados

Embora a importação do Terraform ofereça uma maneira avançada de gerenciar a infraestrutura existente, há algumas considerações importantes a serem consideradas:

• Correspondência de configuração: O Terraform conta com sua configuração para gerenciar recursos. Ao importar um recurso, certifique-se de que a configuração do Terraform reflita com precisão os atributos do recurso existente. Qualquer incompatibilidade entre a configuração e o recurso real pode levar a comportamentos inesperados ou erros durante a importação ou o gerenciamento subsequente.
• Gerenciamento estadual: O Terraform armazena o estado da infraestrutura, incluindo recursos importados, em um arquivo de estado. Esse arquivo é essencial para que o Terraform rastreie recursos e gerencie seu ciclo de vida. Veja como garantir o gerenciamento adequado do estado:
  • Proteja o arquivo de estado: O arquivo de estado contém informações confidenciais sobre seus recursos de infraestrutura. Implemente medidas de segurança adequadas para protegê-lo contra acesso não autorizado. Considere armazenar o arquivo de estado em um local seguro, como um back-end dedicado, como o Terraform Cloud ou o Terraform Enterprise.
  • Backups regulares: Faça backup regular do seu arquivo estadual para evitar perda de dados em caso de exclusão acidental ou corrupção. Ter um backup permite restaurar o estado, se necessário.

Melhores práticas para gerenciar recursos importados

Seguir essas práticas recomendadas garante que você gerencie efetivamente seus recursos importados juntamente com os definidos no código Terraform:

1. Verificação após a importação: Após uma importação bem-sucedida, verifique se os atributos do recurso importado no estado do Terraform correspondem à configuração real do recurso. Use o comando terraform show para inspecionar o recurso importado e compará-lo aos detalhes do recurso obtidos no console ou na API do seu provedor de nuvem.
2. Atualizações de configuração: Os recursos podem ser modificados fora do Terraform após a importação. É importante atualizar a configuração do Terraform para refletir quaisquer alterações feitas nos atributos do recurso. Isso garante que o Terraform tenha uma representação precisa da sua infraestrutura e permite gerenciar o recurso com eficácia usando o Terraform.
3. Importar documentação: Mantenha uma documentação clara dos recursos importados. Essa documentação deve detalhar:
   • O tipo de recurso importado (por exemplo, instância AWS EC2)
   • O identificador do recurso importado (por exemplo, ID da instância)
   • As etapas tomadas durante o processo de importação
   • Quaisquer considerações ou observações específicas relacionadas à importação    

Conclusão

A importação do Terraform preenche a lacuna entre a infraestrutura existente e a capacidade de gerenciamento do Terraform. Ele permite integrar perfeitamente toda a pilha de infraestrutura, independentemente do método de criação. Essa abordagem unificada reduz a complexidade, melhora a visibilidade e simplifica o gerenciamento da infraestrutura.

À medida que sua infraestrutura evolui, o armazenamento se torna uma consideração crítica. Explore as soluções da Pure Storage, como a Portworx® para cargas de trabalho em contêiner e o Pure Cloud Block Store .. Para implantações de nuvem, otimize o gerenciamento do armazenamento com o Terraform. Essa combinação garante uma infraestrutura eficiente e escalável para seus aplicativos modernos.