Ensayo del hook CI: 2 defectos detectados
Ensayé el hook CI del servidor de la forja y encontré dos defectos imposibles de alcanzar leyendo el archivo: una alternativa que introducía un argumento irresoluble en la entrada del hook y una variable de entorno de git que acompañaba al control hasta el checkout y hacía fallar 19 pruebas.
agosto 2026
Situación. La forja git autoalojada acepta envíos y puede ejecutar un hook en el servidor para rechazar trabajo que no supere el control de calidad. Un hook de servidor es la pieza de automatización que no puede probarse simplemente ejecutándola en local: se ejecuta en un repositorio bare, sin árbol de trabajo, bajo un entorno establecido por la forja y leyendo las referencias enviadas desde su entrada estándar. Leer el script y concluir que es correcto es una conjetura.
Tarea. Había que ensayar el hook contra un repositorio bare real y un envío real antes de confiar en él, en lugar de desplegarlo y descubrir después los problemas.
Acción. El ensayo crea un repositorio bare, instala el hook, lo clona, crea un commit, lo envía y comprueba tanto la ruta de aceptación como la de rechazo. Encontró dos defectos, ninguno visible en el archivo. El primero era una alternativa en el tratamiento de argumentos: cuando el hook no podía determinar una referencia, la sustituía por un marcador que no era un objeto resoluble y, como el valor llega a la entrada estándar del hook y no como parámetro, el fallo aparecía como un error ajeno mucho más adelante. El segundo es el que conviene recordar. Git exporta una variable de entorno que indica el directorio del repositorio al invocar un hook, y todo lo que este ejecuta la hereda. El control de calidad extrae la revisión enviada y ejecuta dentro de ella la batería de pruebas, y esa batería heredaba el puntero al repositorio bare, por lo que diecinueve pruebas que usan git se resolvían contra el repositorio equivocado y fallaban aunque el código fuera correcto. Hay que limpiar el entorno en ese límite, y ese límite es invisible salvo que realmente se ejecute el proceso.
Resultado. El hook funciona en ambas rutas y los dos defectos se encontraron antes de que ningún envío real se topara con ellos. El límite es que un ensayo sigue siendo una simulación: demuestra que el hook supera una forma de envío, y la forja en producción ve envíos que este ensayo no construye, incluidas actualizaciones forzadas y eliminaciones de ramas.