ProfesionalInfrastructure as Code
Librería de módulos Terraform alineados con AVM para landing zones
Un catálogo de módulos Terraform construidos sobre Azure Verified Modules — AKS, Container Registry, AI Foundry, Azure OpenAI, AI Search, Data Factory y Databricks — con los controles de seguridad expuestos como inputs de primer nivel.
- Rol
- Autor de módulos — diseño, implementación, ejemplos y versionado
- Contexto
- ALIANDO · Iniciativa Cloud Factory
- Periodo
- 2026
- AKS module(se abre en una pestaña nueva)
- Container Registry module(se abre en una pestaña nueva)
- AI Foundry module(se abre en una pestaña nueva)
- Azure OpenAI module(se abre en una pestaña nueva)
- AI Search module(se abre en una pestaña nueva)
- Data Factory module(se abre en una pestaña nueva)
- Databricks module(se abre en una pestaña nueva)
01Resumen
Los despliegues de landing zones son tan rápidos y seguros como los módulos con los que se montan. Desarrollé módulos Terraform alineados con los estándares de Azure Verified Modules (AVM) para que los equipos compongan plataformas a partir de bloques probados y versionados — con red privada, cifrado, identidad y diagnóstico disponibles por diseño, no añadidos a posteriori.
02Contexto
Forma parte de la iniciativa “Cloud Factory” de ALIANDO, cuyo objetivo es acelerar y estandarizar los despliegues de landing zones en Azure. AVM es el estándar de Microsoft para módulos Terraform y Bicep, con interfaces homogéneas para aspectos transversales como private endpoints, locks, role assignments y diagnostic settings.
03Problema
Sin una capa de módulos compartida, cada despliegue reimplementa los mismos recursos de forma ligeramente distinta y los controles de seguridad dependen de quién escriba el código ese día. La librería debía ofrecer una interfaz simple y estable a los consumidores, manteniéndose lo bastante cerca de AVM upstream como para incorporar sus mejoras.
04Mis responsabilidades
- Diseñé e implementé wrappers sobre los módulos de recursos oficiales de AVM, fijando las versiones upstream.
- Escribí ejemplos por escenario para cada módulo (default, private endpoint, claves gestionadas por el cliente, entre otros).
- Mantuve un CHANGELOG por módulo y evolucioné los módulos según cambiaban las versiones de AVM upstream.
- Definí los límites de composición entre módulos (por ejemplo, AI Foundry consumiendo AI Search desde su módulo dedicado).
05Arquitectura
Cada módulo envuelve un módulo AVM upstream con versión fijada tras una interfaz tipada de variables y outputs, incluye ejemplos ejecutables y un changelog, y se comprueba con terraform validate y el análisis estático de tfsec. Todos exponen las mismas interfaces transversales — private endpoints, claves gestionadas por el cliente, identidades gestionadas, role assignments RBAC, diagnostic settings y locks — para que una landing zone aplique una única postura de seguridad en todos los servicios.
- Externo / referencia
- Código y configuración
- Entrega y automatización
- Control de seguridad
- Servicio de Azure
- Observabilidad
Descripción textual del diagrama
Los Azure Verified Modules upstream se envuelven en un módulo con interfaz tipada, ejemplos y changelog. Los módulos pasan terraform validate y tfsec antes de consumirse en despliegues de landing zones. Cada módulo expone private endpoints, claves gestionadas por el cliente, identidad gestionada, RBAC, diagnóstico y locks.
Flujos
- Módulo AVM upstream → Interfaz tipada (envuelve)
- Módulo wrapper (uno por servicio) → terraform validate
- terraform validate → tfsec
- tfsec → Landing zones (consumido por)
- Módulo wrapper (uno por servicio) → Interfaces transversales expuestas por todos los módulos (expone)
Componentes
Módulo AVM upstream · Interfaz tipada · Ejemplos por escenario · CHANGELOG · terraform validate · tfsec · Landing zones · Private endpoints · CMK · Managed identity · RBAC · Diagnostics · Locks
06Stack tecnológico
- Terraform
- Terraform 1.x
- azurerm 4.x
- azapi 2.x
- modtm (AVM telemetry)
- random
- time
- Estándar upstream
- Azure Verified Modules (avm-res-*)
- avm-utl-interfaces
- avm-utl-regions
- Calidad
- terraform validate
- tfsec
- terraform-docs
- CHANGELOG
- Módulos
- AKS
- Container Registry
- AI Foundry
- Azure OpenAI / Cognitive Services
- AI Search
- Data Factory
- Databricks
07Enfoque de implementación
- AKS: construido a partir del módulo de managed cluster de AVM y actualizado después a una release upstream más reciente, con ejemplos que van desde clústeres default y privados hasta un clúster privado secure-baseline y una configuración alineada con WAF.
- Container Registry: basado en el módulo de registry de AVM, con ejemplos de geo-replicación, private endpoints, cifrado CMK, scope maps y registry tokens.
- AI Foundry: soporta los patrones BYOR (traer recursos existentes — Cosmos DB, Key Vault y Storage) y CYOR (crearlos en línea), además de un ejemplo con private endpoints, acceso público deshabilitado y DNS gestionado por Azure Policy.
- Azure OpenAI / Cognitive Services: un wrapper que refleja la interfaz upstream completa — 39 inputs y 11 outputs — con ejemplos de private endpoints, CMK, autenticación local deshabilitada y políticas de Responsible AI.
- Data Factory, AI Search y Databricks: soporte de identidades gestionadas, private endpoints y diagnostic settings, con self-hosted integration runtimes y linked services en Data Factory, y VNet injection y access connectors en Databricks.
08Retos y decisiones de ingeniería
Reto
Mantener los wrappers cerca de AVM upstream sin exponer a los consumidores a cada cambio upstream.
Decisión
Fijar la versión del módulo upstream y registrar cada actualización en un CHANGELOG por módulo, para que las actualizaciones sean eventos deliberados y revisables.
Reto
Responsabilidades solapadas entre módulos — AI Foundry depende de AI Search, que ya tiene sus propias convenciones de nombres, red y RBAC.
Decisión
No crear nunca AI Search dentro del módulo de AI Foundry; consumirlo por resource ID desde su módulo dedicado. Un recurso, un propietario.
Reto
Las pruebas de concepto y las landing zones de producción necesitan modelos de dependencias distintos.
Decisión
Soportar BYOR (recomendado para producción y landing zones) y CYOR (cómodo para PoCs y demos), documentados uno junto al otro en los ejemplos.
09Consideraciones de seguridad
- Private endpoints, claves gestionadas por el cliente, identidades gestionadas, role assignments RBAC y locks son inputs de los módulos, de modo que la configuración segura es el camino documentado.
- Los ejemplos cubren explícitamente escenarios reforzados — clústeres privados, acceso público deshabilitado, autenticación local deshabilitada, cifrado CMK.
- El código de los módulos se comprueba con el análisis estático de tfsec.
10Consideraciones operativas
- Los diagnostic settings forman parte de la interfaz de todos los módulos, así que la observabilidad se configura en el despliegue.
- Los ejemplos por escenario sirven a la vez de documentación y de forma rápida de validar un cambio de extremo a extremo.
- Los módulos versionados permiten que cada landing zone se actualice a su ritmo.
11Resultados e impacto
- Siete módulos alineados con AVM que cubren servicios de contenedores, IA y datos para despliegues de landing zones, cada uno publicado con sus ejemplos y changelog.
- Una interfaz de seguridad homogénea en todos los módulos, para aplicar una única postura en toda la plataforma.
- Ejemplos por escenario y changelogs que hacen los módulos autodocumentados y seguros de actualizar.
12Lecciones aprendidas
- La interfaz de un módulo es un control de seguridad — lo que es fácil de configurar es lo que se configura.
- Envolver un estándar es más mantenible que hacer un fork; el valor está en la interfaz opinada, no en el código copiado.
- Unos límites de propiedad claros entre módulos evitan recursos duplicados y convenciones en conflicto.