Los hooks de pre-receive son scripts que se ejecutan en GitHub Enterprise Server antes de que Git acepte las confirmaciones enviadas. Aplican la directiva de repositorio, organización o empresa en el punto en el que el código entra en un repositorio.
Un hook de pre-receive puede comprobar si un envío cumple las reglas requeridas. Por ejemplo, un hook podría bloquear pushes que incluyan secretos, usen mensajes de commit no estándar o modifiquen archivos protegidos. Si el push pasa las comprobaciones, Git lo acepta. Si se produce un error en la inserción, Git lo rechaza y muestra un mensaje de error.
Si tu envío no se acepta, verás un mensaje de error correspondiente al hook de pre-receive que ha fallado.
$ git push
Counting objects: 3, done.
Delta compression using up to 4 threads.
Compressing objects: 100% (2/2), done.
Writing objects: 100% (3/3), 916 bytes | 0 bytes/s, done.
Total 3 (delta 0), reused 0 (delta 0)
remote: always_reject.sh: failed with exit status 1
remote: error: rejecting all pushes
To https://54.204.174.51/hodor/nope.git
! [remote rejected] main -> main (pre-receive hook declined)
error: failed to push some refs to 'https://54.204.174.51/hodor/nope.git'
Los enlaces de recepción previa importan porque aplican reglas de forma coherente antes de que los cambios lleguen al repositorio. Esto puede reducir la carga de revisión manual y evitar que las infracciones de directivas se almacenen en el historial de Git.
El GitHub Enterprise Server administrador de tu sitio crea y elimina los hooks de pre-receive. También pueden permitir que los administradores de la organización o del repositorio habiliten o deshabiliten enlaces para ámbitos específicos. Consulte Requerir políticas para los ganchos de pre-recepción.