Utiliser le système de contrôle de version Git sur cPanel

Procédure

Qu’est-ce que Git ?

Git est un outil puissant permettant de gérer les versions des fichiers de votre application de manière décentralisée. Celui-ci permet de stocker et basculer facilement entre plusieurs versions sans avoir besoin de gérer manuellement l’emplacement de chaque version de chaque fichier.

Git introduit la notion de référentiel (repository ou repo) qui est un emplacement sur lequel l’entièreté de votre projet est stockée. Celui-ci peut être un emplacement local (un dossier sur votre PC) ou un emplacement distant (hébergé sur votre compte cPanel ou sur github.com par exemple).

Déployer un référentiel Git sur votre PC vers cPanel

Si votre référentiel Git est sur votre PC, vous pouvez utiliser la commande « push » de Git pour déployer votre application sur votre formule cPanel. Pour cela :

1. Assurez-vous que votre connexion SSH entre votre PC et votre compte cPanel est fonctionnel. Référez-vous à la documentation concernant la connexion SSH sur cPanel pour tous les détails.

2. Connectez-vous à votre compte cPanel et rendez-vous sur l’icône « Git™ Version Control ».

3. Cliquez sur le bouton « Créer » pour créer un nouveau référentiel Git sur votre compte cPanel.

3. Remplissez le formulaire comme suit :

• (1) Désactivez « Clone a Repository » étant donné que nous n’allons pas copier un référentiel distant.
• (2) Indiquez dans « Repository Path » l’emplacement que vous souhaitez donner à votre application dans votre formule d’hébergement web.
• (3) Indiquez dans « Repository Name » un nom pour votre référentiel Git.
• (4) Cliquez sur « Créer ».

5. Il vous sera alors fourni les détails de votre référentiel Git sur votre compte cPanel.

6. Sur votre PC, ouvrez votre terminal et placez-vous dans le dossier de votre projet Git.

7. Ajoutez votre référentiel Git sur cPanel comme miroir distant de votre référentiel local avec la commande « git remote add origin ».

Remarques :

• Le format de l’URL est le suivant : ssh://<votre compte cpanel>@<votre site.com> /home/<votre compte cpanel>/chemin/dans/votre/compte/ftp.
• Si vous utilisez un CDN comme Ipxchange ou Cloudflare, vous ne pouvez pas utiliser “votresite.com” car celui-ci est associé à l’adresse IP du serveur CDN et non du serveur cPanel. Vous devez utiliser à la place “ftp.votresite.com” ou le nom d’hôte de votre serveur cPanel.

8. Envoyez la branche « master » de votre référentiel Git local vers votre référentiel Git distant avec la command « git push origin master » :

Et voilà, votre référentiel Git local est désormais publié sur votre compte cPanel.

Déployer un référentiel Git distant sur votre compte cPanel

Il est toutefois possible que votre référentiel Git ne se trouve pas sur votre PC. C’est par exemple le cas si vous travaillez en équipe et que chaque développeur contribue à un référentiel Git placé sur un serveur Gitlab ou sur Github.com.

1. Connectez-vous à votre compte cPanel et rendez-vous sur l’icône « Git™ Version Control ».

2. Cliquez sur le bouton « Créer » pour créer un nouveau référentiel Git sur votre compte cPanel.

3. Remplissez le formulaire comme suit :

• (1) Activez « Clone a Repository » étant donné que nous allons copier un référentiel existant.
• (2) Dans « Clone URL », renseignez l’URL de votre référentiel distant. Pour le cas de Github.com, ceci peut être retrouvé facilement depuis la page principale du référentiel : 
  
• (3) Indiquez dans « Repository Path » l’emplacement que vous souhaitez donner à votre application dans votre formule d’hébergement web.
  (4) Indiquez dans « Repository Name » un nom pour votre référentiel Git.
  (5) Cliquez sur « Créer ».

Déployer un référentiel Git distant sur votre compte cPanel depuis le terminal

Vous pouvez également utiliser le terminal associé à votre compte cPanel pour déployer un référentiel Git.

Pour cela, depuis votre console SSH ou le terminal web cPanel, déplacez-vous dans le dossier dans lequel vous souhaitez mettre votre référentiel Git :

cd ~/public_html/

Ensuite, téléchargez votre référentiel distant avec la commande git clone :

git clone ssh://[email protected]/moncompte/hello-world.git

Si votre référentiel requiert l’usage d’une clé privée spécifique, vous pouvez en générer un avec la commande suivante :

ssh-keygen -t rsa

Ensuite, vous pouvez afficher la clé publique associée avec la commande suivante :

cat ~/.ssh/id_rsa.pub

Vous pouvez alors ajouter cette clé dans les clés de déploiements de votre référentiel distant. Exemple sur Github :

Conclusion

Vous êtes désormais en mesure d'utiliser Git Version Control afin de cloner ou créer un nouveau référentiel sur votre hébergement Web cPanel. Vous savez aussi comment cloner un référentiel cPanel par le biais de votre Terminal SSH ou du logiciel Putty.

N'hésitez pas à partager vos questions et vos remarques !