Comment connecter votre compte cPanel à un dépôt GitHub privé

Introduction

Ce guide explique comment connecter de manière sécurisée votre compte d'hébergement cPanel à un dépôt GitHub privé grâce à l'authentification SSH.

Prérequis

• Accès à votre compte cPanel
• Contrôle de version Git activé
• Accès à votre dépôt GitHub privé

Étape 1 : générer une clé SSH

Option A : à l'aide de l'interface cPanel

1. Connectez-vous à cPanel
2. Accédez à Sécurité → Accès SSH
3. Cliquez sur Gérer les clés SSH
4. Cliquez sur Générer une nouvelle clé
5. Saisissez :
   • Nom de la clé : repo
   • Type de clé : RSA
   • Taille de la clé : 4096
6. Cliquez sur Générer la clé

Option B : à l'aide du terminal

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

Appuyez trois fois sur Entrée lorsque vous y êtes invité.

Étape 2 : autoriser la clé SSH

1. Accédez à Accès SSH → Gérer les clés SSH
2. Cliquez sur Gérer
3. Cliquez sur Autoriser

Étape 3 : configurer SSH

1. Ouvrez cPanel → Gestionnaire de fichiers
2. Accédez au répertoire .ssh (activez l'affichage des fichiers cachés)
3. Créez un fichier nommé config

Host github.com
    IdentityFile ~/.ssh/repo

Remplacez repo par le nom de votre clé si celui-ci est différent.

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

Étape 4 : copier la clé publique

cat ~/.ssh/repo.pub

Copiez l'intégralité de la sortie.

Étape 5 : ajouter la clé SSH à GitHub

1. Connectez-vous à GitHub
2. Accédez à votre dépôt privé
3. Cliquez sur votre icône de profil (en haut à droite) → Paramètres
4. Cliquez sur Clés SSH et GPG
5. Cliquez sur Nouvelle clé SSH
6. Collez votre clé et enregistrez

Étape 6 : cloner le dépôt dans cPanel

1. Accédez à cPanel → Git Version Control
2. Cliquez sur Créer
3. Saisissez :

git@github.com:username/repository.git

Sélectionnez un chemin de dépôt et cliquez sur Créer.

Facultatif : déploiement automatique

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

Dépannage

• Permission denied : Clé SSH non ajoutée ou autorisations incorrectes
• Repository not found : URL incorrecte ou problème d'accès
• Échec du clonage : Vérifiez la configuration SSH et la mise en place de la clé