Terraform desde las Trincheras (Buena práctica ‘Uso de módulos’)

Continuando con las buenas prácticas de IaC con Terraform (que hemos podido utilizar en nuestros proyectos de Azure esperando que faciliten una curva de aprendizaje para aquellos que aún no las aplican y que también están referenciadas en Internet donde existe bastante información de calidad sobre ello) revisaremos la cuarta parte de esta serie de artículos:

1. Terraform desde las Trincheras (Buena práctica ‘Agrupación de capas lógicas’).
2. Terraform desde las Trincheras (Buena práctica ‘Definición de nomenclatura’).
3. Terraform desde las Trincheras (Buena práctica ‘Uso de service principal’).

Uso de Módulos

Después del primer proyecto de implementación de IaC se enfrentarán con el caso que existirán secciones de código Terraform de proyectos anteriores que puedan reutilizar, donde copian ello y lo adaptan para el proyecto actual. Además, mientras participen en más proyectos dichas secciones de código podrían aumentar e involucrar a más de un recurso cloud, por ejemplo los recursos que forman la capa lógica de networking.

Cuando llegamos a ese contexto, es donde se puede refactorizar el código Terraform para crear un componente configurable y reutilizable que se pueda usar en cada proyecto o la mayoría de proyectos donde participemos. En Terraform dicho componente se conoce como módulos y si se requiere más información sobre ello se puede revisar el siguiente enlace: https://developer.hashicorp.com/terraform/language/modules

Para implementar módulos en Terraform requiere que tengamos un nivel de experiencia y conocimiento entre básico e intermedio, ya que existe algunos aspectos importantes a tomar en cuenta que son los que explicaremos a continuación.

¿Implementar desde cero o reutilizar módulos existentes?

Según se tenga identificado las políticas o restricciones dentro de la compañía donde uno trabajo o las que tenga el proyecto donde uno participa, relacionado a la implementación de IaC con Terraform podemos usar módulos existentes que están publicados en Internet, donde existe un conjunto publicado en la página de oficial de Terraform: https://registry.terraform.io/namespaces/aztfm y para Azure se tiene 6 módulos oficiales tal como se indica en la siguiente imagen:

Sin embargo, también podemos encontrar módulos en las páginas de desarrolladores que publican ello y que no están en la página oficial de Terraform.

El problema con seguir esa estrategia es que tenemos que tener cuidado en la revisión del código Terraform de los módulos implementados por terceros, ya que no sabemos si tienen errores o si son fáciles de modificar en el caso no se adapten al 100% con los escenarios donde los queremos usar. Por eso también existe otra estrategia que es la implementación desde cero de los módulos Terraform, aunque esto puede ser igual de complejo o aún más que la estrategia anterior.

¿Usar módulos públicos o privados?

Cuando ya tenemos los módulos de Terraform implementados podemos hacer que ellos sean privados donde se cargan de forma local o también podemos cargarlos apuntando a la ruta pública donde están expuestos. La diferencia de ambas estrategias se centra en el tema si es un problema o no que el código Terraform de los módulos este público, ya que si dichos módulos se implementaron desde cero o fueron modificados tomando en cuenta una versión existente, ese código será visto por terceros y si eso no se quiere, entonces se debería considerar la opción de módulos privados. En la siguiente imagen se muestra cómo se carga el módulo (resaltado de amarillo) y también como se configura sus parámetros (resaltado en un cuadro de borde rojo):

Documentación de cómo usar módulos

Otro aspecto importante es brindar ejemplos de los casos más comunes que se pueden configurar usando los módulos para que de esta forma sea menos complicado su uso en nuevos proyectos o por nuevos integrantes que no tienen mucha experiencia y conocimiento en módulos Terraform.

Para ello en la carpeta que tiene el código del módulo Terraform debe tener una carpeta de ejemplos y dentro tendrá una carpeta por cada ejemplo para que sirva de referencia en su uso. En la siguiente imagen para el módulo oficial de application gateway se muestra que la carpeta ejemplo (resaltado en el cuadro de borde rojo) tiene un solo caso de configuración (resaltado de amarillo) y dentro están los archivos con el código de ejemplo sobre el uso de dicho modulo:

Por otro lado, también es importante resaltar que el código Terraform del módulo o los módulos que se tengan implementados pueden seguir siendo actualizados para soportar mejoras o nuevos cambios que se identifiquen en cada nuevo proyecto donde se usen.

En el siguiente artículo explicaremos la buena práctica de IaC con Terraform llamada «Protección de valores que contienen información de seguridad».