Uno de los ecosistemas empresariales de retail y servicios financieros más grandes de Latinoamérica, enfrentaba el enorme desafío de migrar su infraestructura de desarrollo, de gran escala, desde una instancia descentralizada y sin estandarización de GitLab hacia GitHub Enterprise Cloud. Con más de 21.000 repositorios distribuidos en 17 plataformas de negocio distintas, la situación existente presentaba una alta fragmentación estructural, falta de documentación sobre la propiedad del código y una importante deuda técnica en los pipelines heredados de CI/CD.
Para reducir los riesgos de esta transformación, CleverIT diseñó y coordinó una estrategia integral basada en datos, que incluyó un assessment técnico avanzado, una clasificación arquitectónica y un marco de migración por etapas. Con el respaldo de GitHub y Microsoft, CleverIT logró catalogar todo el ecosistema, mapear 224,4 GB de datos fuente y clasificar más de 16.000 pipelines activos, incluidos miles de pipelines críticos de alta complejidad, con hasta 32.000 líneas de código expandidas.
Este trabajo establece una hoja de ruta segura, gobernada y altamente automatizable para consolidar las operaciones de ingeniería en una plataforma de primer nivel, acelerando la llegada de soluciones al mercado, fortaleciendo la gobernanza del código fuente y mejorando las experiencias digitales de millones de clientes de retail y banca en la región.
Una infraestructura de gran escala con desafíos de complejidad y gobernanza
La escala y distribución operativa de la infraestructura de ingeniería de nuestro cliente generaban importantes desafíos tecnológicos, organizacionales y operativos que amenazaban la agilidad del negocio y la estabilidad de sus sistemas.
- Importante deuda técnica en CI/CD: De los más de 21.000 repositorios, 16.738 (79,1 %) contaban con pipelines activos de CI/CD que requerían una conversión arquitectónica completa a GitHub Actions.
- Complejidad extrema de los pipelines: Más de 6.389 pipelines presentaban una complejidad crítica, superando las 1.000 líneas de código expandidas debido al uso de plantillas anidadas, integraciones externas y una lógica condicional extensa. Algunos casos excepcionales alcanzaban las 32.601 líneas expandidas y acumulaban 552.015 ejecuciones históricas, lo que exigía un rediseño estructural exhaustivo.
- Fragmentación organizacional: Las operaciones de ingeniería estaban distribuidas entre 17 unidades de negocio y plataformas diferentes. Cerca del 49 % de los repositorios carecía de una clasificación clara o de responsables definidos, identificados como «NO FAI», lo que dificultaba alinear los espacios de nombres y asignar de forma segura las responsabilidades de migración.
- Alto riesgo operativo: La heterogeneidad de los repositorios y el gran volumen de artefactos, incluidos 2.483 repositorios de más de 100 MB, aumentaban el riesgo de interrupciones en producción, dificultaban la estimación de recursos y podían provocar graves impactos en el negocio ante una migración directa sin adaptación previa.
Una estrategia de migración basada en datos, complejidad y automatización
CleverIT diseñó una estrategia de migración y modernización meticulosa, organizada por fases, para trasladar de forma segura al cliente hacia GitHub Enterprise Cloud, modernizando al mismo tiempo sus prácticas fundamentales de DevOps.
- Descubrimiento y assessment basado en datos: Se implementaron scripts automatizados para auditar, mapear e inventariar toda la instancia de GitLab, obteniendo visibilidad sobre el volumen de código, las extensiones de almacenamiento de archivos grandes (LFS) y los patrones estructurales.
- Matriz de clasificación por complejidad: Se desarrolló un modelo de categorización por niveles para agrupar los pipelines según su cantidad de líneas de código y dependencias, permitiendo definir intervenciones arquitectónicas específicas antes de la migración.
- Marco de migración por etapas (modelo de olas): Se estructuró un plan de migración progresiva mediante herramientas automatizadas de GitHub, pruebas de migración aisladas, flujos de validación paralelos y planes de reversión para minimizar las interrupciones operativas.
- Modernización mediante GitHub Actions: Se diseñaron plantillas reutilizables y estandarizadas de GitHub Actions para reemplazar configuraciones heredadas altamente fragmentadas, incorporando una gestión moderna de secretos y gobernanza de entornos.
- Colaboración estratégica: Se aprovechó una sólida alianza entre partners. GitHub aportó asesoría directa de especialistas de producto, mientras que Microsoft validó las especializaciones técnicas de CleverIT, fortaleciendo la confianza del cliente en la ejecución del proyecto.
Del diagnóstico técnico a una hoja de ruta de 12 meses
El proyecto fue ejecutado por un equipo especializado de CleverIT, compuesto por 1 Project Manager, 1 líder técnico sénior de DevOps y GitHub, y 5 ingenieros especializados en DevOps y GitHub.
El trabajo se organizó mediante una hoja de ruta de 12 meses: 2 meses dedicados al assessment completo y 10 meses destinados a la ejecución de la migración por etapas. Se utilizó Azure DevOps para realizar un seguimiento diario de los hitos, bloqueos y cambios de alcance.
La implementación contempló cuatro hitos arquitectónicos principales:
- Assessment del estado actual: Análisis exhaustivo de los 21.165 repositorios, identificando límites de tamaño, requerimientos de LFS —con 2,8 GB de datos identificados— y volumen de los pipelines.
- Planificación de la migración y diseño de la estructura objetivo: Diseño conjunto de la nueva jerarquía organizacional, normalización del portafolio y definición de los espacios de nombres de los repositorios en GitHub Enterprise Cloud, en coordinación con los equipos directivos y técnicos del cliente.
- Pruebas de migración (dry runs): Simulación de migraciones automatizadas por etapas para repositorios críticos con múltiples proveedores, con el fin de validar la integridad de los datos, la correspondencia de permisos y los parámetros de rendimiento.
- Ejecución de olas de migración automatizada: Migración de los entornos productivos en lotes planificados según las prioridades del negocio y la complejidad de cada unidad, evitando riesgos asociados a puntos únicos de falla.
Más de 21.000 repositorios analizados para una migración segura y escalable
El trabajo estructurado proporcionó visibilidad integral y una hoja de ruta sólida para la transformación de DevOps empresarial de nuestro cliente.
En lugar de optar por una migración directa sin una estrategia previa, la iniciativa permitió inventariar, analizar y caracterizar 21.165 repositorios, resolviendo la falta de visibilidad consolidada y estableciendo una visión clara de los 224,4 GB de código fuente evaluado, incluidos 2,8 GB de recursos almacenados mediante Git LFS.
Para reducir los riesgos operativos y abordar la complejidad oculta en las plantillas personalizadas, se identificaron 16.738 repositorios con CI/CD activo que requerían la conversión de sus pipelines a GitHub Actions.
El assessment también abordó importantes brechas de gobernanza y asignación de responsabilidades: el 100 % de los repositorios sin seguimiento adecuado fue identificado y separado para su reclasificación inmediata. Esto permitió abordar el problema de los repositorios que anteriormente representaban cerca del 49 % del total y estaban clasificados como «NO FAI», sin responsables claramente definidos.
Finalmente, el análisis de ingeniería de pipelines se tradujo en un plan de migración por etapas, basado en el mapeo de dependencias y un modelo de estimación de esfuerzo escalable.
La clasificación del ecosistema quedó distribuida de la siguiente manera:
- 5.700 repositorios sin CI/CD.
- 1.218 pipelines de complejidad simple.
- 3.417 pipelines de complejidad moderada.
- 2.412 pipelines de complejidad alta.
- 1.749 pipelines de complejidad muy alta.
Además, 6.389 pipelines de complejidad crítica, con más de 1.000 líneas de código expandidas, fueron identificados específicamente para un rediseño arquitectónico que permitiera una modernización fluida y escalable.
Una plataforma más segura para impulsar la innovación digital
Al establecer un estándar de ingeniería unificado y de primer nivel sobre GitHub Enterprise Cloud, el cliente avanza hacia la reducción de riesgos tecnológicos, una gobernanza más sólida del código fuente y una colaboración global más eficiente entre sus 17 líneas de negocio.
Para los usuarios finales, esta transformación contribuye a crear un entorno digital más seguro. Los flujos de trabajo automatizados y las capacidades avanzadas de seguridad ayudan a proteger los datos personales y transaccionales de millones de clientes, favoreciendo el desarrollo de soluciones de software para retail y banca más rápidas, robustas y resilientes.
Tres aprendizajes clave para transformar ecosistemas tecnológicos complejos
- El assessment previo a la migración es fundamental: En proyectos que involucran más de 20.000 repositorios, realizar una migración directa sin analizar las líneas de código expandidas de los pipelines puede provocar fallas de conversión desde las primeras etapas. Clasificar los repositorios según su complejidad permite planificar con mayor precisión los recursos y los plazos.
- Estandarizar es mejor que replicar: Los pipelines altamente complejos, que pueden alcanzar hasta 32.000 líneas de código, suelen ser consecuencia de plantillas heredadas y una gestión deficiente. La migración representa una oportunidad para implementar componentes de GitHub Actions reutilizables y eficientes, reduciendo significativamente la deuda técnica futura.
- La reorganización de la gobernanza es un requisito previo: Normalizar los portafolios, los espacios de nombres y la asignación de responsables antes de trasladar los archivos evita replicar la desorganización histórica en una instancia limpia de GitHub Enterprise Cloud.
De la planificación a una operación estandarizada en GitHub
- Ampliar las olas de migración: Ejecutar sistemáticamente la migración automatizada de los repositorios restantes hacia GitHub Enterprise Cloud, siguiendo la hoja de ruta priorizada y validada.
- Retirar progresivamente la infraestructura heredada: Descontinuar de forma gradual las instancias de GitLab locales o en la nube a medida que las plataformas de negocio completen sus períodos de validación en GitHub.
- Implementar estándares globales de GitHub Actions: Desplegar los flujos de trabajo reutilizables validados por CleverIT en las 17 unidades de negocio, evitando desviaciones de configuración y garantizando criterios unificados de cumplimiento para CI/CD.
- Impulsar la adopción a nivel empresarial: Iniciar programas de capacitación y adopción para fortalecer las competencias de los equipos de ingeniería del cliente en el ecosistema nativo de GitHub, los controles avanzados de entornos y la gestión integrada de secretos.