¿Qué es la importación de Terraform?

La importación de Terraform es un comando crucial en el kit de herramientas de Terraform. Permite a los usuarios llevar la infraestructura existente bajo la administración de Terraform, lo cual es esencial para integrar Terraform en entornos existentes sin necesidad de reconstruir la infraestructura desde cero.

En este artículo, analizaremos en profundidad la importación de Terraform, su importancia y cómo utilizarla de manera eficaz para automatizar y mejorar la consistencia de la administración de su infraestructura.

Comprender la importación de Terraform

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

Este proceso ofrece varios beneficios, entre ellos:

• Integración sin problemas: La importación de Terraform le permite integrar la infraestructura existente en su flujo de trabajo de Terraform sin necesidad de reconstruir todo desde cero. Esto es particularmente útil al asumir entornos existentes o migrar cargas de trabajo a una nueva plataforma. Puede importar recursos gradualmente, lo que garantiza una interrupción mínima en las operaciones en curso.
• Administración unificada: Una vez importados, todos los recursos de infraestructura se pueden administrar a través de los archivos de configuración de Terraform. Esto elimina la necesidad de cambiar entre herramientas separadas o procesos manuales para administrar diferentes partes de su infraestructura.
• Coherencia: Terraform aplica un enfoque declarativo a la administración de la infraestructura. Al importar los recursos existentes, puede asegurarse de que todos estén definidos y administrados de manera consistente usando las configuraciones de Terraform. Esto mejora la capacidad de mantenimiento, reduce los errores y simplifica los cambios en la infraestructura. Por ejemplo, imagine administrar una combinación de máquinas virtuales (VM) aprovisionadas manualmente y VM creadas con Terraform. La importación de las VM existentes garantiza que todas las VM estén definidas de manera consistente, lo que le permite aprovechar las funciones de Terraform, como el control de versiones y el aprovisionamiento automatizado para todas sus VM.

Cómo comenzar con la importación de Terraform

La importación de Terraform le permite llevar la infraestructura existente bajo la administración de Terraform sin tener que recrear recursos. Este breve tutorial lo 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, comprenderá cómo importar recursos a Terraform y administrarlos de manera eficaz.

Requisitos previos

Antes de comenzar, 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 desee importar a la administración de Terraform.

 

Paso 1: Configure su configuración de Terraform

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

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

Paso 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.
 }

Paso 3: Inicializar Terraform

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

$ terraform init

Paso 4: Identifique la instancia EC2 a importar

Localice la ID de instancia EC2 que desea importar. Puede encontrar esto 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.

Paso 5: Importar la instancia EC2

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

$ terraform import aws_instance.example i-1234567890abcdef0

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

Paso 6: Verifique 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, utilice el comando de visualización de terraformes para inspeccionar el recurso importado y actualizar main.tf según corresponda:

$ terraform show

Verá los detalles del recurso importado. Actualice main.tf para que coincida con la configuración real del recurso. Este es un ejemplo de cómo podría 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 administrarlo con Terraform. Ejecute un plan de terraforma para ver las acciones planificadas:

$ terraform plan

Si todo se ve bien, aplique los cambios:

$ terraform apply

Paso 8: Administre 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 Aplicar .

Consideraciones al trabajar con recursos importados

Si bien la importación de Terraform ofrece una forma poderosa de administrar la infraestructura existente, hay algunas consideraciones clave que debe tener en cuenta:

• Coincidencia de configuración: Terraform se basa en su configuración para administrar 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 discrepancia entre la configuración y el recurso real puede provocar comportamientos inesperados o errores durante la importación o la administración posterior.
• Administración estatal: 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 administre su ciclo de vida. A continuación, le explicamos cómo garantizar una administración del estado adecuada:
  • Asegure el archivo de estado: El archivo de estado contiene información confidencial sobre sus recursos de infraestructura. Implemente medidas de seguridad adecuadas para protegerlo del acceso no autorizado. Considere almacenar el archivo de estado en una ubicación segura como un backend dedicado como Terraform Cloud o Terraform Enterprise.
  • Copias de seguridad regulares: Realice una copia de seguridad regular de su archivo estatal para evitar la pérdida de datos en caso de eliminación accidental o corrupción. Tener una copia de seguridad le permite restaurar el estado si es necesario.

Mejores prácticas para administrar recursos importados

Seguir estas mejores prácticas garantiza que administre de manera eficaz sus recursos importados junto con los definidos en el código Terraform:

1. Verificación después de la importación: Después de una importación exitosa, verifique que los atributos del recurso importado dentro del estado Terraform coincidan con la configuración real del recurso. Use el comando de visualización de terraformas para inspeccionar el recurso importado y compararlo con los detalles del recurso obtenidos de la consola o API de su proveedor de nube.
2. Actualizaciones de configuración: Los recursos se pueden modificar 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: Mantenga documentación clara para los recursos importados. Esta documentación debe detallar:
   • El tipo de recurso importado (p. ej., instancia AWS EC2)
   • El identificador del recurso importado (p. ej., ID de instancia)
   • Los pasos tomados durante el proceso de importación
   • Cualquier consideración o nota específica relacionada con la importación    

Conclusiones

La importación de Terraform cierra la brecha entre la infraestructura existente y el poder de administración de Terraform. Le permite integrar sin problemas toda su pila de infraestructura, independientemente del método de creación. Este enfoque unificado reduce la complejidad, mejora la visibilidad y optimiza la administració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 cargas de trabajo en contenedores y Pure Cloud Block Store™ para implementaciones en la nube, para optimizar la administración del almacenamiento junto con Terraform. Esta combinación garantiza una infraestructura eficiente y escalable para sus aplicaciones modernas.