Site ou application : où commence ce guide
Pour un site fait de fichiers prêts à servir, le déploiement par Git se résume à une copie. Le guide pour relier un dépôt à Plesk et dépanner ses erreurs couvre cette partie : clé ou jeton, branche, dossier cible, mode, webhook. La suite suppose ce raccordement fait.
Une application demande davantage : le dépôt ne contient ni les dépendances (vendor, node_modules), ni parfois le code compilé (dist), ni le schéma de base à jour. D’où quatre temps :
- Copie des fichiers du commit par Plesk.
- Préparation : dépendances, construction.
- Base de données : migrations du commit.
- Relance : caches, processus, contrôle.
La configuration (.env, variables du panneau Node.js, APP_KEY) a son propre guide : configurer les environnements d’une application Laravel ou Node.js.
Quelle offre pour quelle application
Le déploiement par Git est ouvert sur toutes nos offres d’hébergement, START compris. Ce qui change, c’est ce qui peut tourner après la copie.
| Votre application | Où elle a sa place | Ce qui décide |
|---|---|---|
| PHP ou Laravel, dépendances incluses dans ce qui est déployé | Tous les packs, START et WP START compris | Rien à lancer : tout est construit avant de pousser |
| Laravel avec Composer et migrations lancés à chaque déploiement | Les offres où l’accès SSH s’ouvre sur demande : BUSINESS et ULTIMATE, WP BUSINESS et WP ULTIMATE, les trois packs e-commerce, les trois formules revendeur | Ce que contient l’environnement des commandes |
| Node.js : Express, Next.js, Nuxt, une API | BUSINESS et ULTIMATE, WP BUSINESS et WP ULTIMATE, e-commerce BUSINESS et ULTIMATE, revendeur AGENCY et HOSTER | Un processus permanent, avec sa propre mémoire |
| Docker, service système, outil que nous ne proposons pas | Un serveur VPS ou un serveur dédié | L’accès root, absent du mutualisé |
Les droits cités ici sont ceux des tableaux des packs d’hébergement et des formules revendeur, qui font foi.
Sans accès SSH, Plesk exécute les commandes d’après déploiement dans un environnement isolé dont la racine est le dossier de l’abonnement, et d’où aucun programme extérieur ne se lance [1]. N’y comptez pas sur Composer ou npm sans l’avoir fait vérifier par le support.
Toutes les versions de PHP sont disponibles sur nos packs, de la plus ancienne à la plus récente. Choisissez dans les paramètres PHP du domaine celle qu’exige votre composer.json : Laravel 13 demande au moins PHP 8.3 [5]. En ligne de commande, php -v dit quelle version répond vraiment.
Construire avant de pousser, ou sur l’hébergement
Avant d’écrire la moindre commande, décidez où se fabrique ce qui part en ligne.
Sur l’hébergement, à chaque déploiement
Le dépôt ne contient que les sources ; une commande installe les dépendances après la copie. Avec un composer.lock, composer install pose exactement les versions qu’il fige ; --no-dev écarte les paquets de développement, et --optimize-autoloader, recommandé en production, accélère le chargement des classes [8]. Encore faut-il que Composer soit joignable là où tournent les commandes.
Sur votre poste ou dans votre intégration continue
Vous construisez ailleurs et poussez le résultat sur une branche réservée à la mise en ligne, production par exemple, que Plesk est seul à déployer ; elle porte en plus le dossier vendor ou le dossier construit. C’est la voie d’un front Vite, React ou Next.js, dont la construction réclame des outils de développement que npm n’installe pas quand NODE_ENV vaut production, et la seule sur une offre sans accès SSH.
Dans les deux cas, versionnez les fichiers de verrouillage, composer.lock et package-lock.json. Côté Node.js, préférez npm ci : il exige le fichier de verrouillage, échoue au lieu de le modifier s’il ne correspond plus au package.json, et repart d’un node_modules vide [9]. L’option --omit=dev écarte les dépendances de développement [10].
Placer l’application dans l’abonnement
Plesk recopie le dépôt tel qu’il est rangé ; c’est la racine du document du domaine qui désigne la partie publique.
| Laravel | Node.js | |
|---|---|---|
| Dossier cible du dépôt | /httpdocs, la valeur par défaut | Un dossier de l’abonnement, /httpdocs par exemple |
| Ce que sert le serveur web | Le dossier public : racine du document réglée sur /httpdocs/public [5] | La « Racine du document » du domaine [2], à régler sur un sous-dossier comme /httpdocs/public pour que ni le script de déploiement ni son journal ne soient servis |
| Point d’entrée | public/index.php | Le « Fichier de démarrage d’application », app.js par défaut, dans la « Root d’application » [2] |
| Écrit par l’application en ligne | storage et bootstrap/cache, qui doivent rester inscriptibles [5] | Ce que votre code enregistre : téléversements, journaux |
Ce que l’application crée en ligne (téléversements, journaux, caches) ne doit jamais exister aussi dans le dépôt : un déploiement le remplacerait par la version du commit. Écartez-le par le .gitignore, et rangez le script de déploiement dans un dossier non servi, deploiement/ par exemple.
Le script d’après déploiement
Dans les paramètres du dépôt, la case « Activer des actions de déploiement supplémentaires » accepte une commande par ligne, relancée à chaque déploiement [1]. Mieux vaut y appeler un seul script versionné avec le code : il se relit en revue, suit l’historique, et le champ de Plesk garde une ligne qui ne change jamais.
Pour Laravel
#!/bin/sh
# deploiement/apres.sh : lancé par Plesk après chaque copie du dépôt
set -e
cd "$(dirname "$0")/.."
exec >> storage/logs/deploiement.log 2>&1
echo "--- $(date '+%Y-%m-%d %H:%M')"
php artisan down --render="errors::503"
composer install --no-dev --optimize-autoloader --no-interaction
php artisan migrate --force
php artisan optimize
php artisan queue:restart # seulement si l'application a des files d'attente
php artisan upset -e arrête tout à la première commande en échec : une installation ratée ne débouche pas sur une migration. Le cd ramène à la racine du projet, d’où que Plesk lance le script, et exec garde une trace datée de chaque passage dans un fichier non servi. php artisan migrate --force évite la demande de confirmation que Laravel pose en production avant une opération qui peut détruire des données [6] ; php artisan optimize met en cache configuration, événements, routes et vues en une commande [5].Dans le champ de Plesk, une seule ligne appelle le script. Avec l’accès SSH ouvert, écrivez le chemin complet :
sh /var/www/vhosts/votre-domaine.tn/httpdocs/deploiement/apres.shDans l’environnement isolé (chroot), où la racine est le dossier de l’abonnement, la ligne s’écrirait sh ./httpdocs/deploiement/apres.sh, mais aucun programme extérieur n’y est joignable [1] : ni php ni Composer ne s’y lancent. Ce script Laravel suppose donc l’accès SSH.
Chaque commande doit pouvoir être rejouée sans dégât : migrate saute les migrations déjà passées, optimize reconstruit ses caches. Une réserve : si le nouveau code exige un paquet que vendor n’a pas encore, artisan down lui-même peut échouer. Le journal le dira ; c’est un argument de plus pour construire avant de pousser.
Pour Node.js
Plesk fait tourner l’application Node.js par Phusion Passenger [13]. Après une copie, deux gestes : installer les dépendances si package.json a changé, puis redémarrer. Le panneau Node.js du domaine offre « Installer NPM », visible dès qu’un package.json est dans la racine de l’application, et « Redémarrer l’app » [2]. En ligne de commande, toucher tmp/restart.txt suffit : Passenger relance l’application en voyant la date changer, à l’arrivée d’une requête et donc pas instantanément [11].
#!/bin/sh
# deploiement/apres.sh : version pour une application Node.js
set -e
cd "$(dirname "$0")/.."
exec >> deploiement.log 2>&1
echo "--- $(date '+%Y-%m-%d %H:%M')"
npm ci --omit=dev
mkdir -p tmp
touch tmp/restart.txtSi npm n’est pas joignable là où tournent les commandes, construisez hors de l’hébergement et passez par les boutons du panneau : « Installer NPM » puis « Redémarrer l’app » quand package.json a changé, « Redémarrer l’app » seul sinon.
Avec Laravel Toolkit, s’il figure sur votre domaine
Quand cette extension est installée, son onglet Déploiement a sa propre mécanique : mode manuel ou automatique, scénario dont on décoche les étapes inutiles, et script saisi par « Modifier le script », exécuté à chaque mise à jour ; le modifier suppose un accès SSH réglé sur autre chose que « Interdit » [3]. Choisissez l’un ou l’autre mécanisme : les deux à la fois lanceraient deux fois les migrations.
Les migrations : l’étape qu’un commit ne défait pas
Revenir à l’ancien code prend une minute ; revenir à l’ancienne base, non. Une colonne supprimée par une migration emporte ses données, et aucun retour du code ne les rend. Trois précautions :
- Sauvegarder juste avant une mise en ligne qui migre : Sites Web & Domaines > Gestionnaire de sauvegardes > Sauvegarder [4]. Cette sauvegarde est la vôtre, restaurée par vous depuis Plesk ; celles de nos serveurs servent à reprendre le service après un incident chez nous, pas à rendre votre base d’hier matin.
- Lire avant d’exécuter :
php artisan migrate --pretendaffiche les requêtes SQL sans les lancer [6]. À faire en préproduction, sur une copie de la base. - Ajouter d’abord, retirer ensuite : une colonne neuve et facultative ne gêne pas l’ancien code ; l’ancienne ne disparaît qu’à une mise en ligne suivante. Le code peut alors revenir en arrière sans toucher à la base.
php artisan migrate:rollback défait le dernier lot, --step=5 un nombre précis [6], si chaque méthode down() rétablit vraiment l’état d’avant. Aucune ne recrée des données supprimées : là, seule la sauvegarde sert.
Le mode maintenance couvre l’intervalle délicat. php artisan down renvoie une page 503 ; avec --render="errors::503", elle est préparée d’avance et servie avant que le framework démarre, ce que Laravel conseille pendant la mise à jour des dépendances ; php artisan up rouvre le site, et les tâches en file d’attente attendent entre les deux [7]. Le script ne commence qu’après la copie : la maintenance protège l’installation et la migration, pas la copie elle-même. S’il s’arrête sur une erreur, le site reste en maintenance plutôt qu’à moitié à jour, et le journal dit pourquoi.
Revenir à la version précédente
La documentation de l’extension Git ne décrit aucun moyen de redéployer un commit antérieur : elle déploie ce qu’elle récupère de la branche choisie [1]. Le retour arrière se fait donc dans Git, et redescend par le chemin habituel.
- Repérez le commit fautif dans « Logs de commit », sur la page Git de Plesk [1].
- Sur votre poste, annulez-le par un nouveau commit :
git revert <identifiant>enregistre un commit qui défait les changements visés, sans réécrire l’historique [12]. Pour un commit de fusion, indiquez le parent à conserver avec-m 1[12]. - Poussez. Avec le webhook et le mode automatique, la correction part seule ; en mode manuel, cliquez sur Déployer.
- Si le commit annulé apportait une migration, elle reste appliquée : défaites-la avec
migrate:rollbacksi sa méthodedown()le permet, sinon restaurez la sauvegarde prise avant la mise en ligne.
Préférez ce revert à un git reset suivi d’un envoi forcé : le code en ligne est le même, mais aucun commit ne disparaît de l’historique.
Marquez aussi chaque mise en production d’une étiquette (git tag v2026.10.31, puis git push --tags) : un repère de ce qui est en ligne, pour l’équipe comme pour le support.
Une préproduction sur un sous-domaine, reliée au même dépôt
Une erreur se voit mieux sur une copie qui tourne comme la vraie. Sur les packs START, BUSINESS et ULTIMATE, les sous-domaines sont illimités et ne comptent pas dans le nombre de sites. Une préproduction a besoin de sa propre base : START n’en compte qu’une, BUSINESS cinq, ULTIMATE un nombre illimité. Une organisation qui fonctionne avec l’extension Git :
preprod.votre-domaine.tn, avec son dépôt Plesk, sa base et son.env: branchepreprod, mode automatique ;- le domaine principal : branche
production, mode manuel ; - un webhook par dépôt Plesk, chacun ayant sa propre adresse [1] : un envoi sur
preprodne publie rien sur le domaine principal.
Mettre en production, c’est fusionner preprod dans production puis cliquer sur Déployer : part en ligne exactement ce qui vient d’être essayé. En Node.js, la préproduction est une application de plus, avec sa propre mémoire : vérifiez que les deux tiennent dans les ressources réservées du pack.
Après chaque mise en ligne : cinq contrôles
- Le commit affiché sur la page Git de Plesk est celui que vous avez poussé.
- Le journal du script (
storage/logs/deploiement.logdans l’exemple) se termine sur la dernière commande, sans erreur. - La route de santé : celle de Laravel,
/up, répond 200 quand l’application démarre sans exception et 500 sinon [5] ; pour Node.js, écrivez la vôtre. - Un parcours réel : connexion, formulaire, page qui lit la base.
- Les processus longs : un worker de file d’attente garde l’ancien code tant qu’il n’a pas redémarré ; Laravel demande de relancer tout service de longue durée après une nouvelle version [5].
Une erreur 500 après un déploiement sans erreur vient de l’application, pas de la copie : le guide pour lire les journaux d’une application en production prend le relais.
Ce que le support peut vérifier pour vous
Livechat et ticket, 7 jours sur 7, en français ou en tunisien. Écrivez-nous avant de bâtir le déploiement pour savoir ce que contient l’environnement des commandes sur votre offre, pour faire ouvrir l’accès SSH, ou si le bouton Node.js manque.
Joignez le domaine, la branche, le script (il ne contient aucun secret) et la fin de son journal. Le guide pour ouvrir une demande de support propose un modèle.
Questions fréquentes
Puis-je construire mon front Vite ou Next.js directement sur l’hébergement ?
Un déploiement peut-il écraser mon fichier .env ?
.env commité par erreur ou d’un envoi FTP par-dessus la version en ligne. S’il a été commité puis retiré du suivi, gardez-en une copie avant le déploiement suivant.Faut-il lancer les migrations automatiquement à chaque déploiement ?
migrate --force du script de production et lancez-la vous-même, juste après la sauvegarde de la base.Une application Node.js demande-t-elle un serveur VPS ?
Guides liés
Sources techniques
- Plesk Obsidian — Utiliser l’hébergement Git distant : modes de déploiement, webhook, actions de déploiement supplémentaires, environnement chrooté, logs de commit (en français)
- Plesk Obsidian — Prise en charge de Node.js : racine de l’application, fichier de démarrage, Installer NPM, Redémarrer l’app (en français)
- Plesk Obsidian — Laravel Toolkit : onglet Déploiement, script, condition d’accès SSH (en français)
- Plesk Obsidian — Créer des sauvegardes (en français)
- Documentation Laravel 13 — déploiement : PHP 8.3, dossier public, droits d’écriture, optimize, services longs, route /up
- Documentation Laravel 13 — migrations : --force, --pretend, migrate:rollback et --step
- Documentation Laravel 13 — configuration : mode maintenance, down --render, up, files d’attente
- Composer — interface en ligne de commande : install, composer.lock, --no-dev, --optimize-autoloader
- npm — npm ci
- npm — configuration : option omit
- Phusion Passenger — redémarrer une application, fichier tmp/restart.txt
- Git — git revert
- Plesk — Node.js dans Plesk : Phusion Passenger sert les applications Node.js (blog de l’éditeur, en anglais)
Les permissions et options visibles peuvent dépendre de votre formule ou de vos droits. Faites vérifier le contexte depuis l’Espace client.
Demander une vérification