ProfesionalCloud platform engineering

Dhareeba 2.0 — plataforma Azure multientorno para la Autoridad Tributaria de Qatar

Como uno de los principales responsables de la infraestructura, entregué cinco entornos Azure completos — de sbx a prod — en dos releases, con más de 40 servicios en las capas de plataforma, datos, IA e integración, todo aprovisionado como código con módulos Terraform y pipelines de Azure DevOps.

Rol
Uno de los principales responsables de infraestructura — aprovisionamiento con Terraform, desarrollo de módulos, documentación de arquitectura
Contexto
ALIANDO · Cloud Platform · Cliente — Autoridad Tributaria de Qatar
Periodo
2026

Los detalles confidenciales de los entornos (identificadores, topología de red, dimensionamiento) se omiten intencionadamente. Los diagramas muestran solo el diseño lógico.

01Resumen

Dhareeba 2.0, el programa de la Autoridad Tributaria de Qatar (General Tax Authority), necesitaba construir su estate en Azure de forma consistente, entorno tras entorno y release tras release. Como uno de los principales responsables de su infraestructura, convertí ese estate en código — módulos Terraform ejecutados por pipelines de Azure DevOps — y mantuve los despliegues avanzando cuando las dependencias entre capas los bloqueaban.

02Contexto

El proyecto se enmarca en el área Cloud Platform de ALIANDO, centrada en la modernización de infraestructura cloud y la automatización DevOps para la Autoridad Tributaria de Qatar, donde soy uno de los principales responsables de la infraestructura de la plataforma Dhareeba 2.0. La plataforma abarca cinco entornos (sandbox, desarrollo, QA, preproducción y producción) y se entregó en releases sucesivas — Release 0 y Release 1.

03Problema

Más de cuarenta servicios de Azure en las capas de red, datos, IA y plataforma debían existir de forma idéntica en cada entorno, con dependencias entre ellos (identidad, secretos, red, servicios de datos) que convierten el orden de despliegue y la deriva de configuración en riesgos reales. Un aprovisionamiento manual o por entorno no escalaría a cinco entornos y varias releases, ni resistiría una auditoría.

04Mis responsabilidades

  • Compartí la responsabilidad principal de la infraestructura y aprovisioné entornos completos (sbx, dev, qa, pre, prod) para Release 0 y Release 1 mediante módulos Terraform y pipelines de Azure DevOps.
  • Desarrollé módulos Terraform propios donde los existentes no cubrían el requisito.
  • Resolví despliegues fallidos y desbloqueé dependencias entre capas para que las releases avanzaran.
  • Entregué y operé clústeres OpenShift UPI sobre Azure, automatizando su aprovisionamiento y ciclo de vida con Terraform y Azure DevOps.
  • Contribuí a Solution Designs, ADRs, HLDs, LLDs, diagramas de arquitectura y BoQs.

05Arquitectura

Cada entorno se describe con el mismo código Terraform y solo difiere en configuración. Los pipelines de Azure DevOps ejecutan plan y apply por entorno. Cada entorno aloja las mismas capas lógicas — una capa de plataforma (nodos OpenShift UPI, Container Registry, Key Vault, Redis Cache, Storage, VMs IaaS), una capa de datos, una capa de IA y servicios de integración — sobre una capa de red cuya topología no se muestra intencionadamente.

ArquitecturaVista lógica — un código, cinco entornos, servicios por capas
Vista lógica — un código, cinco entornos, servicios por capasLa documentación de arquitectura guía los módulos Terraform en Git; los pipelines de Azure DevOps ejecutan plan y apply sobre cinco entornos (sbx, dev, qa, pre, prod). Cada entorno contiene una capa de plataforma, una de datos, una de IA e integración y una capa de red.Cada entorno — capas lógicas de servicios (40+ servicios)PlataformaDatosIA e integraciónguíaPRpor entornoaprovisionaDocs de arquitecturaADR · HLD · LLD · BoQTerraform modulesGit · config por entornoAzure DevOpsplan → applyEntornos · R0 / R1sbx · dev · qa · pre · prodOpenShift UPIContainer RegistryKey VaultRedis CacheStorageIaaS VMsADLS Gen2Data FactoryDatabricksSQL DatabasePostgreSQL FlexData ExplorerAzure OpenAIAI SearchAzure MLFunctionsLogic AppsEvent HubsNotification HubsCapa de redtopología omitida intencionadamente
  • Externo / referencia
  • Código y configuración
  • Entrega y automatización
  • Servicio de Azure
  • Plataforma / runtime
  • Control de seguridad
  • Datos y almacenamiento

Mapa lógico de servicios basado en los servicios listados en mi CV. La topología de red, la nomenclatura, los identificadores y el dimensionamiento son confidenciales y se omiten.

Descripción textual del diagrama

La documentación de arquitectura guía los módulos Terraform en Git; los pipelines de Azure DevOps ejecutan plan y apply sobre cinco entornos (sbx, dev, qa, pre, prod). Cada entorno contiene una capa de plataforma, una de datos, una de IA e integración y una capa de red.

