Cerramos el capítulo de backends y estado con un comando muy útil en el mundo real: terraform import. Sirve para resolver una situación muy común: tienes recursos en AWS que se crearon a mano (o con otra herramienta) y quieres que Terraform empiece a gestionarlos. En lugar de borrarlos y recrearlos, los «adoptas» en tu estado. Veamos cómo.

Pocas empresas empiezan de cero con Terraform. Lo habitual es que ya tengan infraestructura creada antes de adoptar la Infraestructura como Código:

• Recursos creados a mano desde la consola de AWS (clicando).
• Recursos creados con scripts antiguos u otras herramientas.
• Infraestructura «heredada» que nadie recuerda muy bien cómo se montó.

Ahora quieres gestionar todo eso con Terraform (recuerda las ventajas del Capítulo 9). Pero hay un problema: Terraform no conoce esos recursos, porque no están en su estado. Si simplemente escribes el código y haces apply, Terraform intentaría crear unos nuevos, ¡duplicando lo que ya existe! Y no puedes borrar los originales sin más, porque están en producción.

terraform import resuelve esto: le dice a Terraform «este recurso que ya existe en AWS, regístralo en tu estado y asócialo a este bloque de mi código». Así, Terraform empieza a gestionar el recurso existente, sin crearlo de nuevo.

Analogía: import es como adoptar algo que ya existe. Imagina que te mudas a una casa que ya tiene muebles. No los tiras para comprar otros idénticos: los registras como tuyos y empiezas a gestionarlos. terraform import hace eso con la infraestructura: adopta lo que ya hay en vez de recrearlo.

Importar un recurso tiene dos partes que debes hacer juntas:

Primero, escribes en tu código Terraform el bloque resource que representará ese recurso existente. Por ejemplo, si tienes una instancia EC2 creada a mano:

Luego, ejecutas el comando import indicando dos cosas: a qué bloque de tu código corresponde, y el ID real del recurso en AWS:

Terraform busca esa instancia (i-0a1b2c3d4e5f...) en AWS y la registra en el estado, asociada a tu bloque servidor_heredado. A partir de ahora, Terraform sabe que ese recurso le pertenece.

Aquí está la parte que requiere cuidado. Tras importar, tu código debe describir el recurso tal y como es en realidad. Si tu código no coincide con el recurso real, el siguiente plan mostraría cambios (Terraform querría «ajustar» el recurso a tu código incompleto).

El objetivo es llegar a un plan que diga «sin cambios»: eso confirma que tu código refleja exactamente el recurso real, y que la adopción fue limpia.

Importar un recurso es sencillo. El problema llega cuando tienes que importar cientos de recursos heredados, escribiendo el código de cada uno y ajustándolo a mano. Es un trabajo tedioso. Por eso existen ayudas:

• Bloques import en el código (versiones modernas de Terraform): permiten declarar las importaciones en el propio código de forma más ordenada, e incluso generar un borrador del código del recurso automáticamente.
• Herramientas de terceros como Terraformer, que escanean tu cuenta de AWS y generan el código y el estado de muchos recursos a la vez. Útiles para migraciones grandes, aunque el resultado siempre conviene revisarlo.

Ejemplo del mundo real: una empresa lleva años creando infraestructura a mano en AWS y decide «poner orden» adoptando Terraform. En vez de recrear todo (imposible, está en producción), van importando sus recursos clave al estado de Terraform, escribiendo el código que los describe, hasta que plan dice «sin cambios». A partir de ahí, gestionan esa infraestructura con código, con todas las ventajas del Capítulo 9, sin haber causado ninguna interrupción.

• Úsalo cuando tengas recursos existentes valiosos (en producción) que quieres gestionar con Terraform sin recrearlos.
• Hazlo con cuidado: importar toca el estado (subcapítulos 20.2 y 20.3), así que aplica las mismas precauciones: copia de seguridad, nadie más trabajando, y verifica con plan al final.
• No te obsesiones con importarlo absolutamente todo de golpe. Es válido ir adoptando recursos poco a poco, empezando por los más importantes.

• terraform import sirve para que Terraform adopte recursos que ya existen en AWS (creados a mano u otra herramienta), registrándolos en su estado sin recrearlos.
• Sin import, si escribes el código de un recurso que ya existe y haces apply, Terraform crearía un duplicado. Import evita eso.
• Proceso: escribe el bloque resource, ejecuta terraform import <bloque> <ID-real>, y completa el código hasta que plan diga «sin cambios» (señal de adopción limpia).
• Como adoptar muebles de una casa nueva en vez de tirarlos y comprar otros iguales.
• Para muchos recursos, hay ayudas: bloques import (que generan borradores de código) y herramientas como Terraformer.
• Aplica las precauciones de manejo de estado (copia de seguridad, plan de verificación) y adopta los recursos poco a poco, empezando por los más importantes.

¡Has terminado el Capítulo 20! Ya dominas el estado de Terraform a fondo: backends, locking, migración e importación. En el Capítulo 21 veremos cómo asegurar la calidad y seguridad de tu infraestructura con testing: validación, análisis de seguridad y tests de integración.