Contrôle de version Git : Héberger et gérer des dépôts dans cPanel

Gestion de versions Git : Héberger et gérer des dépôts dans cPanel

Avec la Gestion de versions Git dans cPanel, vous pouvez créer, cloner et gérer des dépôts Git directement dans votre compte d'hébergement. Git est idéal pour organiser de manière traçable les modifications apportées aux fichiers de sites web, modèles, thèmes, composants ou projets logiciels. Au lieu de remplacer manuellement les fichiers, vous travaillez avec des versions, des commits et des branches.

Pour les développeurs, les agences et les administrateurs de sites web avancés, Git est un élément essentiel d'un flux de travail propre. Les modifications peuvent être préparées et testées localement, puis transférées de manière ciblée vers le serveur. Cela vous permet de garder une meilleure vue d'ensemble sur les fichiers qui ont été modifiés, quand et pourquoi.

La fonctionnalité Git de cPanel est particulièrement utile si vous souhaitez cloner un projet existant depuis une plateforme comme GitHub, GitLab ou Bitbucket sur votre compte d'hébergement, ou si vous souhaitez créer un nouveau dépôt directement sur le serveur. Selon la configuration de votre hébergement, vous pouvez également utiliser des déploiements pour transférer des fichiers de manière contrôlée vers un répertoire cible.

Qu'est-ce que Git et pourquoi est-ce utile ?

Git est un système de gestion de versions. Il ne se contente pas de sauvegarder des fichiers, il documente l'historique des modifications du projet. Chaque modification peut être enregistrée sous la forme d'un commit. Cela permet de comprendre ultérieurement quels fichiers ont été modifiés, quand la modification a eu lieu et quelle description y a été associée.

Git est particulièrement utile lorsque :

• plusieurs personnes travaillent sur un même projet,
• les modifications doivent être documentées de manière traçable,
• de nouvelles fonctionnalités doivent d'abord être testées,
• un processus de déploiement sécurisé est souhaité,
• le code ne doit plus être écrasé « à l'aveugle » via FTP,
• un site web est maintenu directement à partir d'un dépôt.

Surtout pour les sites web professionnels, Git constitue un avantage majeur. Au lieu de télécharger des fichiers individuels manuellement via FTP, les modifications peuvent être appliquées de manière contrôlée. Cela réduit les erreurs et rend le développement plus traçable à long terme.

Que peut faire la fonctionnalité Git dans cPanel ?

La gestion de versions Git dans cPanel offre une interface graphique pour les tâches de base liées aux dépôts. Vous pouvez l'utiliser pour créer des dépôts, cloner des dépôts existants, afficher les dépôts gérés par cPanel et effectuer certaines actions de gestion.

Les fonctions typiques sont :

• créer de nouveaux dépôts Git dans le compte d'hébergement,
• cloner des dépôts existants à partir de sources externes,
• ajouter des dépôts Git locaux existants à la gestion cPanel,
• afficher les informations des dépôts dans un aperçu,
• sélectionner ou gérer les branches, dans la mesure où l'interface le permet,
• récupérer ou déployer des modifications, si configuré,
• afficher l'historique via Gitweb,
• supprimer des dépôts de la gestion cPanel.

Cependant, l'interface cPanel ne remplace pas toutes les fonctions Git en ligne de commande. Pour des tâches avancées telles que des stratégies de branche complexes, des conflits de fusion (merge), la configuration de clés SSH, des dépôts distants multiples ou des hooks Git personnalisés, vous aurez normalement besoin de la ligne de commande.

Créer un dépôt ou cloner un dépôt ?

Lors de la configuration d'un dépôt Git dans cPanel, il existe généralement deux voies typiques : vous créez un nouveau dépôt directement dans le compte d'hébergement ou vous clonez un dépôt déjà existant depuis une plateforme externe.

Configurer un nouveau dépôt Git dans cPanel

Le nom exact des champs peut varier légèrement selon la version de cPanel et la langue. Le processus de base reste toutefois similaire.

Instructions étape par étape

1. Connectez-vous à cPanel.
2. Dans la section Fichiers, ouvrez la fonction Gestion de versions Git (ou Git Version Control).
3. Cliquez sur Créer (ou Create).
4. Décidez si vous souhaitez cloner un dépôt existant ou en créer un nouveau.
5. En cas de clonage, saisissez l'URL de clonage du dépôt externe.
6. Définissez le chemin du dépôt, c'est-à-dire le répertoire dans lequel le dépôt doit être enregistré.
7. Attribuez un nom d'affichage explicite.
8. Vérifiez attentivement toutes les informations.
9. Cliquez sur Créer pour initialiser le dépôt.

Si vous clonez un dépôt externe, l'opération peut prendre un certain temps selon la taille du projet. Pendant ce temps, certaines actions dans l'interface peuvent être temporairement indisponibles.

URL de clonage : HTTPS ou SSH ?

Lors du clonage d'un dépôt externe, vous avez besoin d'une URL de clonage. Celle-ci peut varier selon la plateforme et le type d'accès.

