Git en interface graphique : clonage, historique et déploiement automatique

Important : vous disposez désormais de l'outil Deploy+, qui connecte des dépôts GitHub, GitLab, Bitbucket et d'autres fournisseurs et gère les versions depuis l'espace client. Pour en savoir plus : Deploy, outil de déploiement automatique depuis GitHub.

Vous pouvez travailler avec Git depuis la ligne de commande ou gérer vos dépôts via l'interface de cPanel. Ce guide décrit le flux de Git Version Control, indépendant de Deploy+.

Git Version Control apporte une interface graphique pour gérer Git depuis cPanel de façon simple, rapide et pratique.

Créer un nouveau dépôt

En ouvrant l'option Create / Créer, un formulaire s'affiche. Par défaut, l'option Clone reste activée : comme son nom l'indique, elle permet de cloner un dépôt distant à partir d'une URL compatible. Utilisez HTTPS ou SSH, vérifiez l'identité du serveur et évitez d'inclure des jetons dans l'URL. Pour les dépôts privés, consultez le guide de clonage avec une clé SSH.

Si vous désactivez l'option Clone, vous pouvez créer un dépôt vide, comme le ferait git init, ou ajouter à l'interface un dépôt qui existe déjà au chemin indiqué.

Repository Path est le chemin où sera hébergé le dépôt (nous vous recommandons de le placer en dehors de public_html), et Repository Name un nom pour identifier le dépôt créé.

Options de gestion

L'option Manage / Gérer donne accès à des options de base comme la modification du nom du dépôt ou le choix de la branche utilisée. Elle affiche aussi le HEAD Commit, l'URL distante s'il s'agit d'un dépôt cloné et l'URL de notre dépôt.

L'accès au dépôt que vous hébergez est privé et se fait par le protocole SSH : la personne qui y accède doit disposer d'une identité SSH autorisée, comme l'explique le guide d'accès SSH.

Pull ou déploiement

Dans Manage, on dispose aussi de l'onglet Pull or Deploy.

L'option Update from Remote met à jour depuis le dépôt utilisé pour le clonage (si vous avez utilisé cette méthode), en appliquant les changements qui peuvent exister entre l'origine et notre clone.

En revanche, Deploy HEAD Commit exécute les tâches du commit actuel, selon ce que nous indiquons dans le fichier .cpanel.yml, qui permet de définir des stratégies de mise en production. Nous l'expliquons en détail dans « Stratégies de déploiement automatique avec Git ».

History (Gitweb)

L'option History donne accès à l'historique des commits et des modifications du dépôt : comparer des versions, télécharger un snapshot, faire des recherches internes, entre autres fonctions qui permettent d'examiner le dépôt en détail.

Supprimer le dépôt

La fonction Remove / Supprimer retire le dépôt de la gestion de cPanel, mais ne supprime ni son répertoire ni ses données. Si vous voulez aussi supprimer les fichiers, faites-le ensuite depuis le gestionnaire de fichiers ou le terminal, après avoir vérifié le chemin et conservé toute sauvegarde nécessaire.

Vérifier une mise à jour

Confirmez la branche et le commit avant d'utiliser Update from Remote. Mettre à jour le clone ne revient pas à exécuter Deploy HEAD Commit. Le résultat de la publication dépend de .cpanel.yml : vérifiez ses chemins et ses tâches avant la première utilisation et suivez la sortie jusqu'à la fin.

Si le répertoire cloné est déjà la racine qui sert le site, le pull lui-même peut rendre visibles de nouveaux fichiers avant que les tâches ne soient terminées. Utilisez une structure de déploiement planifiée et testez l'application ensuite ; l'interface Git ne crée pas à elle seule de retour en arrière pour la base de données ou les fichiers publiés.