Une automatisation commence à travailler sans qu'on le lui demande à chaque fois. Elle s'exécute selon un calendrier ou lorsqu'un événement se produit : l'ouverture d'un pull request, la création d'un ticket, ou l'échec d'une vérification ou d'une déploiement.
Chaque automatisation est répertoriée dans l'usine sous l'onglet Automatisations, avec les conditions de déclenchement et les actions qu'elle effectue. Créez-en une dans Nouveau travail : sélectionnez Automatisation, puis choisissez quand elle doit s'exécuter.
- PlanificationHeure
- Automatisation d'événementsUn événement se produit.
Une tâche ordinaire
Spécification, plan, développement, vérification, revue. Utilise un emplacement d'agent ; attribuez-lui une priorité plus faible.
P2P3Un pull request
Il ne peut pas fusionner lui-même ni valider dans votre branche de base.
Vous approuvez
Deux types de déclencheurs
| Déclencheur | Exécutions | Exemple |
|---|---|---|
| Un calendrier | À une heure précise, à intervalles réguliers ou une fois immédiatement. | Demandez à Sentry de vous signaler les nouvelles erreurs toutes les heures et créez un ticket pour chacune d'entre elles. |
| Quelque chose se produit | Lorsque GitHub ou Coroid envoie l'événement. | Réviser chaque pull request ouvert sur un projet. |
Utilisez un calendrier lorsque le déclencheur dépend réellement du temps, ou lorsque l'élément à surveiller se trouve dans un autre système qui ne génère pas d'événements Coroid, comme Sentry ou Jira. Le calendrier interroge ce système via vos MCP servers et lance des tâches en conséquence. Voir MCP servers et ouvre des tâches pour ce qu'il trouve. Voir Calendriers.
Utilisez un événement lorsque Coroid peut être informé au moment où il se produit. Cela évite les exécutions inutiles par rapport à un calendrier qui interroge constamment le système.
Événements que vous pouvez choisir dans Nouveau travail
Depuis GitHub, qui nécessite l' GitHub App:
- un pull request est ouvert, mis à jour ou fusionné.
- Un ticket est ouvert.
- Un commentaire mentionne Coroid ; cela ne compte que si son auteur dispose des droits d'écriture sur le dépôt.
Depuis Coroid :
- Une tâche, un plan, une vérification Qualité, un déploiement ou une vérification de l'état du déploiement échoue.
- Une version est annulée.
Les messages Slack et Telegram, les nouveaux tickets Jira et les événements générés par vos propres systèmes nécessitent un filtre ou un compte de service. Démarrez-les à partir d'un modèle dans Paramètres, sous l'onglet Automatisation, ou modifiez l'événement d'une automatisation dans son éditeur. Voir Hooks.
Ce qu'elle fait
Lorsque son événement se déclenche, une automatisation effectue l'une des trois actions suivantes :
- Réviser le pull request. Coroid Check le révise et publie sa révision sur GitHub, avec des commentaires sur les lignes concernées et une vérification nommée Coroid Review. Cette fonctionnalité est proposée pour les pull requests ouverts ou mis à jour.
- Le transformer en tâche. L'événement est enregistré comme demande. Une fois la Qualification validée, Coroid crée la tâche ou le plan. Cette fonctionnalité est proposée pour les tickets et les commentaires mentionnant Coroid.
- Suivre les instructions. Un agent suit les instructions que vous avez rédigées, avec un accès en lecture seule, et peut ouvrir des tâches. Cette fonctionnalité est proposée pour tous les événements.
Aucune d'entre elles ne modifie directement votre code. Les tâches ouvertes par une automatisation suivent le même processus de spécification, planification, construction, vérification et révision que tout autre travail, et aboutissent à un pull request que vous approuvez.
Réviser chaque pull request
Pour que Coroid révise les pull requests ouverts par les utilisateurs, et non seulement ceux générés par lui-même :
- Ouvrez Nouveau travail et sélectionnez Automatisation.
- Choisissez le projet, ou laissez-le vide pour couvrir tous les projets.
- Sous l'onglet Déclencheur, choisissez Lorsque quelque chose se produit. Sous Événement, sélectionnez Pull request ouverte, puis choisissez Réviser le pull request.
- Donnez-lui un titre et un court résumé, puis continuez.
L'automatisation révise chaque nouveau pull request, ainsi que chaque mise à jour de celui-ci, sur ce projet. Le dépôt doit disposer de l'GitHub App, et le projet ne doit pas être configuré en mode Local uniquement. Les pull requests issues des tâches de Coroid ne sont pas révisées à nouveau : leur révision fait partie intégrante de la tâche.
Vous pouvez également activer les Pull requests pour le projet dans Contrôle qualité. Les vérifications du projet seront alors exécutées sur chaque pull request et Coroid Check le révisera dans le cadre de la même exécution.
Surveiller une automatisation
Ouvrez une automatisation dans l'usine pour consulter chaque exécution : date d'exécution, coût, tâches ouvertes et raisons d'un échec d'exécution. À partir de là, les propriétaires et administrateurs peuvent la mettre en pause, la tester, la modifier ou la supprimer. Tous les membres de l'organisation peuvent voir les automatisations et leurs exécutions.
Maintenir l'utilité des automatisations
Les tâches ouvertes par une automatisation entrent en concurrence avec toutes les autres pour occuper les mêmes slots d'agents. Une automatisation qui se déclenche fréquemment peut silencieusement épuiser votre capacité.
- Attribuez-lui une priorité inférieure à celle des tâches demandées par les utilisateurs.
P2ouP3. - Rendez le déclencheur plus spécifique. « Une vérification a échoué » se déclenche constamment sur un dépôt très actif. « Cette vérification a échoué sur la branche de base » ne se déclenche que lorsqu'un problème réel existe.
- Observez ce qu'elle a produit. Si une automatisation a ouvert vingt tâches et que vous n'en avez fusioné que deux, elle génère du bruit et des coûts, mais pas de valeur.
La véritable mesure d'une automatisation réside dans la proportion de tâches qu'elle ouvre et qui sont fusionnées, et non dans la fréquence à laquelle elle se déclenche.
Sentinel
Les versions antérieures de ces documents décrivaient Sentinel, un moniteur qui détecte une condition. Il ne s'agit pas d'une fonctionnalité distincte. Une condition correspond soit à un événement sur lequel une automatisation peut s'exécuter, soit à quelque chose qu'un calendrier vérifie.