Gestión de control de versiones Git™ en cPanel: guía completa

La función de Control de Versiones Git™ en cPanel te permite alojar y gestionar repositorios Git directamente en tu cuenta de hosting. Es útil para administrar cualquier conjunto de archivos: desde el código y recursos de un sitio web, hasta proyectos de desarrollo de software o documentos de texto.

Si quieres ampliar información, puedes consultar la documentación oficial de Configuración de despliegue y la documentación oficial de Git.

ℹ️ Todos los repositorios creados desde cPanel incluyen automáticamente un hook post-receive. Puedes encontrar más detalles en la documentación de githooks de Git.

Uso de Git desde la línea de comandos

⚠️ Si tu cuenta no tiene acceso a shell, solo podrás crear, clonar, eliminar o visualizar repositorios desde la interfaz gráfica de cPanel.

En cambio, si cuentas con acceso shell, podrás usar Git directamente desde la terminal para realizar tareas como:

• Configurar SSH para clonar repositorios privados. Consulta la guía Configurar el acceso a repositorios privados.
• Trabajar con múltiples repositorios remotos (recomendado para usuarios con experiencia en Git).

Puedes abrir una terminal desde el propio cPanel en: Inicio → Avanzado → Terminal.

Gestión de repositorios

ℹ️ Clonar un repositorio puede tardar varios minutos, durante los cuales las opciones estarán deshabilitadas y solo verás el nombre, la ruta y un mensaje de progreso.

ℹ️ Si agregas o eliminas repositorios manualmente por línea de comandos, la lista en la interfaz podría no mostrarse correctamente. Solo se listarán los creados desde la interfaz de cPanel.

En la tabla de repositorios encontrarás:

• Nombre del repositorio.
• Ruta del repositorio en tu cuenta.

Acciones disponibles:

• Administrar: modificar ajustes, actualizar el repositorio o desplegar cambios.
• Historial: abre Gitweb para explorar el repositorio, su historial y contenido.
• Eliminar: quita el repositorio de la gestión de cPanel (no borra los archivos físicos, solo deja de estar administrado desde aquí).

⚠️ Al eliminar la gestión desde cPanel, el repositorio no se borrará físicamente. Para eliminarlo por completo debes hacerlo manualmente desde el Administrador de Archivos o vía SSH.

Crear un repositorio

1. Accede a «Control de versión de Git» en cPanel.

2. Pulsa Crear (parte superior derecha).

3. Elige una de estas opciones:

• Clonar un repositorio existente: activa el interruptor «Clonar un repositorio» e introduce la URL de clonación. Si es privado, deberás configurar el acceso SSH previamente.
• Crear uno nuevo o añadir uno ya existente a la lista: desactiva la opción de clonar.

Requisitos para la URL de clonación:

• Debe comenzar con http://, https://, ssh://, git:// o el formato usuario@dominio:/ruta.
• No puede contener usuario y contraseña embebidos.
• No se permiten rutas locales.

En el campo Ruta del repositorio, escribe la carpeta donde se guardará:

• Si no existe, se creará automáticamente.
• Si ya contiene un repositorio Git, se añadirá a la lista de cPanel.

En el campo Nombre del repositorio, introduce el nombre que quieres mostrar en la interfaz.

Verificación de clave SSH

Si usas una URL con ssh://:

• El sistema comprobará la clave pública del servidor remoto.
• Si no está registrada, te pedirá confirmarla y la añadirá a ~/.ssh/known_hosts.
• Si la clave ha cambiado, mostrará una advertencia.

❗ Si no puedes verificar el cambio de clave, no continúes: podría ser un ataque Man-in-the-Middle.

Restricciones de ruta

• No modifiques ni elimines la carpeta .git de un repositorio.
• No se permiten rutas con espacios o caracteres especiales: \ * | " ' < > & @ $ { } [ ] ( ) ; ? : = % #
• No puedes crear repositorios en carpetas controladas por cPanel.

Rutas no permitidas:

• .cpanel
• .trash
• etc
• mail
• ssl
• tmp
• logs
• .cphorde
• spamassassin
• .htpasswds
• var
• cgi-bin
• .ssh
• perl5
• access-logs

Administrar un repositorio

En Administrar podrás:

• Cambiar el nombre visible del repositorio.
• Cambiar de rama y actualizar desde el remoto.
• Consultar información del último commit (autor, fecha, mensaje, hash SHA-1).
• Obtener la URL de clonación para copiar el repositorio en otro servidor o equipo.

Información básica del repositorio

