Git en cPanel: deploy automático desde GitHub a tu hosting

Git Version Control es una funcionalidad incluida en cPanel (disponible desde la versión 76+) que te permite conectar un repositorio Git con tu hosting compartido. Esto significa que puedes usar el mismo flujo de trabajo que en un servidor propio — push a GitHub, pull automático al hosting — sin necesidad de un VPS.

En Elevocloud, Git Version Control está disponible en todos los planes con cPanel, incluyendo los planes compartidos.

Lo que puedes hacer con Git en cPanel:

• Clonar un repositorio remoto (GitHub, GitLab, Bitbucket) directamente en tu hosting
• Configurar un archivo .cpanel.yml para ejecutar comandos personalizados en cada deploy
• Recibir webhooks de GitHub para disparar el deploy automáticamente con cada push

Flujo de deploy: de tu máquina local a producción

Tu máquina local → git push → GitHub (repo) → cPanel (webhook) → Servidor → Producción

Requisitos previos

1. Acceso a cPanel en tu hosting (incluido en todos los planes Elevocloud)
2. Acceso SSH habilitado en tu cuenta de hosting
3. Un repositorio Git en GitHub, GitLab o Bitbucket
4. Git instalado en tu máquina local

Paso 1: Crear el repositorio en cPanel (Git Version Control)

1. Entra a cPanel y busca la sección "Git Version Control"
2. Haz clic en "Crear"
3. Selecciona "Clonar un repositorio remoto"
4. Introduce la URL SSH de tu repositorio (por ejemplo: git@github.com:usuario/mi-sitio.git)
5. Define el directorio de repositorio (por ejemplo: /home/tucuenta/public_html)

Paso 2: Conectar con GitHub (Deploy Keys)

Para que cPanel pueda clonar un repositorio privado en GitHub:

1. En cPanel, ve a "SSH Access" > "Manage SSH Keys"
2. Genera una nueva clave o usa una existente
3. Copia la clave pública (archivo .pub)
4. En GitHub, ve a tu repositorio > Settings > Deploy Keys > Add deploy key
5. Pega la clave pública del servidor

Paso 3: Configurar el archivo .cpanel.yml

El archivo .cpanel.yml define qué comandos ejecutar en el servidor cada vez que se hace un pull.

Ejemplo para sitio WordPress

---
deployment:
  tasks:
    - export DEPLOYPATH=/home/tucuenta/public_html/
    - /bin/cp -R public/. $DEPLOYPATH/
    - /bin/cp -R wp-content/. $DEPLOYPATH/wp-content/

Ejemplo para proyecto PHP/Laravel

---
deployment:
  tasks:
    - export DEPLOYPATH=/home/tucuenta/public_html/
    - /bin/cp -R public/. $DEPLOYPATH/
    - /bin/cp -R .env.example $DEPLOYPATH/ 2>/dev/null || true
    - /usr/local/bin/php $DEPLOYPATH/artisan migrate --force || true
    - /usr/local/bin/php $DEPLOYPATH/artisan config:cache || true

⚠️ Nunca subas wp-config.php, .env o cualquier archivo con credenciales al repositorio. Estos archivos contienen información sensible y deben estar en el .gitignore.

Paso 4: Primer deploy y verificación

1. Haz un cambio en tu repositorio local y ejecuta git push origin main
2. En cPanel > Git Version Control, haz clic en "Deploy HEAD Commit"
3. Revisa el log del deploy para verificar que todo funcionó correctamente

Deploy automático: Update from Remote

El deploy automático con cPanel funciona solo cuando haces push directo al repositorio clonado en cPanel. Si tu flujo usa GitHub como origen, el proceso requiere dos pasos manuales después de cada push:

1. En cPanel > Git Version Control, hacé clic en "Update from Remote" para traer los cambios de GitHub
2. Luego hacé clic en "Deploy HEAD Commit" para aplicarlos al directorio de publicación

cPanel no proporciona una URL de webhook para disparar este proceso automáticamente desde GitHub.

Flujo recomendado: staging vs producción

Para proyectos con tráfico real, usa dos repositorios:

• Rama develop → se despliega a staging.tudominio.com
• Rama main → se despliega a tudominio.com (producción)

Preguntas frecuentes

¿Git Version Control está disponible en todos los planes de Elevocloud?

Sí. Incluido en todos los planes que incluyen cPanel, sin costo adicional.

¿Puedo usar GitLab o Bitbucket?

Sí. El proceso es idéntico — solo cambia dónde añades la deploy key.

¿Puedo revertir un deploy si algo sale mal?

Sí. Desde Git Version Control en cPanel puedes hacer checkout a un commit anterior.

¿Quieres un hosting que soporte Git deploy, SSH y PHP moderno sin pagar un VPS? Los planes de Elevocloud incluyen cPanel completo con Git Version Control. Conoce los planes para desarrolladores.