Guía de Git: Despliegue

Introducción

La función Git Version Control de cPanel (cPanel → Archivos → Git Version Control) permite desplegar código de repositorios gestionados en tu cuenta.
El despliegue normalmente envía código finalizado al entorno de producción, por ejemplo, para aplicar cambios a tu sitio web.

Puedes configurarlo para que:

Push deployment: despliegue automático al hacer push desde tu equipo.
Pull deployment: despliegue manual desde la interfaz de cPanel.

Requisitos para el despliegue

Antes de que un repositorio pueda desplegarse, debe cumplir con:

Tener un archivo válido .cpanel.yml en la raíz del repositorio.
Contar con una o más ramas locales o remotas.
Tener el árbol de trabajo limpio (sin cambios pendientes).

Si no se cumplen estas condiciones:

No se mostrará información de despliegue en la interfaz.
El botón o la función de despliegue estarán deshabilitados.

El archivo `.cpanel.yml`

Este archivo define cómo y dónde se publican los cambios.
Debe crearse y agregarse al control de versiones (commit) en la carpeta raíz del repositorio.

Importante:

- Los ejemplos de abajo son ilustrativos, debes adaptarlos a tu entorno.

- No uses comodines (*) para copiar todo, ya que podrías subir contenido no deseado (como la carpeta .git).

- Evita caracteres no válidos en YAML. Consulta yaml.org para detalles.

Ejemplo: desplegar archivos individuales

---
deployment:
  tasks:
    - export DEPLOYPATH=/home/example/public_html/
    - /bin/cp index.html $DEPLOYPATH
    - /bin/cp style.css $DEPLOYPATH

Línea 1: inicio del documento YAML.
Líneas 2-3: definición de claves deployment y tasks.
Líneas 4-6: lista de comandos Bash que se ejecutarán durante el despliegue.
Puedes añadir tantos como necesites.
Para comentarios, comienza la línea con #.

Ejemplo: desplegar un directorio completo

---
deployment:
  tasks:
    - export DEPLOYPATH=/home/example/public_html/
    - /bin/cp -R images $DEPLOYPATH

Línea 1: inicio del documento YAML.
Líneas 2-3: definición de claves.
Líneas 4-5: comandos para copiar todo un directorio (opción -R para recursivo).

Despliegue automático (Push deployment)

cPanel añade automáticamente un hook post-receive a todos los repositorios que gestiona.
Cuando haces un git push hacia un repositorio en cPanel que contiene un .cpanel.yml válido:
1. El hook ejecuta el archivo .cpanel.yml.
2. Se copian los cambios a la ruta de producción (por ejemplo, public_html).

Ventajas:

Un solo comando (git push) actualiza el sitio.
Ideal para flujos de trabajo donde el código se prueba en local y se publica directamente.

También puedes reejecutar el despliegue manualmente sin necesidad de subir nuevos cambios.

Despliegue manual (Pull deployment)

Se utiliza cuando el repositorio en cPanel obtiene cambios desde un remoto (no directamente desde tu equipo).
Flujo:
1. Desde tu equipo, haces git push hacia el repositorio remoto (por ejemplo, GitHub).
2. En cPanel, entras a Manage → Pull or Deploy.
3. Pulsas Update from Remote para traer cambios.
4. Pulsas Deploy HEAD Commit para ejecutar el .cpanel.yml y aplicar los cambios en producción.