
📅 Publicado el 21 de noviembre, 2026 · Por Equipo RedServicio
Hooks de git para despliegues automáticos: si alguna vez has subido cambios por FTP a mano después de cada commit, ya sabes lo tedioso que resulta. Y lo peligroso. Olvidas un archivo, subes una versión vieja, y a depurar production a las tantas de la tarde. Los hooks de Git permiten ejecutar scripts automáticamente en momentos clave del flujo de trabajo, convirtiendo un simple git push en un despliegue completo a tu servidor. Aquí verás qué son, qué tipos te interesan y cómo configurarlos paso a paso en tu propio hosting.
¿Qué son los hooks de Git y por qué usarlos para desplegar?
Los hooks de Git son scripts que se ejecutan automáticamente antes o después de determinados eventos: un commit, un push, un merge. Se guardan en la carpeta .git/hooks/ de tu repositorio y, por defecto, Git incluye ejemplos con extensión .sample que puedes activar simplemente renombrándolos y dándoles permisos de ejecución.
¿La gran ventaja? Eliminas el error humano. Olvidar subir un archivo, desincronizar versiones entre local y producción, publicar código que ni siquiera pasa los tests… Todo eso desaparece cuando el proceso está automatizado. Con un hook bien configurado, cada push puede disparar tests, compilar assets y sincronizar los archivos con el servidor de producción sin que tú toques nada.
Algunos beneficios prácticos:
- Ahorro de tiempo: un solo comando sustituye cinco o seis pasos manuales.
- Consistencia: todos los despliegues siguen exactamente el mismo proceso.
- Seguridad: puedes bloquear el push si los tests fallan, evitando publicar código roto.
- Trazabilidad: el historial de commits se convierte, de hecho, en el historial de despliegues.
Tipos de hooks útiles para despliegues: pre-push, post-receive y post-merge
No todos los hooks sirven para lo mismo. Estos tres son los que más te van a importar:
pre-push
Se ejecuta en tu máquina local antes de que el push llegue al servidor. Ideal para lanzar tests o el linter: si el script devuelve un código de salida distinto de cero, el push se cancela. Por ejemplo:
Consejo: en .git/hooks/pre-push puedes poner npm test || exit 1 para bloquear pushes con tests fallando.
post-receive
El hook estrella del lado del servidor. Se ejecuta en el repositorio remoto (un bare repo) después de recibir los cambios. Aquí es donde harás git checkout de los archivos, instalarás dependencias con Composer o npm y reiniciarás servicios. Si tu hosting usa cPanel o SSH, este es tu hook.
post-merge
Se ejecuta localmente tras un git pull o un merge. Muy útil en entornos de staging para lanzar automáticamente composer install, migraciones de base de datos o limpiar cachés cada vez que actualizas el código.
Configuración de hooks de git para despliegues automáticos paso a paso
Vamos a montar un despliegue básico con post-receive. Los pasos:
- Crea un repositorio bare en tu servidor: git init –bare /ruta/deploy.git
- Añade ese repo como remoto en tu proyecto local: git remote add deploy usuario@servidor:/ruta/deploy.git
- Crea el archivo /ruta/deploy.git/hooks/post-receive con el script de despliegue.
- Dale permisos de ejecución: chmod +x post-receive
Un script post-receive mínimo y funcional sería algo tan simple como GIT_WORK_TREE=/var/www/miweb git checkout -f master, seguido de comandos como composer install –no-dev o un rsync hacia el directorio público. A partir de ahí, cada vez que hagas git push deploy master, la web se actualizará sola. Sin FTP. Sin sustos.
Con esta base ya tienes despliegues automáticos funcionando; en la siguiente parte veremos casos avanzados, gestión de errores y buenas prácticas de seguridad.
Ejemplo práctico: script de despliegue con post-receive en tu servidor
Vamos a ver un ejemplo completo y funcional de un hook post-receive que compila, limpia y despliega una aplicación web en el directorio público. El script se guarda en tu-repo.git/hooks/post-receive, en el servidor. Nada más.
- Determina la rama recibida: lee la entrada estándar para saber qué referencia se acaba de actualizar.
- Cambia al directorio de trabajo: usa git –work-tree=/var/www/miweb –git-dir=/ruta/repo.git checkout -f para volcar los archivos sin necesidad de un checkout completo.
- Ejecuta tareas de build: instala dependencias y compila assets si el proyecto lo requiere.
- Registra el resultado: guarda un log con fecha para auditar cada despliegue.
Un script de ejemplo:
#!/bin/bash
while read oldrev newrev refname; do
branch=$(git rev-parse –symbolic –abbrev-ref $refname)
if [ «$branch» == «main» ]; then
git –work-tree=/var/www/miweb –git-dir=/home/git/miweb.git checkout -f main
cd /var/www/miweb
composer install –no-dev –optimize-autoloader
echo «$(date) – Despliegue de $newrev completado» >> /var/log/deploy.log
fi
done
Dale permisos de ejecución con chmod +x post-receive. Y pruébalo antes en desarrollo, por favor. La salida del script te llegará a la terminal cada vez que hagas push, algo que se agradece muchísimo cuando algo falla y quieres saber el porqué al instante.
Buenas prácticas y errores comunes al desplegar con hooks
Los hooks de Git para despliegues automáticos son potentes. Quizá demasiado, si se usan sin criterio. Conviene seguir unas cuantas recomendaciones para evitar sustos en producción:
- Usa siempre el hook post-receive para desplegar: los hooks pre-receive se ejecutan antes de aceptar el push; si el despliegue falla ahí, el repositorio puede quedar en un estado inconsistente.
- Protege la rama de producción: configura el servidor para que solo acepte despliegues desde la rama principal y deshabilita los pushes forzados si es posible.
- Controla los errores: añade comprobaciones como set -e al inicio del script para que se detenga ante el primer fallo, y envía notificaciones por correo o a un canal de chat cuando algo salga mal.
- Nunca guardes credenciales en el hook: utiliza variables de entorno o un archivo de configuración con permisos restrictivos (600) fuera del repositorio.
- Evita dependencias de rutas relativas: usa rutas absolutas en el servidor. El hook no siempre se ejecuta desde el directorio que esperas (creo, y con dolor).
- Prueba los cambios de infraestructura en staging: replica el hook en un entorno de pruebas antes de tocar producción.
¿Los fallos más habituales? Olvidar los permisos de ejecución, no escapar bien las variables en el shell y asumir que el hook tiene acceso a tu perfil de usuario (no carga .bashrc). Ahí caen muchos. Verifica siempre la primera ejecución con un push de prueba.
Conclusión: automatiza tu despliegue y gana tranquilidad
Montar hooks de Git para despliegues automáticos cambia el flujo de trabajo de arriba abajo. Pasas de subir archivos por FTP y rezar para que todo funcione a un sistema reproducible, rápido y auditable con un simple git push. Las una o dos horas que cuesta configurar el hook se recuperan el primer día, casi siempre.
Empieza con un script sencillo. Documenta cada paso en el README del proyecto y ve incorporando mejoras poco a poco: notificaciones, backups previos al despliegue, pruebas automáticas pre-push. Eso sí, un buen despliegue automático necesita una infraestructura fiable detrás; en RedServicio encontrarás hosting con soporte 24/7 y acceso SSH completo para que tus hooks funcionen sin fricciones. Automatiza y dedica tu tiempo a lo que de verdad importa: tu proyecto.
Equipo RedServicio
Artículos escritos y revisados por nuestro equipo técnico especializado en hosting e infraestructura web en España.
¿Listo para un hosting de verdad?
Servidores en España · Soporte 24/7 en español · Migración gratuita
Ver Planes desde 3,95€/mes →