Déployer un site avec Git dans Plesk et dépanner les erreurs courantes

Objectif

Ce guide explique comment relier un dépôt Git distant à un domaine Plesk, choisir entre déploiement automatique, manuel ou absence de publication, puis vérifier le résultat. Il propose aussi une méthode de dépannage fondée sur les journaux et la séparation des causes : dépôt, authentification, branche, chemin cible, application ou serveur.

Pour un projet applicatif, reliez cette procédure à un serveur VPS et au guide pour déployer une application depuis Git.

Selon la documentation officielle, le support Git dans Plesk nécessite l’extension Git et une permission de gestion Git accordée au domaine par le plan de services.[1] Ces prérequis ne sont pas inclus dans tous les forfaits NovaHoster : confirmez leur disponibilité et vos droits dans l’Espace client ou auprès du support.

Prérequis

Préparez un dépôt Git distant accessible, l’URL HTTPS ou SSH, une branche destinée à l’environnement visé et un répertoire de publication existant. Le dépôt doit contenir le code attendu par votre serveur ; un dépôt clonable n’est pas automatiquement une application prête à exécuter.

Pour un dépôt privé, prévoyez le mécanisme accepté par votre environnement. Plesk pour Linux peut utiliser des identifiants HTTPS ou une clé SSH générée par Plesk ; la documentation indique que Plesk pour Windows ne prend pas en charge l’authentification HTTP/HTTPS pour un dépôt privé et recommande une clé SSH dans ce cas.[2]

Avant d’activer l’automatisation, testez le déploiement manuellement sur une branche ou un environnement de préproduction. Les commandes additionnelles de déploiement exécutent des commandes shell : n’ajoutez que des commandes comprises, nécessaires et compatibles avec les droits du compte système.

Procédure

1. Vérifiez l’éligibilité Git. Dans Plesk, ouvrez Websites & Domains et recherchez le lien Git. S’il n’existe pas, l’extension peut être absente, la permission Git peut ne pas être accordée ou la fonction peut ne pas faire partie de votre offre. Confirmez avant de modifier la configuration.

1. Ajoutez un dépôt. Cliquez sur Git, puis Add Repository. Choisissez Remote git hosting like GitHub or BitBucket et renseignez l’URL du dépôt distant en HTTPS ou SSH.[2]

1. Configurez l’accès privé. Pour HTTPS sous Linux, utilisez les identifiants prévus par Plesk si votre fournisseur l’autorise. Pour SSH, copiez la clé publique affichée par Plesk dans les réglages du dépôt ou du compte Git distant, puis vérifiez que l’URL SSH correspond au dépôt voulu. Ne placez jamais une clé privée dans le dépôt.

1. Choisissez la branche et le chemin. Définissez la branche active destinée au déploiement. Plesk indique qu’une seule branche est active à la fois et que la branche par défaut peut être master selon la configuration ; sélectionnez explicitement la branche réellement utilisée par votre projet.[2] Le chemin de publication est généralement /httpdocs, mais vous pouvez sélectionner un autre répertoire existant si votre organisation le prévoit.

1. Sélectionnez le mode de déploiement. Le mode automatique publie les changements après leur récupération ; le mode manuel exige une action Deploy ; le mode No deployment conserve le dépôt sans publier ses fichiers.[2] Pour une première mise en service, le mode manuel réduit le risque de publier un commit non validé.

1. Lancez le clonage et contrôlez le résultat. Cliquez sur OK, attendez la fin du clonage, puis vérifiez que le dépôt apparaît dans Websites & Domains > Git. Contrôlez le nom du dépôt, la branche active et le chemin de publication.

1. Récupérez les changements. Après un commit et un push sur le dépôt distant, utilisez Pull Updates. En mode manuel, lancez ensuite Deploy from Repository ou Deploy à côté du dépôt. En mode automatique, vérifiez la date du dernier commit puis ouvrez l’URL publique.

1. Configurez un webhook avec précaution. Dans Repository Settings, Plesk peut afficher une URL de webhook. Copiez-la dans le fournisseur Git et déclenchez-la sur l’événement de push. La documentation signale qu’un certificat auto-signé peut empêcher le webhook de fonctionner via HTTPS à cause de la négociation SSL/TLS ; ne désactivez pas la sécurité sans validation de NovaHoster et préférez corriger le certificat.[2]

1. Ajoutez les actions post-déploiement seulement si nécessaire. Dans Repository Settings, activez les actions additionnelles et saisissez une commande par ligne. Elles peuvent servir à une migration ou à une étape de construction, mais elles sont soumises aux droits du compte système et à l’environnement d’exécution. Sous Linux, un compte sans accès SSH peut être placé dans un environnement chrooté ; les chemins et exécutables disponibles peuvent alors différer de ceux d’un shell administrateur.[2]