• Ruta del repositorio: ubicación en tu cuenta. Puedes abrir esa carpeta directamente en el Administrador de Archivos de cPanel.
• Nombre del repositorio: nombre visible en la interfaz. Para cambiarlo, escribe el nuevo nombre y pulsa Actualizar.
• Rama activa (Checked-Out Branch): rama actualmente seleccionada. Si eliges otra rama y actualizas, el sistema traerá automáticamente los cambios de la rama remota correspondiente. Esta información no aparecerá si el repositorio es de tipo bare.
• HEAD Commit: información sobre el último commit de la rama activa (hash SHA-1, autor, fecha y mensaje). No aparece si no hay commits o si el repositorio es bare.
• URL remota: dirección del repositorio en el servidor remoto.
• Clonar URL: enlace para clonar este repositorio en otro lugar (PC, otra cuenta de cPanel, GitHub, etc.).

Extraer o desplegar

ℹ️ No es posible cambiar la ruta de un repositorio que ya existe.

Esta sección permite gestionar la sincronización y el despliegue del repositorio:

• Ruta del repositorio: ubicación del repositorio en tu cuenta. Puedes abrirla en el Administrador de Archivos desde aquí.
• Nombre del repositorio: nombre visible en la interfaz. Si quieres modificarlo, escribe el nuevo nombre y pulsa Actualizar.
• Rama actualmente activa: muestra la rama local seleccionada en este momento. Si el repositorio es de tipo bare, esta información no aparecerá. Puedes hacer clic para abrir la interfaz de Gitweb en una nueva pestaña.
• Commit HEAD: detalles del commit más reciente en la rama activa (hash SHA-1, autor, fecha, mensaje). No se mostrará si la rama no tiene commits o el repositorio es bare.
• Información del último despliegue: datos sobre el último despliegue realizado (fecha, SHA desplegado, autor, fecha del commit y mensaje).

Actualizar desde remoto

Permite traer (pull) los cambios desde el repositorio remoto y aplicarlos a la copia administrada por cPanel. Se usa la opción --ff-only, lo que significa que solo funcionará si la rama está actualizada o puede avanzarse de forma rápida (fast-forward).

Desplegar commit HEAD

Permite desplegar los cambios desde la copia que administra cPanel.

• Es obligatorio tener un archivo .cpanel.yml y al menos una rama local o remota.
• El sistema ejecutará las tareas definidas en .cpanel.yml para hacer el despliegue.
• Se recomienda guardar el archivo .cpanel.yml en el repositorio remoto y no en la copia que gestiona cPanel.
• Si el repositorio tiene cambios sin confirmar (dirty working tree), no se podrá desplegar.

Para más información sobre cómo desplegar, consulta la guía de Configuración de despliegue Git.

Preguntas frecuentes sobre Git en cPanel

¿Puedo usar Git en el hosting compartido de Nicalia?

Sí. La función de Control de Versiones Git™ está disponible en cPanel de Nicalia. Puedes crear repositorios, clonar desde GitHub u otros remotos, gestionar ramas y desplegar cambios directamente desde la interfaz gráfica. Para operaciones avanzadas (push/pull por terminal, múltiples remotos) necesitas acceso SSH a tu cuenta.

¿Cómo clonar un repositorio de GitHub en cPanel?

En cPanel ve a Git Version Control → Crear. Activa el interruptor «Clonar un repositorio» e introduce la URL de clonación de GitHub (https://github.com/usuario/repo.git para repositorios públicos, o la URL SSH para privados). Indica la ruta de destino y el nombre, y pulsa Crear.

¿Qué es el archivo .cpanel.yml y para qué sirve?

El archivo .cpanel.yml define las tareas que cPanel ejecuta automáticamente al desplegar el repositorio. Especifica qué comandos correr, a qué directorio copiar los archivos, etc. Es imprescindible para usar la función «Desplegar commit HEAD». Se recomienda guardarlo en el repositorio remoto y no en la copia local que gestiona cPanel.

¿Por qué no aparece un repositorio que creé por SSH en la lista de cPanel?

La interfaz de Git Version Control en cPanel solo muestra los repositorios que fueron creados o añadidos desde su propia interfaz. Los repositorios creados directamente por línea de comandos no aparecen automáticamente. Para añadirlos, usa la opción Crear en cPanel, introduce la ruta donde está el repositorio existente y cPanel lo incorporará a la lista.

¿Puedo eliminar completamente un repositorio desde la interfaz de cPanel?

La opción «Eliminar» de cPanel solo quita el repositorio de la gestión de la interfaz — los archivos físicos permanecen en el servidor. Para eliminar completamente un repositorio debes hacerlo manualmente: borra la carpeta del repositorio desde el Administrador de Archivos de cPanel o por SSH.