Gestión de control de versiones Git™ en cPanel

La función de Control de Versiones Git™ en cPanel te permite alojar y gestionar repositorios Git directamente en tu cuenta.
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 simples documentos de texto.
Si quieres ampliar información, puedes consultar la documentación oficial de Configuración de despliegue y la documentación de Git.

Nota:
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

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

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. Guía de Git: 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

Notas:
- 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 mostrarlos 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, solo deja de estar administrado desde aquí).

Advertencia:
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"
   
   
   
   
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 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 Ruta del repositorio, escribe la carpeta donde se guardará:

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

En 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.

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

Restricciones de ruta

• No modificar ni eliminar la carpeta .git de un repositorio.
• No se permiten rutas con espacios o caracteres especiales como:

\ * | " ' < > & @ \ $ { } [ ] ( ) ; ? : = % #`

• No puedes crear repositorios en carpetas controladas por cPanel.

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

• Ruta del repositorio: ubicación en tu cuenta donde está almacenado. Puedes abrir esa carpeta directamente en el Administrador de Archivos de cPanel en una nueva pestaña.
• Nombre del repositorio: nombre visible en la interfaz. Si quieres cambiarlo, escribe el nuevo nombre y pulsa Actualizar.
• Rama activa (Checked-Out Branch): rama que está actualmente seleccionada en el repositorio. Si eliges otra rama y actualizas, el sistema traerá automáticamente los cambios de la rama remota correspondiente.
• (Si el repositorio es “bare”, esta información no aparecerá).

• HEAD Commit: muestra información sobre el último commit de la rama activa:
  • Commit
  • Autor
  • Fecha
  • Mensaje del commit
    (Si no hay commits o es un repositorio bare, este bloque no se mostrará).
• URL remota: dirección del repositorio en el servidor remoto.
• Clonar URL: enlace que puedes usar para clonar este repositorio en otro lugar (PC, otra cuenta de cPanel, GitHub, etc.).

Extraer o desplegar

• Ruta del repositorio: ubicación en tu cuenta donde está almacenado. Puedes abrir esa carpeta directamente en el Administrador de Archivos de cPanel en una nueva pestaña.

Importante:
No es posible cambiar la ruta de un repositorio que ya existe.

Nombre del repositorio — Es el nombre que se muestra en la interfaz. Si quieres modificarlo, escribe el nuevo nombre y pulsa Actualizar.

Rama actualmente activa — Muestra la rama local que tienes seleccionada en este momento. Puedes hacer clic aquí para abrir la interfaz de Gitweb en una nueva pestaña del navegador.

Nota:
Si el repositorio es de tipo bare (sin copia de trabajo), esta información no aparecerá.

Commit HEAD — En esta parte se muestran los detalles del commit más reciente (HEAD) en la rama activa:

• Commit: código identificador SHA-1 del commit.
• Autor: persona que realizó el commit.
• Fecha: cuándo se hizo el commit.
• Mensaje: el mensaje que se escribió al hacer el commit.
  
  

Nota:
Si la rama no tiene commits o el repositorio es bare, estos datos no se mostrarán.

Información del último despliegue — Aquí verás datos sobre la última vez que se desplegó el repositorio:

• Fecha de despliegue: cuándo se hizo.
• SHA desplegado: identificador SHA-1 del commit que se desplegó.
• Autor: quién hizo ese commit.
• Fecha: cuándo se creó ese commit.
• Mensaje: el mensaje del commit desplegado.

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).

URL remota — Dirección del repositorio remoto.

Desplegar commit HEAD — Permite desplegar los cambios desde la copia que administra cPanel.

• Para que funcione, 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.
• Es muy recomendable 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, revisa la documentación oficial sobre Deployment y Set Up Deployment.