Importación de recursos existentes

A veces dispone de recursos en la nube que se crearon manualmente o mediante otras herramientas. Terraform import le permite incorporar estos recursos existentes bajo la gestión de Terraform.

Esto significa que Terraform hará un seguimiento de su estado y podrá aplicar cambios futuros mediante sus archivos de configuración. Es un paso clave para adoptar Infrastructure as Code (IaC) en un entorno "brownfield".

La importación resulta útil en varias situaciones:

• Migrar infraestructura existente: incorporar recursos creados fuera de Terraform a su flujo de trabajo de IaC.
• Adoptar Terraform gradualmente: comenzar con los recursos existentes en lugar de recrearlo todo.
• Recuperarse de una pérdida del estado: volver a asociar Terraform con los recursos si se pierde el archivo de estado (aunque esto es poco frecuente con el estado remoto).

La estructura básica del comando terraform import es sencilla. Indica a Terraform que busque un recurso existente en su proveedor de nube y lo añada al archivo de estado, asociándolo con un bloque de recurso de su configuración.

Requiere dos datos principales: la dirección de Terraform del recurso y el ID que el proveedor de nube asigna a dicho recurso.

La dirección del recurso es la forma en que Terraform identifica un recurso específico dentro de su configuración. Sigue el patrón resource_type.resource_name.

• resource_type: el tipo de recurso (por ejemplo, aws_s3_bucket, azurerm_resource_group).
• resource_name: el nombre local que asigna al recurso en su configuración de Terraform (por ejemplo, my_bucket, web_app).

Esta dirección debe existir previamente en sus archivos .tf.

Cada recurso de un proveedor de nube (como AWS, Azure o GCP) tiene un identificador único, normalmente denominado ID. Necesitará este ID para indicar a Terraform *qué* recurso existente específico debe importar.

Puede encontrar este ID en la consola del proveedor de nube, mediante su CLI o a través de su API. Por ejemplo, el ID de un bucket de AWS S3 es su nombre, mientras que una instancia EC2 tiene un ID de instancia como i-0abcdef1234567890.

Paso crucial: antes de ejecutar terraform import, debe tener definido un bloque de recurso correspondiente en sus archivos de configuración de Terraform (archivos .tf).

Este bloque indica a Terraform qué tipo de recurso debe esperar y qué atributos debe tener. Terraform utiliza esta definición para comprender el esquema del recurso durante la importación.

Supongamos que tiene un bucket de AWS S3 existente llamado my-existing-coddykit-bucket-123. Primero, defina un bloque de recurso para él en su archivo main.tf:

Ahora que tiene la definición HCL, puede ejecutar el comando terraform import. Sustituya my-existing-coddykit-bucket-123 por el nombre o ID real de su bucket existente.

Asegúrese de haber ejecutado ya terraform init en su directorio.

Después de una importación correcta, Terraform habrá añadido el recurso a su archivo de estado. Puede verificarlo mediante terraform state show, que muestra los atributos del recurso importado tal como los interpreta Terraform.

A continuación, es fundamental ejecutar terraform plan para asegurarse de que no haya diferencias inesperadas entre su HCL y el estado real del recurso importado.

Desea importar una instancia EC2 existente de AWS a Terraform. ¿Cuál de los siguientes pasos DEBE completarse *antes* de ejecutar el comando terraform import?

Ha aprendido a incorporar recursos existentes de la nube bajo la gestión de Terraform mediante terraform import.

• Primero, defina el bloque de recurso en su HCL.
• Después, identifique el ID del recurso asignado por el proveedor de nube.
• Por último, ejecute terraform import ADDRESS ID.
• Ejecute siempre después terraform plan para conciliar las diferencias.

Este potente comando ayuda a conectar la infraestructura gestionada manualmente con un entorno completamente basado en IaC.