Control de versiones Git en cPanel

Git Version Control en cPanel te permite crear, clonar y gestionar repositorios Git directamente desde el panel de control. Puedes conectar tu sitio web con repositorios remotos en GitHub, GitLab o Bitbucket para desplegar cambios automaticamente.

1. Acceder a Git Version Control

1. Inicia sesion en tu cuenta de cPanel.
2. En la seccion Desarrollo, haz clic en Git™ Version Control.
3. Veras la lista de repositorios existentes (si los hay) y la opcion de crear uno nuevo.

2. Crear un repositorio nuevo

Opcion A: Clonar un repositorio existente

1. Haz clic en Crear.
2. Selecciona Clonar un repositorio.
3. Escribe la URL del repositorio (ejemplo: https://github.com/usuario/mi-sitio.git).
4. En Ruta de referencia del repositorio, ingresa la ruta donde se clonara (ejemplo: public_html o una subcarpeta como public_html/mi-proyecto).
5. Haz clic en Crear.

Consejo: Usa ramas especificas para produccion (como main o master) para evitar clonar ramas de desarrollo.

Opcion B: Crear un repositorio vacio

1. Haz clic en Crear.
2. Selecciona Crear un repositorio nuevo.
3. Escribe el nombre del repositorio (ejemplo: mi-sitio).
4. En Ruta de referencia del repositorio, ingresa la ruta (ejemplo: public_html).
5. Haz clic en Crear.

Esto inicializa un repositorio Git vacio en la ruta especificada.

3. Gestionar un repositorio existente

Desde la pagina principal de Git Version Control, haz clic en un repositorio para ver sus opciones:

• Detalles: Muestra la rama actual, la URL remota y la ruta local.
• Cambios pendientes: Archivos modificados, anadidos o eliminados que aun no se han commit.
• Historial: Lista de commits realizados con fecha, autor y mensaje.
• Cerrar: Elimina el registro del repositorio de cPanel (no borra los archivos).

4. Realizar commits desde cPanel

1. Accede al repositorio desde Git Version Control.
2. En la pestana Cambios pendientes, veras los archivos modificados.
3. Marca los archivos que quieres incluir en el commit.
4. Escribe un mensaje descriptivo del cambio.
5. Haz clic en Commit.

Importante: Los commits realizados aqui son locales. Para sincronizar con un repositorio remoto, necesitas hacer push.

5. Conectar con GitHub, GitLab o Bitbucket

Paso 1: Obtener la URL remota

1. En tu repositorio (GitHub, GitLab o Bitbucket), copia la URL HTTPS del repositorio.
   • GitHub: https://github.com/usuario/repositorio.git
   • GitLab: https://gitlab.com/usuario/repositorio.git
   • Bitbucket: https://bitbucket.org/usuario/repositorio.git

Paso 2: Configurar la URL remota en cPanel

1. Accede a tu repositorio en Git Version Control.
2. Haz clic en Administrar y luego en Editar configuracion.
3. En URL del repositorio remoto, pega la URL copiada.
4. Guarda los cambios.

Paso 3: Autenticacion

Para repositorios privados, cPanel solicita credenciales:

• GitHub: Usa un Personal Access Token (no tu contrasena). Ve a GitHub, Settings, Developer settings, Personal access tokens y genera uno con permiso repo.
• GitLab: Usa un Personal Access Token. Ve a GitLab, Preferences, Access Tokens y crea uno con alcance read_repository y write_repository.
• Bitbucket: Usa una App Password. Ve a Bitbucket, Personal settings, App passwords y crea una con permisos Repositories: Read and Write.

6. Push y Pull de cambios

Push (subir cambios a GitHub/GitLab/Bitbucket)

1. Accede al repositorio en cPanel.
2. Haz clic en Push.
3. Selecciona la rama a enviar.
4. Ingresa las credenciales si es la primera vez (usuario + token).
5. Confirma el push.

Pull (descargar cambios del repositorio remoto)

1. Accede al repositorio en cPanel.
2. Haz clic en Pull.
3. Selecciona la rama remota a descargar.
4. Confirma el pull.

Consejo: Antes de hacer pull, asegurate de no tener cambios locales sin commit para evitar conflictos de fusion.

7. Cambiar de rama

1. En el repositorio, haz clic en Administrar y luego en Cambiar rama.
2. Selecciona la rama que quieres usar.
3. Haz clic en Cambiar.

cPanel actualizara los archivos del directorio para reflejar la rama seleccionada.

8. Deploy automatico con Webhooks

Puedes configurar un webhook en GitHub/GitLab/Bitbucket para que cada push actualice automaticamente tu sitio en cPanel:

1. En cPanel, Git Version Control, selecciona tu repositorio.
2. Copia la URL del webhook que aparece en la configuracion.
3. En GitHub: Ve a tu repositorio, Settings, Webhooks, Add webhook.
   • Payload URL: pega la URL de cPanel.
   • Content type: application/json.
   • Secret: dejalo vacio (cPanel no lo requiere).
   • Marca Just the push event.
4. Haz clic en Add webhook.

Cada vez que hagas push a GitHub, cPanel ejecutara un pull automatico.

9. Ruta de deployment

Si tu sitio web esta en public_html, asegurate de que la ruta de referencia del repositorio apunte a esa carpeta al crear o clonar el repositorio.

Si usas subdominios, la ruta sera algo como: public_html/misubdominio

Si la ruta no coincide con la de tu sitio, los cambios no se reflejaran en la web hasta que copies los archivos manualmente o configures la ruta correctamente.

10. Solucion de problemas

11. Consejos practicos

• Usa .gitignore: Crea un archivo .gitignore en la raiz de tu repositorio para excluir archivos sensibles (como .env, carpetas de node_modules, o archivos temporales).
• No subas archivos sensibles: Nunca incluyas contrasenas, claves API o archivos de configuracion con datos de conexion a bases de datos en repositorios publicos.
• Trabaja con ramas: Crea ramas para nuevas funcionalidades y fusiona con main cuando esten listas.
• Haz commits frecuentes: Commits pequenos y descriptivos facilitan el seguimiento de cambios y la resolucion de conflictos.
• Usa mensajes de commit claros: Describe brevemente que cambio y por que (ejemplo: "Actualiza diseno del formulario de contacto").

12. Comandos Git utiles

Si necesitas usar la linea de comandos SSH para operaciones avanzadas, estos son los comandos mas comunes:

Consejo: Si tu plan de hosting incluye acceso SSH, puedes usar estos comandos directamente desde la terminal para mayor flexibilidad.