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

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.

ArquitecturaAnatomía de un módulo — de AVM upstream a las landing zones
Anatomía de un módulo — de AVM upstream a las landing zonesLos 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.Módulo wrapper (uno por servicio)Interfaces transversales expuestas por todos los módulosenvuelveconsumido porexponeMódulo AVM upstreamversión fijadaInterfaz tipadavariables · outputs · localsEjemplos por escenariodefault · private-endpoint · cmk …CHANGELOGversiones semánticasterraform validatetfsecanálisis estáticoLanding zonesCloud FactoryPrivate endpointsCMKManaged identityRBACDiagnosticsLocks
  • 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

  1. 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.

  2. 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.

  3. 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.