Introducción: trabajar en un monorepo con varios equipos empujando código a diario puede ser frustrante cuando una rama de feature está lista, todas las comprobaciones pasan y justo al intentar hacer merge GitHub lo bloquea porque la rama está desactualizada con main. Rehacer pull, rebase o merge y esperar que se vuelvan a ejecutar las compilaciones puede costar 20 minutos o más por cada integración. En Q2BSTUDIO, empresa especializada en desarrollo de software y aplicaciones a medida, inteligencia artificial, ciberseguridad y servicios cloud aws y azure, buscamos una solución que mantuviera las ramas sincronizadas sin frenar la productividad.
Problema: en nuestro monorepo todos los ingenieros desarrollan sobre el mismo repositorio y main se actualiza con frecuencia, por lo que las ramas de feature suelen desviarse. Hacer merge sin primero sincronizar con main pone en riesgo sobreescribir cambios importantes o provocar fallos en la integración continua.
Primer intento con reglas de protección de ramas: aplicamos las reglas de protección de GitHub que obligan a que las ramas estén actualizadas con main antes de permitir el merge. Aunque eficaz para detectar ramas desactualizadas, esto obligaba a reejecutar pipelines largos de Jenkins de 8 minutos o más cada vez que se añadía un commit a la rama. La regla protegía la integridad del repositorio pero reducía drásticamente la productividad de los ingenieros, así que no fue la solución definitiva.
La solución que cambió las reglas: gancho pre-push. Tras investigar, ampliamos nuestro uso de Husky que ya gestionaba hooks pre-commit para incluir un hook pre-push. El objetivo fue automatizar la sincronización con main justo antes de enviar los cambios al remoto, evitando esperas innecesarias y reejecuciones de build sin control.
Cómo funciona el gancho pre-push en nuestro flujo: al crear una rama desde main y trabajar en ella, cuando el ingeniero ejecuta git push el hook pre-push se dispara automáticamente. El hook realiza estas comprobaciones y acciones: verifica que la rama no sea main; confirma que la rama tenga upstream; comprueba si la rama está desincronizada con main. Si la rama está detrás de main, el hook extrae la última versión de main desde el remoto y la fusiona en la rama de feature. Si aparecen conflictos, el hook detiene el push y muestra un mensaje indicando al ingeniero que resuelva los conflictos manualmente antes de volver a intentar. Si no hay conflictos, el merge se comete automáticamente y el push continúa.
Resultados: cada rama se garantiza actualizada con main en el momento del push, lo que redujo significativamente el tiempo perdido en reejecuciones de builds, disminuyó los conflictos de merge y permitió que los ingenieros se enfocaran en escribir código. Este cambio fue especialmente útil para equipos que desarrollan aplicaciones a medida y software a medida, donde la agilidad y la entrega continua son clave.
Cosas a tener en cuenta: aunque el gancho pre-push mejoró mucho el flujo, no es infalible. Se pueden saltar los hooks con git push --no-verify, por lo que es conveniente combinar la política local con controles en el repositorio. Si un merge aprobado se realiza mucho tiempo después, la rama puede seguir quedando desactualizada. Algunas IDEs muestran cambios sin enviar incluso después del push; en esos casos un git fetch suele resolver la discrepancia.
Cómo implementarlo de forma segura: recomendamos documentar el flujo y educar a los equipos sobre el uso de pre-push hooks, prohibir pushes directos a main con reglas de protección complementarias y monitorizar excepciones. Para entornos críticos, combinar hooks locales con verificaciones server side y pipelines en la nube mejora la garantía de integridad. Si quieres apoyo en la implementación o auditoría de este tipo de automatizaciones, en Q2BSTUDIO ofrecemos servicios de desarrollo de aplicaciones y software a medida y servicios de inteligencia artificial para empresas que incluyen agentes IA y soluciones de IA para empresas integradas con pipelines de DevOps.
Servicios relacionados: además de automatización de procesos y control de versiones, Q2BSTUDIO presta servicios de ciberseguridad y pentesting para proteger el ciclo de vida del software, servicios cloud aws y azure para desplegar CI CD escalables, y servicios de inteligencia de negocio y power bi para explotar datos operativos. Si tu equipo gestiona un monorepo activo y sufre pérdida de tiempo por ramas desincronizadas, probar un gancho pre-push es una mejora simple y poderosa que puede ahorrar horas de compilaciones repetidas y reducir fricciones en el desarrollo.