![\"\"](\"https:\/\/blog.hostinger.io\/com-ar-tutoriales\/wp-content\/uploads\/sites\/38\/2022\/12\/eBook-Speed-Up-your-website-ES-1024x283.png\")
<\/a><\/figure>En este artículo, aprenderás más sobre qué son los Git Hooks y cómo utilizarlos tanto en el lado del cliente como en el del servidor. También proporcionaremos algunos ejemplos de Git Hooks para que los implementes en tu propio proyecto.<\/p>
¿Qué es Git?<\/h2>
Antes de abordar el tema de cómo funcionan los Git Hooks y cómo usarlos, repasemos rápidamente qué es Git.<\/p>
Git es una aplicación de control de versiones de código abierto. Con él, los usuarios pueden supervisar y hacer un seguimiento detallado del desarrollo del software. Puedes crear ramas de desarrollo, registrar los cambios y tener un control absoluto sobre las versiones de los archivos de tu proyecto.<\/p>
Git es muy popular entre los desarrolladores de software, y la mayoría de los proyectos de código abierto lo utilizan.<\/p>
¿Qué son los Git Hooks?<\/h2>
Los Git Hooks son scripts que se ejecutan automáticamente antes o después de ejecutar comandos Git como Commit y Push. Con los scripts de Git Hooks, los usuarios pueden personalizar el comportamiento interno de Git automatizando acciones específicas a nivel de programas y deployment.<\/p>
Git incluye ejemplos de hooks en cualquier repositorio Git. Sin embargo, sitios como GitHub<\/a> o GitLab no permiten su uso en primera instancia. Por ello, los Git Hooks se utilizan principalmente en instancias locales o privadas.<\/p> Ten en cuenta que el sistema debe tener permisos de ejecución para ejecutar un determinado hook o gancho.<\/p> Los Hooks se almacenan en la carpeta .git\/hooks\/ <\/strong>del directorio de cada proyecto. Con la función de directorios de plantillas de Git<\/a>, los usuarios pueden instalarlos automáticamente. Siempre que uses “git init” o “git clone”, todos los archivos y directorios del directorio de plantillas se copiarán en el nuevo repositorio Git vacío.<\/p> En .git\/hooks\/<\/strong> encontraremos una serie de hooks de ejemplo, tales como commit-msg.sample<\/strong>, post-update.sample<\/strong>, y pre-commit.sample<\/strong>, que son un buen punto de partida.<\/p> La instalación de los hooks implica crear un archivo ejecutable y guardarlo en el directorio .git\/hooks\/<\/strong>.<\/p> Los hooks locales o del lado del cliente se activan por eventos que se ejecutan en el ordenador local, como cuando confirmas o fusionas un proyecto.<\/p> En general, hay tres tipos de Hooks locales o del lado del cliente:<\/p> Para instalar un git hook:<\/p> Si quieres utilizar Python:<\/p> Si quieres utilizar Bash<\/a>:<\/p> Si quieres utilizar shell:<\/p> Ten en cuenta que para que un gancho se ejecute correctamente, el valor de salida debe ser 0. Para que falle, el valor de salida debe ser igual a 1. Si quieres incluir varias condiciones, deben estar presentes en el mismo archivo.<\/p> También es importante recordar que los scripts de hook no se comprueban en el control de versiones de Git por defecto. En otras palabras, no pueden ser confirmados. Si se elimina el directorio local de hooks, Git eliminará todos los hooks o ganchos y sus versiones anteriores del proyecto.<\/p> Como solución, puedes añadir un enlace simbólico al repositorio de Git. Como resultado, los scripts de hooks habilitados pueden ser confirmados en el control de versiones. A continuación te explicamos cómo hacerlo:<\/p> Además, si por alguna razón quieres evitar un gancho activo, añade “-no-verify” al comando correspondiente. Por ejemplo, introduce el siguiente comando para omitir los ganchos de confirmación:<\/p> Uso de los Pre-Hooks<\/strong><\/p> Un pre-hook se ejecuta antes de un evento en particular en el repositorio Git.<\/p> El hook de pre-commit, por ejemplo, puede utilizarse para aplicar una política de confirmación y evitar confirmaciones incorrectas. Si el gancho sale con un estado distinto de cero, Git lo abortará.<\/p> Aquí tienes algunos ejemplos de ganchos previos locales:<\/p> Algunos de estos ganchos pueden parecer similares entre sí, como los scripts pre-push y pre-commit. Es importante saber qué gancho satisfará mejor tus necesidades.<\/p> El script pre-commit se ejecuta antes de que escribas un mensaje de confirmación, mientras que pre-push se ejecuta antes de que el nuevo contenido se suba a un repositorio remoto. Funcionan en diferentes puntos del ciclo del proyecto, pero puedes utilizar ambos para evitar confirmaciones y empujes incorrectos, asegurando un mejor flujo de trabajo.<\/p> Utilizar los post-ganchos<\/strong><\/p> Git ejecuta un post-gancho después de que se produzca un determinado evento en el repositorio.<\/p> Los post-ganchos se utilizan a menudo para automatizar las respuestas a otras acciones, como el envío de correos electrónicos de notificación cuando se añade un nuevo commit de Git.<\/p> Estos son algunos ejemplos de post-ganchos locales:<\/p> Los scripts gancho del lado del servidor se ejecutan en repositorios o servidores remotos que reciben pushes de un equipo local. Pueden ejecutarse antes o después de los pushes del servidor. Los pre-hooks del lado del servidor, por ejemplo, pueden interrumpir cualquier Git push que salga con un mensaje distinto de cero.<\/p> Aquí tienes algunos ejemplos de hooks del lado del servidor:<\/p> Los pasos para instalar los ganchos del lado del servidor son los mismos que los del lado del cliente. La única diferencia es que debes colocar los scripts en el directorio .git\/hooks<\/strong> situado en el servidor remoto en lugar de en el directorio local.<\/p> Existen muchos casos de uso para los scripts de hook. Echa un vistazo a los siguientes ejemplos.<\/p> Este ejemplo muestra la información de una acción commit. Este hook se llama después de recibir el mensaje de confirmación por defecto y antes de que se abra el editor de mensajes de confirmación<\/p> Crea un archivo llamado prepare-commit-msg en la carpeta .git\/hooks\/<\/strong> de tu repositorio. Luego, escribe el siguiente script:<\/p> Luego, guárdalo. Y establece los permisos de ejecución para el archivo.<\/p> Con este simple Hook, al realizar una acción commit, instantáneamente recibirás información relevante al respecto cuando se realice.<\/p> Este Hook pre-push permite generar la documentación de tu código si cuentas con un generador. Cada vez que haces un cambio, la documentación se ejecutará automáticamente.<\/p> Crea un pre-push en la misma carpeta que antes y agrega el script:<\/p> Guarda el archivo y, finalmente, establece el permiso de ejecución.<\/p> Este Git Hook tipo pre-commit es bastante simple de ejecutar. Crea un archivo llamado pre-commit y agrega lo siguiente:<\/p>Cómo usar los Git Hooks<\/h2>
Cómo utilizar los Hooks locales<\/h3>
\n
\n
chmod +x [hook-name] <\/code><\/code><\/li>\n\n\n\n#!\/usr\/bin python<\/pre>
#!\/bin\/bash<\/pre>
#!\/bin\/sh<\/pre>
\n
\n
ln -s -f ..\/hooks\/[hook-name] .git\/hooks\/[hook-name]<\/pre>
git commit --no-verify -m [commit message]<\/pre>
\n
\n
Cómo utilizar los ganchos del lado del servidor<\/h3>
\n
![\"\"](\"https:\/\/www.hostinger.com\/ar\/tutoriales\/wp-content\/uploads\/sites\/38\/2022\/11\/git-hooks-es.jpg\")
<\/figure>Ejemplos de Git Hooks<\/h2>
Mostrar información sobre una acción commit<\/h3>
#!\/bin\/sh\n\nSOB=$(git config github.user)\ngrep -qs \"^$SOB\" \"$1\" || echo \". Cambio por @$SOB\" >> \"$1\"<\/pre>
:~$ chmod +x prepare-commit-msg<\/pre>
Generar documentación a medida que se cargan los cambios<\/h3>
#!\/bin\/bash\n\ndoxygen Doxyfile\ngit add docs\/\ngit commit -m \"Update documentation ($(date +%F@%R))\"<\/pre>
:~$ chmod +x pre-push<\/pre>
Buscar y corregir espacios en blanco en commits<\/h3>
#!\/bin\/bash -l\n.git\/hooks\/pre-commit-master-no-no\nif [[ $? == 1 ]]\nthen\nexit 1\nfi\n\n.git\/hooks\/pre-commit-debugger\n.git\/hooks\/pre-commit-trailing-spaces\n.git\/hooks\/pre-commit-images\n.git\/hooks\/pre-commit-pair<\/pre>
![\"\"](\"https:\/\/blog.hostinger.io\/com-ar-tutoriales\/wp-content\/uploads\/sites\/38\/2023\/02\/ES-Web-hosting_in-text-banner-1024x300.png\")
<\/a><\/figure>