Guía de Git: Configurar el despliegue

Introducción

La interfaz Git Version Control de cPanel (cPanel → Archivos → Git Version Control) permite configurar el despliegue de repositorios gestionados en tu cuenta de cPanel.
Existen muchos tipos de configuraciones posibles, pero aquí nos centraremos en dos métodos principales:

• Despliegue por push (recomendado)
• Despliegue por pull

Tipos de despliegue

Despliegue por Push

1. Descargas cambios desde un repositorio remoto a tu equipo local.
2. Empujas esos cambios hacia el repositorio gestionado en cPanel.
3. El sistema despliega automáticamente cualquier cambio que llegue al repositorio en cPanel.

Despliegue por Pull

1. Descargas cambios desde un repositorio remoto a tu equipo local.
2. Subes cambios nuevos desde tu equipo local al repositorio remoto.
3. En cPanel, manualmente extraes esos cambios del remoto y luego despliegas.

Configuración de despliegue por Push (recomendado)

1 Crear un repositorio vacío en cPanel

• Abre cPanel → Archivos → Git Version Control.
• Crea un nuevo repositorio pero no lo clones desde uno remoto en este paso.
  Debe ser completamente vacío.

2 Clonar el repositorio remoto en tu equipo

Si no tienes aún el repositorio remoto en tu equipo, clónalo:

git clone URL

• Sustituye URL por la dirección de clonación del repositorio remoto.
• Si es privado, sigue los pasos de Configurar acceso a repositorios privados para evitar errores.

3 Crear el archivo .cpanel.yml

Este archivo define las tareas que se ejecutarán al desplegar.

Debe estar en la raíz del repositorio y controlado por Git.

Ejemplo:

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

• DEPLOYPATH es la ruta donde se copiarán los archivos en tu hosting.
• Puedes incluir tantas tareas como necesites.

4 Añadir el repositorio de cPanel como remoto

En tu copia local, añade el repositorio vacío que creaste en cPanel como origin:

git remote add origin URL

• URL es la URL de clonación del repositorio en cPanel.

5 Subir cambios a cPanel

Envía el contenido (incluido el .cpanel.yml) al repositorio en cPanel:

git push -u origin HEAD

Una vez el repositorio en cPanel contenga el archivo .cpanel.yml, cualquier push posterior se desplegará automáticamente.

Configuración de despliegue por Pull

1 Clonar el repositorio remoto en cPanel

• Entra a cPanel → Archivos → Git Version Control.
• Clona el repositorio remoto directamente en tu cuenta de cPanel.
• Si usas ssh://, el sistema verificará la clave pública del host remoto.

2 Clonar también en tu equipo local

Si no lo tienes en tu máquina, clónalo:

git clone URL

3 Crear el archivo .cpanel.yml

Igual que en el despliegue por push, añade un archivo como este:

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

Este archivo puede crearse y enviarse desde tu copia local o desde el repositorio remoto (requiere permisos de escritura o pull request).

4 Subir cambios al repositorio remoto

En tu equipo local:

git push origin HEAD

5 Actualizar y desplegar desde cPanel

Para traer los cambios y desplegarlos manualmente:

1. Abre cPanel → Archivos → Git Version Control.
2. Localiza el repositorio y pulsa Manage.
3. Ve a la pestaña Pull or Deploy.
4. Pulsa Update from Remote para traer cambios.
5. Pulsa Deploy HEAD Commit para desplegar.

Repite cada vez que quieras actualizar.

Notas importantes

• Para despliegues automáticos con repos privados, asegúrate de que el acceso SSH está configurado.
• El archivo .cpanel.yml es clave: sin él, no se ejecutará el despliegue.
• Usa rutas absolutas en DEPLOYPATH y comandos completos (/bin/cp) para evitar fallos.