cPanel autorise certains formats pour les URL de clonage, notamment les URL contenant http://, https://, ssh://, git:// ou des formats de type SSH comme user@example.com:path. Les identifiants ne doivent pas être intégrés directement sous forme de combinaison nom d'utilisateur-mot de passe dans l'URL.

Bien choisir le chemin du dépôt

Le chemin du dépôt détermine l'endroit où le dépôt Git sera stocké dans votre compte d'hébergement. Ce chemin doit être choisi délibérément. Tous les dossiers ne sont pas adaptés, et certains répertoires système sont verrouillés pour les dépôts gérés par cPanel.

Des exemples appropriés peuvent être :

• /home/utilisateur/repositories/mon-projet
• /home/utilisateur/git/mon-theme
• /home/utilisateur/public_html/projet, si le dépôt doit délibérément se trouver directement dans le répertoire web

Pour les sites web en production, il est souvent plus propre de ne pas utiliser le dépôt lui-même directement comme répertoire web public, mais de configurer un déploiement séparé vers le répertoire cible souhaité. Cela évite que des fichiers de développement, des fichiers de configuration ou des fichiers de projet inutiles ne deviennent accessibles au public.

Restrictions de chemin et caractères interdits

cPanel impose des restrictions sur les chemins des dépôts afin de protéger les zones système et d'éviter les problèmes techniques. Les dépôts ne peuvent pas être créés dans certains répertoires contrôlés par cPanel. Cela inclut des répertoires tels que .cpanel, .ssh, .trash, etc, logs, mail, ssl, tmp ou d'autres zones système similaires. Certains caractères spéciaux sont également interdits dans les chemins des dépôts.

Un chemin de dépôt propre pourrait être, par exemple, git/mon-projet ou repositories/site-client. Évitez les noms comme Mon Projet 2026! ou les chemins contenant des caractères spéciaux.

Gérer le dépôt : Manage, History et Remove

Après avoir créé ou cloné un dépôt, celui-ci apparaît dans l'aperçu cPanel. Selon la version de cPanel et l'état du dépôt, différentes actions y sont disponibles.

• Gérer / Manage : Ouvre les paramètres du dépôt. Ici, vous pouvez vérifier les paramètres gérés par cPanel, récupérer des modifications ou exécuter un déploiement, si celui-ci a été configuré.
• Historique / History : Ouvre la vue Gitweb. Vous pouvez y consulter les commits, les fichiers et l'historique du projet dans votre navigateur.
• Supprimer / Remove : Supprime le dépôt de la gestion cPanel. Cela met fin à la gestion par cPanel ; selon la documentation de cPanel, les données du dépôt dans le répertoire ne sont pas automatiquement supprimées par cette action.

Déploiement avec Git dans cPanel

Un dépôt seul ne signifie pas automatiquement que votre site web est mis à jour en direct. Lors d'un déploiement, les fichiers du dépôt sont transférés ou mis à jour dans un répertoire cible. Dans cPanel, un déploiement peut être effectué manuellement via l'interface ou via des hooks Git, selon la configuration.

Pour les déploiements cPanel, un fichier nommé .cpanel.yml est souvent utilisé. Ce fichier décrit les actions à exécuter lors du déploiement, par exemple le fait de copier certains fichiers dans un répertoire cible.

Un exemple simplifié peut ressembler à ceci :

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

Ce projet est donné uniquement à titre d'illustration. Le chemin /home/utilisateur/public_html/ doit être adapté à votre compte d'hébergement réel. De plus, tous les projets ne devraient pas être déployés globalement avec cp -R *, car cela pourrait copier des fichiers qui ne devraient pas être accessibles au public.

Le répertoire .git et la sécurité

Un dépôt Git contient un répertoire interne nommé .git. C'est là que se trouve l'historique des versions du projet. Ce répertoire est techniquement important et ne doit pas être modifié ou supprimé manuellement.

cPanel prend des mesures de protection pour s'assurer que le répertoire .git des dépôts gérés par cPanel ne soit pas accessible publiquement via le navigateur. Néanmoins, vous devez être prudent avec les sites web en production si les dépôts se trouvent directement dans le répertoire web. Une séparation nette entre le dépôt et la cible de déploiement constitue souvent la structure la plus sûre.

Flux de travail recommandé pour les sites web

Un flux de travail Git propre aide à éviter les erreurs et à rendre les modifications traçables. Pour de nombreux sites web, le processus suivant est adapté :

1. Développez et testez les modifications localement sur votre ordinateur.
2. Enregistrez les modifications avec des commits Git explicites.
3. Transférez les modifications vers un dépôt central, par exemple sur GitHub, GitLab ou Bitbucket.
4. Clonez ou mettez à jour le dépôt dans cPanel.
5. Exécutez un déploiement contrôlé dans le répertoire web souhaité.
6. Testez le site web dans le navigateur après le déploiement.
7. En cas de problème, vérifiez l'historique Git et les dernières modifications déployées.

Ce processus est nettement plus sûr que des modifications spontanées directement sur le serveur de production. Surtout pour les projets clients, les boutiques ou les sites web de production, les modifications doivent être aussi traçables et reproductibles que possible.

