Un déploiement transforme un commit de votre dépôt en une application en cours d’exécution sur votre serveur. Chaque déploiement suit un pipeline en 8 étapes, suivi en temps réel.
Les étapes d’un déploiement
| # | Étape | Description |
|---|---|---|
| 1 | clone | Clonage du dépôt à la branche et au commit ciblés |
| 2 | dockerfile | Génération de la configuration Docker (Dockerfile + .env.production) |
| 3 | upload | Upload des fichiers sur le serveur via SSH |
| 4 | proxy | Configuration du proxy inverse (Traefik/Caddy) si un domaine est défini |
| 5 | build | Build des images Docker (variables VITE_*, NEXT_PUBLIC_*, REACT_APP_* injectées) |
| 6 | deploy | Démarrage des conteneurs (docker compose up) |
| 7 | healthcheck | Vérification de l’état de santé (jusqu’à 60 secondes) |
| 8 | done | Déploiement terminé avec succès |
Capture à venir
fr/projects-deployments
Cette capture illustrera la vue correspondante. Elle est générée automatiquement par le pipeline Playwright.
Entre le déploiement et le healthcheck, Paylood exécute les migrations et les seeds pour les stacks Laravel et Node.js (sur le conteneur backend).
Lancer un déploiement
- Manuel : ouvrez le projet puis cliquez sur Deploy en haut à droite.
- Automatique : chaque push sur la branche de l’environnement (voir Auto-déploiement).
- Sans cache : l’option
noCacheforce un build complet sans utiliser le cache Docker.
Suivre un déploiement
L’onglet Logs affiche l’historique paginé. Pendant un déploiement actif :
- Le bouton Live diffuse les logs en continu.
- Une notification navigateur est envoyée à la fin (succès ou échec).
- Le statut passe par :
queued → running → building → success | failed | cancelled.
Annuler un déploiement
- Ouvrez le déploiement en cours.
- Cliquez sur Annuler le déploiement (Cancel deployment).
- Le pipeline est interrompu proprement : les processus SSH en cours sont arrêtés.
Attention
L’annulation stoppe le déploiement en cours mais ne retire pas les images déjà construites. Un déploiement ultérieur réutilisera le cache.
Revenir en arrière (rollback)
En cas de problème après un déploiement réussi :
- Rendez-vous dans l’onglet Logs.
- Choisissez le déploiement précédent.
- Utilisez l’action de restauration : Paylood réutilise l’image Docker de la version précédente (
previousImageTag) et redémarre les conteneurs.
Astuce
Le rollback ne refait pas un build : il relance docker compose up avec l’image précédente. C’est quasi instantané.
En cas d’échec
- Consultez les dernières lignes de logs de l’étape en échec (bouton logs).
- Paylood analyse automatiquement les logs et propose un diagnostic (dépendance manquante, port déjà occupé, migration échouée\u2026).
- Corrigez le problème dans le dépôt et redéployez, ou appliquez la suggestion affichée.
Variables d’environnement au build
Les variables préfixées sont injectées au moment du build de l’image :
VITE_* (Vite / frontend)
NEXT_PUBLIC_* (Next.js)
REACT_APP_* (Create React App)
NUXT_* (Nuxt)Le port de l’application est détecté via les variables PORT, APP_PORT ou SERVER_PORT (défaut 3000).