1. Vérifiez les journaux Git et le site. Consultez Commit Logs pour confirmer le commit, puis le journal d’erreurs du domaine via Websites & Domains > domaine > File Manager > Logs > error_log.[3] Testez une page statique, la page d’accueil, les formulaires et les connexions à la base de données.

Cas d’erreur et diagnostic

Diagnostic guidé des erreurs de déploiement

Commencez par distinguer récupération et publication. Si le commit n’apparaît pas dans Commit Logs, le problème se situe probablement entre le dépôt distant, l’authentification, le webhook et le Pull Updates. Si le commit apparaît mais que le site ne change pas, inspectez la branche et le chemin cible. Si les fichiers sont présents mais que l’application échoue, passez au journal d’erreurs du domaine et à la compatibilité de l’environnement.

Pour un problème serveur plus large, un administrateur Plesk peut utiliser Tools & Settings > Log Browser lorsque l’extension est installée et accessible. Plesk précise que Log Browser facilite la recherche dans les journaux mais ne corrige pas automatiquement les incidents.[4] Une personne non à l’aise avec une intervention serveur doit transmettre les éléments au support plutôt que lancer des commandes non maîtrisées.

Sur un serveur Linux où vous disposez réellement des droits administrateur, l’utilitaire Plesk Repair peut fonctionner en mode diagnostic avec -n ou en mode réparation avec -y. La documentation distingue plusieurs aspects, dont web, dns, ftp, db, fs et installation.[5] N’exécutez pas ces commandes si votre accès ou votre forfait ne l’autorise pas ; demandez à NovaHoster de réaliser l’analyse.

Quand contacter l’Espace client

Contactez NovaHoster si Git n’apparaît pas, si l’extension ou la permission semble manquante, si l’accès SSH ou les commandes post-déploiement sont nécessaires, si un webhook échoue malgré une configuration correcte, ou si l’application renvoie une erreur après publication. Fournissez le domaine, le nom du dépôt sans secret, la branche, l’heure du test, le message exact, l’identifiant du commit et les extraits pertinents des journaux en masquant les mots de passe, tokens et clés.

Maillage interne suggéré

• Guide 1 — Se connecter à Plesk et retrouver les principaux réglages d’un site
• Guide 2 — Administrer un abonnement Plesk sans interrompre son site
• Configurer un dépôt GitHub privé avec une clé SSH
• Lire le journal d’erreurs d’un site dans Plesk
• Préparer un déploiement applicatif avec variables d’environnement sécurisées
• Checklist de mise en production NovaHoster

Sources techniques

[1] Plesk — Git Support [2] Plesk — Using remote Git hosting [3] Plesk — Viewing Website Error Log [4] Plesk — Monitoring System and Mail Server Logs [5] Plesk — Plesk Repair Utility

Références générales

Les guides s’appuient exclusivement sur la documentation officielle Plesk Obsidian consultée pour les parcours d’interface, les prérequis Git, les modes de déploiement, les journaux et l’utilitaire de réparation. Les modalités commerciales, les permissions réellement activées et les limites propres à l’hébergement NovaHoster doivent être confirmées dans l’Espace client ou auprès du support.

[1]: https://docs.plesk.com/en-US/obsidian/administrator-guide/website-management.70741/ "Plesk — Website Management" [2]: https://docs.plesk.com/en-US/obsidian/administrator-guide/customers-and-resellers/hosting-plans-and-subscriptions/managing-subscriptions.65125/ "Plesk — Managing Subscriptions" [3]: https://docs.plesk.com/en-US/obsidian/customer-guide/websites-and-domains/viewing-website-error-log.73938/ "Plesk — Viewing Website Error Log" [4]: https://docs.plesk.com/en-US/obsidian/administrator-guide/server-administration/monitoring-system-and-mail-server-logs.80012/ "Plesk — Monitoring System and Mail Server Logs" [5]: https://docs.plesk.com/en-US/obsidian/administrator-guide/plesk-administration/plesk-repair-utility.74649/ "Plesk — Plesk Repair Utility" [6]: https://docs.plesk.com/en-US/obsidian/customer-guide/git-support.75824/ "Plesk — Git Support" [7]: https://docs.plesk.com/en-US/obsidian/customer-guide/git-support/using-remote-git-hosting.75848/ "Plesk — Using remote Git hosting" [8]: https://docs.plesk.com/en-US/obsidian/administrator-guide/website-management/websites-and-domains/website-content/deploying-content-using-git.75877/ "Plesk — Deploying Content Using Git"