Git et WordPress : Qu'est-ce qui est pertinent ?

Git peut également être utile pour les projets WordPress, mais doit être utilisé de manière délibérée. WordPress est composé de fichiers et d'une base de données. Git versionne les fichiers, mais pas automatiquement le contenu de la base de données comme les articles, les pages, les réglages ou les commandes.

Pour WordPress, Git est adapté par exemple pour :

• les thèmes personnalisés,
• les extensions (plugins) personnalisées,
• les thèmes enfants (child themes),
• les fichiers de configuration sans identifiants sensibles,
• les fichiers de projet pour le développement et le déploiement.

En règle générale, il n'est pas judicieux de versionner entièrement tout le dossier wp-content/uploads contenant de gros fichiers médias ou des répertoires de cache. Un tel contenu peut gonfler inutilement un dépôt.

Qu'est-ce qui n'a pas sa place dans un dépôt Git ?

Tous les fichiers ne doivent pas être stockés dans Git. Les fichiers particulièrement sensibles ou générés automatiquement doivent être exclus.

• Les identifiants et mots de passe
• Les fichiers .env contenant des paramètres confidentiels
• Les répertoires de cache
• Les fichiers temporaires
• Les gros fichiers de téléchargement ou médias, à moins qu'ils ne doivent être délibérément versionnés
• Les fichiers de développement locaux
• Les sauvegardes (backups) et archives ZIP
• Les dépendances générées, si elles sont reproductibles via des gestionnaires de paquets

On utilise généralement un fichier nommé .gitignore à cet effet. Dans ce fichier, vous déterminez quels fichiers ou dossiers Git doit ignorer.

# Exemple pour un .gitignore simple
.env
*.log
cache/
tmp/
node_modules/
vendor/
*.zip

Les entrées pertinentes dépendent du projet. Les exclusions types diffèrent selon qu'il s'agit de sites PHP, Node.js, WordPress ou de sites statiques.

Problèmes courants avec Git dans cPanel

Bonnes pratiques pour les dépôts Git en hébergement web

• Utilisez des noms de dépôts clairs et sans caractères spéciaux.
• Évitez autant que possible de placer les dépôts directement dans des dossiers système sensibles.
• Séparez le dépôt du répertoire web public si un processus de déploiement est envisageable.
• Ne stockez pas de mots de passe, de clés d'API ou d'identifiants dans le dépôt.
• Utilisez un fichier .gitignore adapté.
• Documentez les modifications avec des messages de commit explicites.
• Testez les déploiements après chaque modification.
• Ne modifiez jamais manuellement le dossier .git.
• Utilisez des dépôts privés pour les projets confidentiels.
• Vérifiez soigneusement les droits d'accès et SSH pour les dépôts externes.

FAQ sur la gestion de versions Git dans cPanel

Puis-je utiliser Git dans cPanel sans SSH ?

Oui, de manière limitée. Vous pouvez créer, cloner, afficher et supprimer des dépôts via l'interface cPanel. Toutefois, un accès Shell/SSH est généralement requis pour les dépôts privés, les clés SSH, les dépôts distants multiples ou les commandes Git plus complexes.

Puis-je cloner un dépôt GitHub privé ?

Oui, en principe c'est possible, mais cela nécessite une authentification supplémentaire. Souvent, une configuration de clé SSH est requise à cet effet. Sans clés correctement configurées, l'accès aux dépôts privés échoue généralement.

Mon site web sera-t-il mis à jour automatiquement si je clone un dépôt ?

Non, pas automatiquement dans tous les cas. Un dépôt cloné se trouve d'abord dans un répertoire de votre compte d'hébergement. Pour que les modifications apparaissent en direct sur le site web, le dépôt doit soit se trouver directement dans le répertoire web, soit un déploiement vers le répertoire web doit être configuré.

Qu'est-ce que Gitweb ?

Gitweb est une interface web qui vous permet de consulter l'historique, les commits et le contenu d'un dépôt. Elle sert à l'observation et à l'analyse, mais ne remplace pas un environnement de développement complet.

Que se passe-t-il si je supprime un dépôt de cPanel ?

Le dépôt est retiré de la gestion cPanel et n'apparaît plus dans l'interface Git. Les fichiers situés dans le répertoire du dépôt ne sont pas automatiquement supprimés selon la documentation cPanel. Si vous souhaitez supprimer complètement les données, vous devez les effacer séparément.

Dois-je placer mon dépôt directement dans public_html ?

C'est techniquement possible, mais pas toujours recommandé. Pour de nombreux projets, il est plus sûr de stocker le dépôt en dehors du répertoire web public et de ne déployer que les fichiers nécessaires de manière ciblée vers public_html.

Git peut-il versionner ma base de données ?

Non. Git versionne les fichiers. Les contenus de bases de données tels que les articles WordPress, les commandes de boutique ou les paramètres de CMS ne sont pas automatiquement versionnés par ce biais. Des stratégies de sauvegarde ou de migration distinctes sont nécessaires à cet effet.