L’auto-déploiement déclenche un nouveau déploiement à chaque push sur une branche cible. Il repose sur un webhook installé sur votre dépôt Git.
Comment ça marche
- À la création du projet, Paylood installe un webhook sur votre dépôt (GitHub, GitLab ou Bitbucket).
- À chaque
git pushsur la branche du projet, le fournisseur appelle le webhook Paylood. - Paylood vérifie la signature du webhook, crée un déploiement
queuedet lance le pipeline. - Le statut du déploiement est suivi en temps réel dans l’application.
Activer l’auto-déploiement
- Ouvrez votre projet.
- Dans l’onglet Settings, activez le bouton Auto-deploy.
- (Optionnel) sélectionnez la branche qui doit déclencher les déploiements.
Capture à venir
fr/git-providers-auto-deploy
Cette capture illustrera la vue correspondante. Elle est générée automatiquement par le pipeline Playwright.
Astuce
L’auto-déploiement est activé par défaut pour la branche du projet. Vous pouvez le désactiver à tout moment pour un contrôle manuel total.
Filtrage par branche
Chaque environnement d’un projet est lié à une branche. Le webhook ne déclenche un déploiement que lorsque le push concerne la branche de l’environnement. Les autres branches sont ignorées.
Vérifier que le webhook est installé
Sur votre fournisseur Git, ouvrez les réglages du dépôt → Webhooks. Vous devriez voir une entrée créée par Paylood pointant vers https://<votre-domaine-api>/webhooks/<fournisseur>.
Attention
Le webhook doit pouvoir atteindre votre API Paylood depuis Internet (API_BASE_URL public). Il n’est pas installé pour les dépôts locaux (ZIP) ou les URL en localhost.
Sécurité des webhooks
Chaque fournisseur utilise son propre mécanisme de signature :
| Fournisseur | En-tête de vérification |
|---|---|
| GitHub | x-hub-signature-256 (HMAC-SHA256) |
| GitLab | x-gitlab-token |
| Bitbucket | x-hub-signature (HMAC) |
Un webhook dont la signature est invalide reçoit une erreur 401 et le déploiement n’est pas créé.
Résoudre un auto-déploiement qui ne se déclenche pas
- Vérifiez que l’auto-deploy est activé dans les paramètres du projet.
- Vérifiez que le webhook existe toujours sur le dépôt (il peut être supprimé lors d’un transfert de dépôt).
- Vérifiez que la branche du push correspond à celle de l’environnement.
- Consultez la section Webhooks des fournisseurs pour les derniers envois et leurs statuts HTTP.
Après un transfert ou un fork d’un dépôt, ré-installez le webhook en éditant puis enregistrant la configuration du projet.