Automatisierungen

Eine Automatisierung beginnt ohne menschliches Zutun zu arbeiten – sie läuft nach einem Zeitplan oder bei bestimmten Ereignissen: das Öffnen eines pull request, das Erstellen eines Issues, ein fehlgeschlagener Check oder eine fehlgeschlagene Bereitstellung.

Jede Automatisierung wird im System unter „Automatisierungen“ aufgelistet – inklusive des Auslösers und der ausgeführten Aktionen. Erstellen Sie eine neue Automatisierung unter „Neue Aufgaben“: wählen Sie „Automatisierung“ aus und legen Sie anschließend den Auslöser fest.

Zwei Arten von Auslösern#

Verwenden Sie einen Zeitplan, wenn der Auslöser tatsächlich zeitbasiert ist oder wenn die zu überwachende Komponente in einem anderen System ohne Coroid-Ereignisse operiert – beispielsweise Sentry oder Jira. Der Zeitplan fragt dieses System über Ihre MCP-Server ab und startet anschließend die entsprechenden Aktionen. MCP-Server und erzeugt daraus Arbeitsaufträge. Siehe Zeitpläne.

Verwenden Sie ein Ereignis, wenn Coroid zum Zeitpunkt des Geschehens informiert werden kann. Dadurch wird unnötige Arbeit vermieden, die bei einem kontinuierlichen Zeitplan entsteht.

Ereignisse, die Sie unter „Neue Aufgaben“ auswählen können#

Von GitHub – dazu ist die GitHub App erforderlich. GitHub App:

• Ein pull request wird geöffnet, aktualisiert oder zusammengeführt.
• Ein Issue wird geöffnet.
• Ein Kommentar erwähnt Coroid – dies gilt nur, wenn der Autor Schreibrechte für das Repository besitzt.

Von Coroid:

• Ein Task, ein Plan, eine Qualitätskontrolle, eine fehlgeschlagene Bereitstellung oder ein fehlgeschlagener Bereitstellungs-Check.
• Eine Release wird zurückgesetzt.

Nachrichten aus Slack und Telegram, neue Jira-Issues sowie Ereignisse aus eigenen Systemen erfordern einen Filter oder ein Service-Konto. Starten Sie diese über eine Vorlage in den Einstellungen unter „Automatisierung“ oder passen Sie das Ereignis einer Automatisierung im Editor an. Siehe Hooks.

Was die Automatisierung tut#

Sobald das zugehörige Ereignis eintritt, führt die Automatisierung eine von drei Aktionen aus:

• Rezenieren Sie den pull request. Coroid Check rezensiert ihn und veröffentlicht seine Bewertung auf GitHub – inklusive Kommentaren zu den betroffenen Zeilen und einem Check-Run namens Coroid Review. Dies gilt für geöffnete oder aktualisierte Pull Requests.
• Wandeln Sie das Ereignis in Arbeit um. Das Ereignis wird als Anfrage registriert. Nach erfolgreicher Qualifikation erstellt Coroid den entsprechenden Task oder Plan. Dies gilt für Issues sowie Kommentare, die Coroid erwähnen.
• Befolgen Sie die vorgegebene Anweisung. Ein Agent folgt den von Ihnen verfassten Anweisungen mit lesendem Zugriff und kann Tasks erstellen. Dies gilt für jedes Ereignis.

Keine dieser Aktionen ändert Ihren Code direkt. Die durch eine Automatisierung erzeugte Arbeit durchläuft denselben Prozess aus Spezifikation, Planung, Erstellung, Verifizierung und Rezension wie jede andere Aufgabe – und endet schließlich in einem von Ihnen genehmigten pull request.

Rezenieren Sie jeden pull request#

Um zu erreichen, dass Coroid auch von Nutzern geöffnete Pull Requests rezensiert – nicht nur die eigenen:

1. Öffnen Sie „Neue Aufgaben“ und wählen Sie „Automatisierung“ aus.
2. Wählen Sie das Projekt aus – oder lassen Sie das Feld leer, um alle Projekte einzubeziehen.
3. Unter „Auslöser“ wählen Sie „Etwas geschieht“. Unter „Ereignis“ selektieren Sie „Pull request geöffnet“ und anschließend „Rezenieren Sie den pull request“.
4. Geben Sie der Automatisierung einen Titel und eine kurze Beschreibung – danach können Sie fortfahren.

Die Automatisierung rezensiert jeden neuen pull request sowie jede Aktualisierung davon in dem ausgewählten Projekt. Das Repository muss die GitHub App nutzen, und das Projekt darf nicht auf „Lokal“ eingestellt sein. Pull Requests aus eigenen Tasks von Coroid werden nicht erneut rezensiert – ihre Rezension ist bereits Teil des Tasks.

Sie können außerdem die Prüfung von Pull Requests für das Projekt in der Qualitätskontrolle aktivieren. Dadurch werden die Checks für jeden pull request ausgeführt – und Coroid Check rezensiert ihn im Rahmen desselben Prozesses.

Die Überwachung einer Automatisierung#

Öffnen Sie eine Automatisierung im System, um jeden Ausführungsvorgang zu sehen: wann er stattfand, welche Kosten entstanden, welche Arbeitsaufträge erzeugt wurden und warum ein Vorgang nicht abgeschlossen wurde. Von dort aus können Besitzer und Administratoren die Automatisierung pausieren, testen, bearbeiten oder löschen. Alle Mitarbeiter im Unternehmen können Automatisierungen sowie ihre Ausführungsergebnisse einsehen.

Die Nutzung von Automatisierungen optimieren#

Die durch eine Automatisierung erzeugte Arbeit konkurriert um dieselben Agenten-Slots wie jede andere Aufgabe. Eine häufig ausgelöste Automatisierung kann unbemerkt Ihre Kapazitäten erschöpfen.

1. Weisen Sie ihr eine niedrigere Priorität als der von Menschen angeforderten Arbeit zu. P2 oder P3.
2. Machen Sie den Auslöser spezifischer. „Ein Check ist fehlgeschlagen“ wird in einem aktiven Repository ständig ausgelöst. „Dieser Check ist auf der Basis-Branch fehlgeschlagen“ triggert nur dann, wenn tatsächlich ein Problem vorliegt.
3. Prüfen Sie das Ergebnis. Wenn eine Automatisierung zwanzig Tasks erzeugt hat und Sie nur zwei davon zusammengeführt haben, produziert sie lediglich unnötigen Aufwand und Kosten – aber keinen echten Nutzen.

Der wahre Maßstab für eine Automatisierung ist, wie viel der von ihr erzeugten Arbeit tatsächlich zusammengeführt wird – nicht, wie oft sie ausgelöst wird.

Sentinel#

Frühere Versionen dieser Dokumentation beschrieben Sentinel – einen Monitor, der bestimmte Bedingungen überwacht. Dies ist keine eigenständige Funktion. Eine Bedingung ist entweder ein Ereignis, das eine Automatisierung auslösen kann, oder etwas, das ein Zeitplan prüft.

Verwandte Themen#

• Zeitpläne
• Hooks
• So gehen Sie vor, um mit der Arbeit zu beginnen
• Die Software-Fabrik