¿Qué es Terraform Import?

La importación de Terraform es un comando crucial del kit de herramientas de Terraform. Permite que los usuarios lleven la infraestructura existente bajo la gestión de Terraform, lo que es esencial para integrar Terraform en los entornos existentes sin necesidad de reconstruir la infraestructura desde cero.

En este artículo, veremos en profundidad la importación de Terraform, su importancia y cómo usarla de manera efectiva para automatizar y mejorar la coherencia de la gestión de su infraestructura.

Entender la importación de Terraform

La importación de Terraform le permite tomar recursos creados fuera de Terraform y llevarlos a su gestión. Este proceso implica asignar los recursos de infraestructura existentes a las configuraciones Terraform correspondientes. Al hacerlo, Terraform puede realizar un seguimiento del estado de estos recursos, incluidos sus atributos y relaciones, y administrarlos junto con los recursos explícitamente definidos en su código Terraform.

Este proceso ofrece varios beneficios, entre ellos:

• Integración perfecta: La importación de Terraform le permite integrar la infraestructura existente en su flujo de trabajo de Terraform sin necesidad de reconstruirlo todo desde cero. Esto es especialmente útil cuando se asumen entornos existentes o se migran cargas de trabajo a una nueva plataforma. Puede importar recursos gradualmente, lo que garantiza una interrupción mínima de las operaciones en curso.
• Gestión unificada: Una vez importados, todos los recursos de la infraestructura pueden gestionarse a través de los archivos de configuración de Terraform. Esto elimina la necesidad de cambiar entre herramientas separadas o procesos manuales para gestionar diferentes partes de su infraestructura.
• Coherencia: Terraform aplica un enfoque declarativo de la gestión de la infraestructura. Al importar los recursos existentes, puede estar seguro de que todos están definidos y gestionados de un modo coherente usando las configuraciones de Terraform. Esto mejora la capacidad de mantenimiento, reduce los errores y simplifica los cambios en la infraestructura. Por ejemplo, imagine gestionar una combinación de máquinas virtuales (VM) aprovisionadas manualmente y máquinas virtuales creadas con Terraform. La importación de las máquinas virtuales existentes garantiza que todas las máquinas virtuales se definan de manera coherente, lo que le permite aprovechar las características de Terraform, como el control de versiones y el aprovisionamiento automatizado para todas sus máquinas virtuales.

Introducción a la importación de Terraform

La importación de Terraform le permite llevar la infraestructura existente bajo la gestión de Terraform sin tener que recrear los recursos. Este breve tutorial le guiará a través del proceso de uso de la importación de Terraform para administrar una instancia EC2 de AWS existente. Al final de la guía, entenderá cómo importar recursos a Terraform y gestionarlos de manera efectiva.

Requisitos previos

Antes de empezar, asegúrese de tener lo siguiente:

1. Terraform instalado: Descargue e instale Terraform desde el sitio web oficial de Terraform.
2. CLI de AWS instalado: Instale y configure la CLI de AWS con las credenciales adecuadas.
3. Instancia AWS EC2 existente: Tenga una instancia EC2 existente que quiera importar a la administración de Terraform.

 

Medida 1: Configure su Terraform Configuration

En primer lugar, cree un directorio para su proyecto Terraform y navegue hasta él. Luego, cree un nuevo archivo llamado main.tf:

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

Medida 2: Escribir la configuración de Terraform

En el archivo main.tf, defina el proveedor y el recurso que planea importar. Para este tutorial, usaremos una instancia AWS EC2.

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

Medida 3: Inicializar Terraform

Antes de usar Terraform, inicialice su directorio de trabajo con los complementos necesarios:

$ terraform init

Medida 4: Identificar la instancia EC2 que hay que importar

Localice el ID de instancia EC2 que desea importar. Puede encontrarlo en la Consola de administración de AWS o usando la CLI de AWS. Por ejemplo, supongamos que el ID de instancia es i-1234567890abcdef0.

Medida 5: Importar la instancia EC2

Utilice el comando de importación de terraformes para importar la instancia EC2 existente en Terraform. Ejecute el siguiente comando en su terminal:

$ terraform import aws_instance.example i-1234567890abcdef0

Este comando le dice a Terraform que asocie el recurso aws_instance.ejemplo en su configuración con la instancia EC2 existente i-1234567890abcdef0.

