La fonction de contrôle de version Git™ vous permet d'héberger facilement des dépôts Git sur votre compte cPanel. Vous pouvez utiliser Git pour maintenir n'importe quel ensemble de fichiers (par exemple, les fichiers et les actifs d'un site Web, un projet de développement logiciel ou de simples fichiers texte). Pour plus d'informations, lisez notre Guide de Git - Comment configurer le déploiement et la documentation de Git.
Remarque :
Le système ajoute un crochet post-recette à tous les dépôts gérés par cPanel. Pour plus d'informations, lisez la documentation githooks de Git.
Git en ligne de commande
Important :
Sans accès au shell, vous ne pouvez que créer, cloner, supprimer et visualiser les dépôts.
Si votre compte cPanel comprend un accès au shell, vous pouvez également utiliser Git à partir de la ligne de commande. Vous devez utiliser la ligne de commande pour effectuer les tâches suivantes :
Configuration SSH afin de cloner des dépôts privés. Pour plus d'informations, lisez notre documentation Guide to Git - Set Up Access to Private Repositories.
L'utilisation de plusieurs dépôts distants. Nous recommandons cette utilisation aux utilisateurs avancés de Git uniquement.
Vous pouvez utiliser l'interface Terminal de cPanel (cPanel >> Accueil >> Avancé >> Terminal) pour accéder à la ligne de commande depuis l'interface cPanel.
Dépôts
Note :
Lorsque vous clonez un dépôt, le système peut avoir besoin d'une grande quantité de temps pour terminer. La liste des dépôts désactivera les options pour le dépôt et affichera uniquement le nom du dépôt, le chemin du dépôt et un message de progression.
Si vous ajoutez ou supprimez des dépôts Git via la ligne de commande, il se peut que vous voyiez une liste incorrecte de dépôts dans cette interface. Actuellement, seuls les dépôts que vous avez créés dans cette interface apparaissent dans la liste.
Le tableau des référentiels contient les informations suivantes pour tous les référentiels Git gérés par cPanel de votre compte :
Dépôt - Le nom d'affichage du dépôt.
Chemin du référentiel - Le répertoire du référentiel.
Vous pouvez également effectuer les actions suivantes :
Gérer - Cliquez pour mettre à jour les paramètres du dépôt gérés par cPanel ou pour extraire ou déployer des modifications.
Historique - Cliquez pour ouvrir l'interface Gitweb dans un nouvel onglet du navigateur. Gitweb vous permet de parcourir le référentiel et de visualiser son historique et son contenu.
Supprimer - Cliquez pour supprimer la gestion du référentiel par CPanel. Un message de confirmation s'affiche. Cliquez à nouveau sur Remove pour supprimer le référentiel.
Avertissement :
Lorsque vous supprimez la gestion d'un référentiel par cPanel, le référentiel n'apparaît plus dans l'interface et vous ne pouvez pas utiliser cPanel pour le déployer. Cependant, le système ne supprimera pas le répertoire du référentiel ou ses données. Pour supprimer complètement les données du référentiel, utilisez l'interface du gestionnaire de fichiers de cPanel (cPanel >> Accueil >> Fichiers >> Gestionnaire de fichiers) ou votre méthode préférée pour supprimer manuellement les fichiers.
N'oubliez pas :
Lorsque vous clonez un référentiel, le système peut nécessiter un temps important pour se terminer. La liste des référentiels désactivera les options du référentiel et n'affichera que le nom du référentiel, le chemin du référentiel et un message sur la progression du clonage.
Créer un référentiel
Pour créer un nouveau référentiel, effectuez les étapes suivantes :
Cliquez sur Créer dans le coin supérieur droit de l'interface. Une nouvelle interface apparaît.
Choisissez de cloner un référentiel existant, d'en créer un nouveau ou d'ajouter un référentiel existant à la liste des référentiels gérés par cPanel :
Pour cloner un référentiel existant, assurez-vous que le basculeur Cloner un référentiel est activé. Ensuite, entrez l'URL de clonage pour le référentiel que vous souhaitez cloner dans la zone de texte URL de clonage.
Important :
Pour cloner des référentiels privés, vous devez effectuer des étapes supplémentaires. Pour plus d'informations, lisez notre documentation Guide to Git - Set Up Access to Private Repositories.
Pour créer un nouveau référentiel ou ajouter un référentiel existant à la liste des référentiels gérés par cPanel, mettez le bouton Cloner un référentiel sur désactivé.
Important :
Cette URL ne peut pas contenir une paire nom d'utilisateur-mot de passe.
Cette URL doit inclure les protocoles http://, https://, ssh://, ou git:// ou utiliser le format user@example.com/path, où user représente le nom d'utilisateur, example.com représente le domaine, et path représente le chemin du référentiel.
Vous ne pouvez pas saisir un chemin de référentiel local.
Le système effectue des vérifications supplémentaires pour les URL de clone qui utilisent le protocole ssh://. Pour plus d'informations, lisez la section Vérification de la clé d'hôte SSH ci-dessous.
Dans la zone de texte Chemin du référentiel, entrez le chemin d'accès au répertoire qui contiendra le référentiel.
Remarque :
Si le répertoire spécifié n'existe pas actuellement, le système le créera.
Si le répertoire spécifié contient déjà un référentiel, le système l'ajoutera automatiquement à la liste des référentiels gérés par cPanel.
Cette fonctionnalité applique plusieurs restrictions sur les chemins d'accès aux référentiels. Pour plus d'informations, lisez la section Restrictions du chemin du référentiel ci-dessous.
À moins que vous n'ajoutiez un référentiel existant à la liste, le répertoire doit être vide. Les répertoires de sous-domaines contiennent un répertoire cgi-bin et peuvent également contenir un répertoire .well-known. Vous devez les déplacer avant de pouvoir créer un référentiel.
Dans la zone de texte Nom du référentiel, entrez le nom d'affichage souhaité pour le référentiel.
Pour créer immédiatement un autre référentiel, cochez la case Créer un autre.
Cliquez sur Créer, ou cliquez sur Retour à la liste des référentiels pour revenir à la liste des référentiels.
Vérification de la clé hôte SSH
Si vous avez saisi une URL de clone SSH, lorsque vous cliquez sur Créer, le système vérifie automatiquement la clé hôte SSH publique du serveur distant. Le système stocke cette clé dans le fichier /home/user/.ssh/known_hosts, où user représente votre nom d'utilisateur.
Si l'hôte distant n'est pas enregistré dans le système, cliquez sur Enregistrer et continuer pour l'ajouter au fichier (l'enregistrer). Vous pouvez cliquer sur Afficher les informations d'identification de l'hôte pour afficher l'algorithme et les empreintes SHA-256 et MD5 de l'hôte.
Si l'hôte distant est déjà enregistré, le système créera le référentiel.
Si la clé publique de l'hôte distant a changé, le système affiche un avertissement.
Pour les hôtes distants tiers, vérifiez les annonces de mise à jour des clés publiques. La plupart des entreprises qui hébergent des référentiels publient des annonces sur ces changements.
Pour les hôtes distants que vous contrôlez, vérifiez si des événements récents sur votre système ont entraîné des modifications de la clé publique, ou contactez votre administrateur système.
Le système effectue également ce contrôle et demandera la vérification des clés d'hôte modifiées lorsque vous modifiez les informations du référentiel ou mettez à jour le référentiel.
Avertissement :
Si vous ne pouvez pas vérifier la validité d'une modification, faites preuve de prudence, surtout si votre référentiel contient du contenu sensible. Une clé SSH altérée peut indiquer une attaque de type Man-in-the-Middle.
Restrictions sur le chemin du référentiel
Cette fonctionnalité applique plusieurs restrictions aux chemins du référentiel.
Le répertoire .git
Avertissement :
Ne pas modifier ou supprimer le répertoire .git d'un dépôt ou son contenu. Les modifications de ces données peuvent briser irrémédiablement le référentiel.
Le système refuse globalement l'accès public aux répertoires .git des référentiels.
Restrictions relatives aux caractères
Vous ne pouvez pas créer, supprimer ou afficher des dépôts dont le chemin d'accès comprend des espaces ou l'un des caractères suivants
\ * | " ' < > & @ ` $ { } [ ] ( ) ; ? : = % #`
Répertoires contrôlés par cPanel
Vous ne pouvez pas créer, supprimer ou afficher des référentiels dans les répertoires suivants :
Cliquez pour voir...
Gérer les référentiels
Cliquez sur Gérer pour modifier ou déployer des référentiels. Cliquez sur Informations de base pour afficher les informations sur les référentiels, ou cliquez sur Extraire ou Déployer pour extraire ou déployer les modifications.
Informations de base
Extraire ou déployer
Chemin du référentiel - Le répertoire du référentiel. Cliquez pour ouvrir le répertoire du référentiel dans l'interface du gestionnaire de fichiers de cPanel (cPanel >> Accueil >> Fichiers >> Gestionnaire de fichiers) dans un nouvel onglet du navigateur.
Nom du référentiel - Le nom d'affichage du référentiel. Pour modifier ce nom, entrez le nouveau nom et cliquez sur Mettre à jour.
Branche extraite - La branche locale actuellement extraite. Pour extraire une autre branche, sélectionnez la branche souhaitée et cliquez sur Mettre à jour.
Si vous sélectionnez une autre branche, le système extrait automatiquement les modifications du référentiel distant lorsqu'il extrait cette branche.
Si le référentiel est un référentiel nu, le système n'affichera pas cette information.
Current Checked-Out Branch - La branche locale actuellement extraite. Cliquez pour ouvrir l'interface Gitweb dans un nouvel onglet du navigateur.
HEAD Commit - Cette section de l'interface affiche des informations sur le HEAD commit de la branche active (le commit le plus récent de la branche). Si le référentiel n'inclut aucun commit pour la branche courante ou est un référentiel nu, le système n'affichera aucune information sur le HEAD Commit. Cliquez sur Historique pour ouvrir l'interface Gitweb dans un nouvel onglet du navigateur.
Commit - La valeur SHA-1 pour le commit HEAD.
Author - L'auteur du commit HEAD.
Date - La date du commit HEAD.
Message de commit - Le message de commit pour le commit HEAD.
URL distant - L'URL du référentiel distant du dépôt.
Clone URL - L'URL à utiliser pour cloner le référentiel vers un autre emplacement (par exemple, votre ordinateur local, un autre compte cPanel ou un compte GitHub). Cliquez sur Copier pour copier cette URL dans votre presse-papiers.
La fonction de contrôle de version Git™ vous permet d'héberger facilement des dépôts Git sur votre compte cPanel. Vous pouvez utiliser Git pour maintenir n'importe quel ensemble de fichiers (par exemple, les fichiers et les actifs d'un site Web, un projet de développement logiciel ou de simples fichiers texte). Pour plus d'informations, lisez notre Guide de Git - Comment configurer le déploiement et la documentation de Git.
Remarque :
Le système ajoute un crochet post-recette à tous les dépôts gérés par cPanel. Pour plus d'informations, lisez la documentation githooks de Git.
Git en ligne de commande
Important :
Sans accès au shell, vous ne pouvez que créer, cloner, supprimer et visualiser les dépôts.
Si votre compte cPanel comprend un accès au shell, vous pouvez également utiliser Git à partir de la ligne de commande. Vous devez utiliser la ligne de commande pour effectuer les tâches suivantes :
Configuration SSH afin de cloner des dépôts privés. Pour plus d'informations, lisez notre documentation Guide to Git - Set Up Access to Private Repositories.
L'utilisation de plusieurs dépôts distants. Nous recommandons cette utilisation aux utilisateurs avancés de Git uniquement.
Vous pouvez utiliser l'interface Terminal de cPanel (cPanel >> Accueil >> Avancé >> Terminal) pour accéder à la ligne de commande depuis l'interface cPanel.
Dépôts
Note :
Lorsque vous clonez un dépôt, le système peut avoir besoin d'une grande quantité de temps pour terminer. La liste des dépôts désactivera les options pour le dépôt et affichera uniquement le nom du dépôt, le chemin du dépôt et un message de progression.
Si vous ajoutez ou supprimez des dépôts Git via la ligne de commande, il se peut que vous voyiez une liste incorrecte de dépôts dans cette interface. Actuellement, seuls les dépôts que vous avez créés dans cette interface apparaissent dans la liste.
Le tableau des référentiels contient les informations suivantes pour tous les référentiels Git gérés par cPanel de votre compte :
Dépôt - Le nom d'affichage du dépôt.
Chemin du référentiel - Le répertoire du référentiel.
Vous pouvez également effectuer les actions suivantes :
Gérer - Cliquez pour mettre à jour les paramètres du dépôt gérés par cPanel ou pour extraire ou déployer des modifications.
Historique - Cliquez pour ouvrir l'interface Gitweb dans un nouvel onglet du navigateur. Gitweb vous permet de parcourir le référentiel et de visualiser son historique et son contenu.
Supprimer - Cliquez pour supprimer la gestion du référentiel par CPanel. Un message de confirmation s'affiche. Cliquez à nouveau sur Remove pour supprimer le référentiel.
Avertissement :
Lorsque vous supprimez la gestion d'un référentiel par cPanel, le référentiel n'apparaît plus dans l'interface et vous ne pouvez pas utiliser cPanel pour le déployer. Cependant, le système ne supprimera pas le répertoire du référentiel ou ses données. Pour supprimer complètement les données du référentiel, utilisez l'interface du gestionnaire de fichiers de cPanel (cPanel >> Accueil >> Fichiers >> Gestionnaire de fichiers) ou votre méthode préférée pour supprimer manuellement les fichiers.
N'oubliez pas :
Lorsque vous clonez un référentiel, le système peut nécessiter un temps important pour se terminer. La liste des référentiels désactivera les options du référentiel et n'affichera que le nom du référentiel, le chemin du référentiel et un message sur la progression du clonage.
Créer un référentiel
Pour créer un nouveau référentiel, effectuez les étapes suivantes :
Cliquez sur Créer dans le coin supérieur droit de l'interface. Une nouvelle interface apparaît.
Choisissez de cloner un référentiel existant, d'en créer un nouveau ou d'ajouter un référentiel existant à la liste des référentiels gérés par cPanel :
Pour cloner un référentiel existant, assurez-vous que le basculeur Cloner un référentiel est activé. Ensuite, entrez l'URL de clonage pour le référentiel que vous souhaitez cloner dans la zone de texte URL de clonage.
Important :
Pour cloner des référentiels privés, vous devez effectuer des étapes supplémentaires. Pour plus d'informations, lisez notre documentation Guide to Git - Set Up Access to Private Repositories.
Pour créer un nouveau référentiel ou ajouter un référentiel existant à la liste des référentiels gérés par cPanel, mettez le bouton Cloner un référentiel sur désactivé.
Important :
Cette URL ne peut pas contenir une paire nom d'utilisateur-mot de passe.
Cette URL doit inclure les protocoles http://, https://, ssh://, ou git:// ou utiliser le format user@example.com/path, où user représente le nom d'utilisateur, example.com représente le domaine, et path représente le chemin du référentiel.
Vous ne pouvez pas saisir un chemin de référentiel local.
Le système effectue des vérifications supplémentaires pour les URL de clone qui utilisent le protocole ssh://. Pour plus d'informations, lisez la section Vérification de la clé d'hôte SSH ci-dessous.
Dans la zone de texte Chemin du référentiel, entrez le chemin d'accès au répertoire qui contiendra le référentiel.
Remarque :
Si le répertoire spécifié n'existe pas actuellement, le système le créera.
Si le répertoire spécifié contient déjà un référentiel, le système l'ajoutera automatiquement à la liste des référentiels gérés par cPanel.
Cette fonctionnalité applique plusieurs restrictions sur les chemins d'accès aux référentiels. Pour plus d'informations, lisez la section Restrictions du chemin du référentiel ci-dessous.
À moins que vous n'ajoutiez un référentiel existant à la liste, le répertoire doit être vide. Les répertoires de sous-domaines contiennent un répertoire cgi-bin et peuvent également contenir un répertoire .well-known. Vous devez les déplacer avant de pouvoir créer un référentiel.
Dans la zone de texte Nom du référentiel, entrez le nom d'affichage souhaité pour le référentiel.
Pour créer immédiatement un autre référentiel, cochez la case Créer un autre.
Cliquez sur Créer, ou cliquez sur Retour à la liste des référentiels pour revenir à la liste des référentiels.
Vérification de la clé hôte SSH
Si vous avez saisi une URL de clone SSH, lorsque vous cliquez sur Créer, le système vérifie automatiquement la clé hôte SSH publique du serveur distant. Le système stocke cette clé dans le fichier /home/user/.ssh/known_hosts, où user représente votre nom d'utilisateur.
Si l'hôte distant n'est pas enregistré dans le système, cliquez sur Enregistrer et continuer pour l'ajouter au fichier (l'enregistrer). Vous pouvez cliquer sur Afficher les informations d'identification de l'hôte pour afficher l'algorithme et les empreintes SHA-256 et MD5 de l'hôte.
Si l'hôte distant est déjà enregistré, le système créera le référentiel.
Si la clé publique de l'hôte distant a changé, le système affiche un avertissement.
Pour les hôtes distants tiers, vérifiez les annonces de mise à jour des clés publiques. La plupart des entreprises qui hébergent des référentiels publient des annonces sur ces changements.
Pour les hôtes distants que vous contrôlez, vérifiez si des événements récents sur votre système ont entraîné des modifications de la clé publique, ou contactez votre administrateur système.
Le système effectue également ce contrôle et demandera la vérification des clés d'hôte modifiées lorsque vous modifiez les informations du référentiel ou mettez à jour le référentiel.
Avertissement :
Si vous ne pouvez pas vérifier la validité d'une modification, faites preuve de prudence, surtout si votre référentiel contient du contenu sensible. Une clé SSH altérée peut indiquer une attaque de type Man-in-the-Middle.
Restrictions sur le chemin du référentiel
Cette fonctionnalité applique plusieurs restrictions aux chemins du référentiel.
Le répertoire .git
Avertissement :
Ne pas modifier ou supprimer le répertoire .git d'un dépôt ou son contenu. Les modifications de ces données peuvent briser irrémédiablement le référentiel.
Le système refuse globalement l'accès public aux répertoires .git des référentiels.
Restrictions relatives aux caractères
Vous ne pouvez pas créer, supprimer ou afficher des dépôts dont le chemin d'accès comprend des espaces ou l'un des caractères suivants
\ * | " ' < > & @ ` $ { } [ ] ( ) ; ? : = % #`
Répertoires contrôlés par cPanel
Vous ne pouvez pas créer, supprimer ou afficher des référentiels dans les répertoires suivants :
Cliquez pour voir...
Gérer les référentiels
Cliquez sur Gérer pour modifier ou déployer des référentiels. Cliquez sur Informations de base pour afficher les informations sur les référentiels, ou cliquez sur Extraire ou Déployer pour extraire ou déployer les modifications.
Informations de base
Extraire ou déployer
Chemin du référentiel - Le répertoire du référentiel. Cliquez pour ouvrir le répertoire du référentiel dans l'interface du gestionnaire de fichiers de cPanel (cPanel >> Accueil >> Fichiers >> Gestionnaire de fichiers) dans un nouvel onglet du navigateur.
Nom du référentiel - Le nom d'affichage du référentiel. Pour modifier ce nom, entrez le nouveau nom et cliquez sur Mettre à jour.
Branche extraite - La branche locale actuellement extraite. Pour extraire une autre branche, sélectionnez la branche souhaitée et cliquez sur Mettre à jour.
Si vous sélectionnez une autre branche, le système extrait automatiquement les modifications du référentiel distant lorsqu'il extrait cette branche.
Si le référentiel est un référentiel nu, le système n'affichera pas cette information.
Current Checked-Out Branch - La branche locale actuellement extraite. Cliquez pour ouvrir l'interface Gitweb dans un nouvel onglet du navigateur.
HEAD Commit - Cette section de l'interface affiche des informations sur le HEAD commit de la branche active (le commit le plus récent de la branche). Si le référentiel n'inclut aucun commit pour la branche courante ou est un référentiel nu, le système n'affichera aucune information sur le HEAD Commit. Cliquez sur Historique pour ouvrir l'interface Gitweb dans un nouvel onglet du navigateur.
Commit - La valeur SHA-1 pour le commit HEAD.
Author - L'auteur du commit HEAD.
Date - La date du commit HEAD.
Message de commit - Le message de commit pour le commit HEAD.
URL distant - L'URL du référentiel distant du dépôt.
Clone URL - L'URL à utiliser pour cloner le référentiel vers un autre emplacement (par exemple, votre ordinateur local, un autre compte cPanel ou un compte GitHub). Cliquez sur Copier pour copier cette URL dans votre presse-papiers.
