Cómo conectar su cuenta de cPanel a un repositorio privado de GitHub

Introducción

Esta guía explica cómo conectar de forma segura su cuenta de hosting de cPanel a un repositorio privado de GitHub mediante autenticación SSH.

Requisitos previos

• Acceso a su cuenta de cPanel
• Control de versiones de Git habilitado
• Acceso a su repositorio privado de GitHub

Paso 1: Genere una clave SSH

Opción A: Mediante la interfaz de cPanel

1. Inicie sesión en cPanel
2. Vaya a Seguridad → Acceso SSH
3. Haga clic en Administrar claves SSH
4. Haga clic en Generar una nueva clave
5. Introduzca:
   • Nombre de la clave: repo
   • Tipo de clave: RSA
   • Tamaño de la clave: 4096
6. Haga clic en Generar clave

Opción B: uso del terminal

ssh-keygen -t rsa -f ~/.ssh/repo -b 4096 -C "git@mydomain.com"

Pulse Enter tres veces cuando se le solicite.

Paso 2: Autorizar la clave SSH

1. Vaya a Acceso SSH → Administrar claves SSH
2. Haga clic en Administrar
3. Haga clic en Autorizar

Paso 3: Configurar SSH

1. Abra cPanel → Administrador de archivos
2. Vaya al directorio .ssh (active la visualización de archivos ocultos)
3. Cree un archivo llamado config

Host github.com
    IdentityFile ~/.ssh/repo

Sustituya repo por el nombre de su clave, si es distinto.

chmod 600 ~/.ssh/config
chmod 600 ~/.ssh/repo
chmod 644 ~/.ssh/repo.pub

Paso 4: Copiar la clave pública

cat ~/.ssh/repo.pub

Copie la salida completa.

Paso 5: Añadir la clave SSH a GitHub

1. Inicie sesión en GitHub
2. Vaya a su repositorio privado
3. Haga clic en el icono de su perfil (arriba a la derecha) → Configuración
4. Haga clic en Claves SSH y GPG
5. Haga clic en Nueva clave SSH
6. Pegue su clave y guarde

Paso 6: Clonar el repositorio en cPanel

1. Vaya a cPanel → Control de versiones de Git
2. Haga clic en Crear
3. Introduzca:

git@github.com:username/repository.git

Seleccione una ruta de repositorio y haga clic en Crear.

Opcional: implementación automática

---
deployment:
  tasks:
    - export DEPLOYPATH=/home/USERNAME/public_html/
    - /bin/cp -R * $DEPLOYPATH

Solución de problemas

• Permiso denegado: La clave SSH no se ha agregado o los permisos son incorrectos
• Repositorio no encontrado: URL incorrecta o problema de acceso
• Error al clonar: Compruebe la configuración de SSH y de la clave