Paso 6: Verificar la importación

Después de la importación, Terraform actualizará el archivo de estado con la información sobre el recurso importado. Sin embargo, su archivo de main.tf seguirá estando incompleto. Para completar la configuración, use el comando de presentación de terraformes para inspeccionar el recurso importado y actualizar main.tf en consecuencia:

$ terraform show

Verá los detalles del recurso importado. Actualice main.tf para que coincida con la configuración real del recurso. Aquí tiene un ejemplo de cómo puede 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
 }

Paso 7: Aplicar cambios de configuración

Ahora que su archivo de configuración refleja con precisión el recurso importado, puede gestionarlo con Terraform. Ejecute un plan terraform para ver las acciones planificadas:

$ terraform plan

Si todo parece estar bien, aplique los cambios:

$ terraform apply

Paso 8: Gestione su infraestructura

Ahora puede administrar su recurso importado usando Terraform. Por ejemplo, puede actualizar el tipo de instancia u otros atributos en main.tf y aplicar los cambios con terraform apply .

Consideraciones al trabajar con recursos importados

Si bien la importación a Terraform ofrece una manera potente de gestionar la infraestructura existente, hay algunas consideraciones clave que hay que tener en cuenta:

• Coincidencia de configuración: Terraform confía en su configuración para gestionar los recursos. Al importar un recurso, asegúrese de que la configuración de Terraform refleje con precisión los atributos del recurso existente. Cualquier desajuste entre la configuración y el recurso real puede provocar comportamientos inesperados o errores durante la importación o la posterior gestión.
• Gestión del estado: Terraform almacena el estado de su infraestructura, incluidos los recursos importados, en un archivo de estado. Este archivo es esencial para que Terraform realice un seguimiento de los recursos y gestione su ciclo de vida. Aquí le explicamos cómo garantizar una gestión adecuada del estado:
  • Proteja el archivo de estado: El archivo de estado contiene información confidencial sobre los recursos de su infraestructura. Implementar las medidas de seguridad adecuadas para protegerla del acceso no autorizado. Considere almacenar el archivo de estado en una ubicación segura, como un back-end dedicado, como Terraform Cloud o Terraform Enterprise.
  • Copias de seguridad periódicas: Haga copias de seguridad periódicas de su archivo de estado para evitar la pérdida de datos en caso de borrado accidental o corrupción. Tener una copia de seguridad le permite restaurar el estado si es necesario.

Mejores prácticas para gestionar los recursos importados

El hecho de seguir estas buenas prácticas le garantiza una gestión efectiva de sus recursos importados junto con los definidos en el código de Terraform:

1. Verificación después de la importación: Después de una importación correcta, verifique que los atributos del recurso importado dentro del estado Terraform coincidan con la configuración real del recurso. Utilice el comando terraform show para inspeccionar el recurso importado y compararlo con los detalles del recurso obtenidos de la consola o API de su proveedor API nube.
2. Actualizaciones de configuración: Los recursos pueden modificarse fuera de Terraform después de importarlos. Es importante actualizar la configuración de Terraform para reflejar cualquier cambio realizado en los atributos del recurso. Esto garantiza que Terraform tenga una representación precisa de su infraestructura y le permite administrar el recurso de manera efectiva usando Terraform.
3. Importar documentación: Mantener una documentación clara de los recursos importados. Esta documentación debe detallar:
   • El tipo de recurso importado (por ejemplo, instancia AWS EC2).
   • El identificador del recurso importado (por ejemplo, ID de instancia).
   • Los pasos tomados durante el proceso de importación
   • Cualquier consideración o nota específica relacionada con la importación    

Conclusión

La importación de Terraform cierra la brecha entre la infraestructura existente y el poder de gestión de Terraform. Le permite integrar sin problemas toda su pila de infraestructura, independientemente del método de creación. Este enfoque unificado reduce las complejidades, mejora la visibilidad y agiliza la gestión de la infraestructura.

A medida que su infraestructura evoluciona, el almacenamiento se convierte en una consideración crítica. Explore las soluciones de Pure Storage, como Portworx® para las cargas de trabajo contenedorizadas y Pure Cloud Block Store™ para los despliegues en la nube, para optimizar la gestión del almacenamiento junto con Terraform. Esta combinación garantiza una infraestructura eficiente y escalable para sus aplicaciones modernas.