Dernière mise à jour :
Bot : GitHub
Publier commits, pull requests, issues, CI et alertes de sécurité d'un dépôt dans un salon.
Le module « GitHub » du bot publie dans un salon l'activité d'un dépôt : commits, pull requests, issues, résultats de CI, releases et alertes de sécurité. Tu peux brancher plusieurs dépôts, chacun vers son salon, avec ses filtres.
Brancher un dépôt#
- Paramètres du serveur, Bot : active le module GitHub (permission « Gérer le bot ») et crée un hook en choisissant le salon de destination.
- Copie l'URL du hook et son secret : le secret n'est affiché qu'une seule fois (tu peux le régénérer).
- Dans GitHub, Settings, Webhooks, Add webhook : colle l'URL, choisis le type de contenu « application/json », colle le secret et sélectionne les événements voulus.
- Utilise le bouton de test du hook pour vérifier qu'un message arrive.
Événements pris en charge#
| Événement | Identifiant |
|---|---|
| ⬆️ Commits (push) | push |
| 🔀 Pull requests | pull_request |
| 👀 Relectures de PR | pull_request_review |
| 🐞 Issues | issues |
| 💬 Commentaires | issue_comment |
| 🚀 Releases | release |
| ⚙️ CI (workflows) | workflow_run |
| ✔️ CI (checks) | check_run |
| 📦 Déploiements | deployment_status |
| 🌱 Branches / tags créés | create |
| 🗑️ Branches / tags supprimés | delete |
| ⭐ Étoiles | star |
| 🍴 Forks | fork |
| 🛡️ Avis de sécurité | security_advisory |
| 📦 Alertes Dependabot | dependabot_alert |
| 🔎 Alertes de code scanning | code_scanning_alert |
Filtres et réglages#
- Dépôts (jusqu'à 20), branches (jusqu'à 20) et acteurs ignorés (jusqu'à 30), avec jokers « * » ; vide = tout.
- Choix des événements publiés, ignorer les bots, filtrer les statuts de CI (échec, succès, annulé, autre).
- Rôle mentionné en cas d'échec de CI ou d'alerte de sécurité.
- Les commits d'un push sont regroupés (jusqu'à 10 détaillés).
- Style du message : celui du module, texte seul ou embed. Plafond de messages par minute et pause temporaire du hook.
- Pour chaque hook, le tableau de bord indique la dernière livraison, le nombre de messages publiés et de requêtes rejetées.
Les textes venant de GitHub (titres, messages de commit) sont toujours affichés comme du texte, mentions neutralisées. Voir aussi : Bot Pexxoo, Webhooks entrants.