Flujos

  • Docs de arquitectura → Terraform modules (guía)
  • Terraform modules → Azure DevOps (PR)
  • Azure DevOps → Entornos · R0 / R1 (por entorno)
  • Entornos · R0 / R1 → Cada entorno — capas lógicas de servicios (40+ servicios) (aprovisiona)

Componentes

Docs de arquitectura · Terraform modules · Azure DevOps · Entornos · R0 / R1 · OpenShift UPI · Container Registry · Key Vault · Redis Cache · Storage · IaaS VMs · ADLS Gen2 · Data Factory · Databricks · SQL Database · PostgreSQL Flex · Data Explorer · Azure OpenAI · AI Search · Azure ML · Functions · Logic Apps · Event Hubs · Notification Hubs · Capa de red

06Stack tecnológico

Infrastructure as Code
  • Terraform
  • Custom modules
Entrega
  • Azure DevOps pipelines
  • Git
Plataforma
  • OpenShift UPI on Azure
  • Container Registry
  • Key Vault
  • Redis Cache
  • Storage Account
  • IaaS VMs
Datos
  • ADLS Gen2
  • Data Factory
  • Databricks
  • SQL Database
  • PostgreSQL Flexible Server
  • Data Explorer
  • Event Hubs
IA e integración
  • Azure OpenAI (GPT-4o)
  • Azure AI Search
  • Azure Machine Learning
  • Azure Functions
  • Logic Apps
  • Notification Hubs

07Enfoque de implementación

  • Un único código Terraform para todos los entornos; los entornos difieren en configuración, no en código — la condición previa para la paridad entre sbx y prod.
  • Servicios compuestos a partir de módulos reutilizables, con módulos propios donde un requisito no estaba cubierto.
  • Los pipelines de Azure DevOps como única vía de despliegue, de modo que cada cambio en un entorno se planifica, aplica y registra igual.
  • Los clústeres OpenShift UPI sobre Azure también tratados como código — aprovisionamiento y ciclo de vida automatizados con Terraform y pipelines en lugar de ejecutarse a mano.
  • Artefactos de arquitectura (Solution Designs, ADRs, HLDs, LLDs, BoQs) mantenidos junto a la implementación para que las decisiones sean trazables.

08Retos y decisiones de ingeniería

  1. Reto

    Despliegues bloqueados por dependencias entre capas — un servicio de datos o IA no puede completarse hasta que existen y son accesibles los recursos de plataforma de los que depende.

    Decisión

    Tratar el desbloqueo de dependencias como trabajo de ingeniería — rastrear el fallo hasta el prerrequisito ausente, corregirlo en el módulo o la configuración y relanzar desde el pipeline en lugar de parchear el entorno a mano.

  2. Reto

    Requisitos que los módulos existentes no cubrían.

    Decisión

    Escribir módulos propios en lugar de recursos puntuales, de modo que el hueco se cierra una vez para todos los entornos.

  3. Reto

    Ejecutar OpenShift con infraestructura aprovisionada por el usuario (UPI) en Azure, donde el equipo de plataforma es responsable de la infraestructura subyacente.

    Decisión

    Automatizar el aprovisionamiento y el ciclo de vida con la misma cadena Terraform + Azure DevOps que el resto del estate.

09Consideraciones de seguridad

  • Secretos y claves centralizados en Azure Key Vault dentro de cada entorno, en lugar de embebidos en código o pipelines.
  • Los cambios solo vía pipeline dejan un rastro revisable y auditable de cada modificación de la plataforma.
  • El diseño de red, los identificadores y el dimensionamiento son confidenciales — este caso describe el enfoque, no el estate.

10Consideraciones operativas

  • La paridad entre entornos permite reproducir problemas en entornos inferiores antes de que lleguen a producción.
  • Las releases sucesivas amplían el mismo código en lugar de iniciar despliegues nuevos y divergentes.
  • Las operaciones de ciclo de vida de los clústeres OpenShift se ejecutan mediante automatización, reduciendo la intervención manual sobre infraestructura crítica.

11Resultados e impacto

  • Conjunto completo de entornos (sbx, dev, qa, pre, prod) aprovisionado para Release 0 y Release 1.
  • Más de 40 servicios de Azure en las capas de red, datos, IA y plataforma entregados con Terraform y Azure DevOps.
  • Clústeres OpenShift UPI sobre Azure entregados y operados con aprovisionamiento y ciclo de vida automatizados.

12Lecciones aprendidas

  • La paridad entre entornos es una propiedad del código, no de la disciplina — si los entornos comparten código y solo difieren en configuración, la deriva no tiene dónde esconderse.
  • Gran parte del trabajo real de IaC es gestionar dependencias entre capas; los módulos deben hacerlas explícitas.
  • Documentación de arquitectura y código deben evolucionar juntos; un ADR es más útil cuando la implementación que justifica está a un pull request de distancia.