Despliegue Automatizado de Blog Hugo

1. Introducción: Centralización y Flujo de Despliegue

He decidido centralizar mis notas y artículos técnicos en un blog alojado en mi VPS de OVHCloud. Para agilizar la publicación de mis notas en Markdown, elegí el compilador estático Hugo por su agilidad.

Mi curiosidad por la forma en que se realizan los despliegues profesionales me llevó a migrar de un flujo de trabajo manual (basado en rsync desde mi PC) a un flujo automatizado “Push-to-Deploy”. En este documento recopilaré las decisiones de arquitectura que he tomado, así como la resolución de errores.

2. Comparación de Flujos de Despliegue

El nuevo flujo de trabajo utiliza GitHub como la única Fuente de Verdad para el código fuente y el VPS como el Punto de Control de Despliegue, invirtiendo la lógica del proceso anterior.

3. Flujo de Trabajo Final “Push-to-Deploy”

La idea es que, después de editar o crear un nuevo documento y subir los cambios (git push) a GitHub, se ejecute el script en el VPS. Esto asegura que la compilación (build) y los ajustes de permisos se realicen en el propio entorno de producción.

1. Actualización: Ejecutar git pull origin main para sincronizar el código fuente.
2. Compilación: Ejecutar hugo con la configuración y el tema asignados.
3. Despliegue Atómico: Ejecutar rsync para actualizar el sitio web (/var/www/blog_hugo), manteniendo el sitio en un estado consistente.
4. Robustez: Aplicar permisos (chown/chmod) para garantizar el Principio de Mínimo Privilegio y que Apache pueda leer el contenido sin riesgo.

4. El Script: deploy.sh

#!/bin/bash

# --- SCRIPT DE DESPLIEGUE AUTOMATIZADO ---
# Creado para el proyecto Hugo/VPS/Git

# 1. Variables de entorno
REPO_ROOT="/opt/hugo-source/hugo-blog-source" # Ruta del directorio desde donde arranca el script
WEB_ROOT="/var/www/blog_hugo" # Ruta del sitio web
HUGO_BIN="/usr/local/bin/hugo" # el path donde se instaló hugo

# 2. Navega al directorio del repositorio
cd "$REPO_ROOT"

# 3. Pull: Obtiene la última versión del código fuente desde GitHub
echo "Paso 1: Obteniendo la última versión del código desde GitHub..."
git pull origin main 
if [ $? -ne 0 ]; then
    echo "ERROR: Falló el git pull. Verifique la conexión SSH y el Deploy Key."
    exit 1
fi

# 4. Build: Compila el sitio con Hugo (genera la carpeta 'public')
echo "Paso 2: Compilando el sitio con Hugo..."
"$HUGO_BIN" --config hugo.yaml --buildDrafts
if [ $? -ne 0 ]; then
    echo "ERROR: Falló la compilación de Hugo. Revise el código fuente."
    exit 1
fi

# 5. Deploy: Sincroniza los archivos compilados con la carpeta de producción
# El comando 'rsync -avz --delete' borra todo lo que no esté en la carpeta 'public/'
echo "Paso 3: Sincronizando los archivos a la carpeta de producción ($WEB_ROOT)..."

rsync -avz --delete public/ "$WEB_ROOT"
# 5b. ¡FIX DE PERMISOS! Asigna el propietario y grupo al servidor web para garantizar lectura.
echo "Paso 3b: Aplicando permisos de servidor web..."
sudo chown -R debian:www-data "$WEB_ROOT"
# Aseguramos que el grupo (www-data) pueda leer y atravesar directorios.
sudo chmod -R g+rX "$WEB_ROOT"
echo "Despliegue completado con éxito."

5. Más Automatización: Evolución a Webhooks

El plan de automatización se orienta a un verdadero flujo de Integración Continua (CI).

El script deploy.sh actualmente se ejecuta de forma manual, pero el siguiente paso es la migración a un activador basado en Webhooks. Esto permitirá a GitHub avisar al servidor VPS inmediatamente después de un git push, logrando un despliegue en tiempo real y eliminando la necesidad de tareas programadas (cron).

6. Relación de Problemas Resueltos