Automatisieren mit GitHub

Dieser Artikel richtet sich an InfraNest-Nutzer, die möchten, dass ihre Infrastruktur-Automatisierungen auf Aktivitäten in ihren GitHub-Repositorys reagieren und automatisch Aktionen auf GitHub ausführen — ganz ohne Programmierung.

Übersicht

• Erstellen Sie Automatisierungen, die Ereignisse auf GitHub überwachen, etwa einen fehlgeschlagenen Workflow-Lauf oder eine neue Pull Request, und automatisch reagieren.
• Lösen Sie GitHub-Aktionen aus — wie das Erstellen eines Issues oder das Mergen einer Pull Request — von jeder Automatisierung in InfraNest aus.
• Alles wird visuell im Automatisierungs-Builder eingerichtet, mit GitHub-Triggern und -Aktionen.

NoteBevor Sie GitHub-Trigger oder -Aktionen verwenden können, müssen Sie Ihr GitHub-Konto verbinden. Wenn Sie zuerst einen GitHub-Trigger auswählen, erinnert InfraNest Sie daran, die Verbindung herzustellen.

GitHub verbinden

1. Gehen Sie zu Integrationen.
2. Suchen Sie GitHub und wählen Sie GitHub verbinden.
3. Wählen Sie Mit {provider} verbinden oder GitHub App installieren, und folgen Sie den Anweisungen, um den Zugriff zu autorisieren.
4. Nach der Verbindung erscheinen GitHub-Trigger und -Aktionen gruppiert unter GitHub im Automatisierungs-Builder.

Auf GitHub-Aktivitäten reagieren

1. Öffnen Sie Automatisierungen und wählen Sie Neue Automatisierung.
2. Wählen Sie unter Wenn die Option Bei Ereignis.
3. Wählen Sie einen GitHub-Trigger, zum Beispiel:
   • GitHub-Workflow-Lauf — gestartet, beendet, fehlgeschlagen oder erfolgreich
   • GitHub-Issue oder GitHub-Issue-Kommentar — geöffnet, geschlossen, mit Label versehen, zugewiesen oder kommentiert
   • GitHub-Push, GitHub-Branch/Tag erstellt oder GitHub-Branch/Tag gelöscht
   • GitHub-Pull-Request oder GitHub-PR-Review — geöffnet, gemergt, geschlossen, genehmigt oder Änderungen angefordert
   • GitHub-Release — veröffentlicht
   • GitHub-Deployment, GitHub-Deployment-Status, GitHub-Commit-Status, GitHub-Check-Run oder GitHub-Check-Suite
4. Nutzen Sie Bedingung hinzufügen, um Nur wenn-Filter zu ergänzen — zum Beispiel nur für den main-Branch, ein bestimmtes Repository, nur Fehlschläge oder nur Ihr Organisation-Konto statt eines persönlichen Kontos.
5. Beginnen Sie im Feld Repository (owner/repo) zu tippen, um aus Ihren verbundenen Repositorys auszuwählen.

Aktionen auf GitHub ausführen

1. Gehen Sie in Ihrer Automatisierung zu Aktion und wählen Sie Aktion hinzufügen.
2. Wählen Sie eine GitHub-Aktion aus der Liste, zum Beispiel:
   • GitHub-Workflow auslösen, GitHub-Workflow erneut ausführen, Fehlgeschlagene Jobs erneut ausführen, oder GitHub-Run abbrechen
   • GitHub-Issue erstellen, GitHub-Issue kommentieren, GitHub-Issue aktualisieren, GitHub-Issue schließen, GitHub-Issue erneut öffnen, Labels hinzufügen, Label entfernen, oder GitHub-Issue zuweisen
   • Pull Request mergen, oder PR-Review anfordern von Personen oder einem Teams-Eintrag
   • GitHub-Deployment erstellen, Deployment-Status setzen
   • GitHub-Release erstellen
   • Commit-Status setzen
3. Füllen Sie die Felder für diese Aktion aus — zum Beispiel Repository (owner/repo), Workflow-Datei oder -ID, Branch oder Tag, Umgebung, Labels (kommagetrennt), Zuständige (kommagetrennt), oder Reviewer.
4. Bei jedem Feld können Sie einen Wert direkt eingeben, einen Vorschlag aus Ihrem verbundenen GitHub-Konto auswählen, oder Wert einfügen nutzen, um einen Platzhalter aus dem Trigger zu übernehmen.
5. Wählen Sie erneut Aktion hinzufügen, um weitere Schritte hinzuzufügen, oder Automatisierung speichern, wenn Sie fertig sind.

Beispiele

• SSL-Verlängerung fehlgeschlagen → GitHub-Issue erstellen, das Label infrastructure hinzufügen und mit GitHub-Issue zuweisen dem DevOps-Team zuweisen.
• Ein Monitor hat sich erholt → GitHub-Issue kommentieren, dann GitHub-Issue schließen.
• Eine Pull Request wurde in main gemergt → GitHub-Workflow ausführen, um zu deployen, dann Deployment-Status setzen.
• Ihr Produktions-Health-Check war erfolgreich → Commit-Status setzen auf erfolgreich.
• Ein Release wurde veröffentlicht → Statusseiten-Ankündigung posten.

Tipps

• Wenn eine Aktion etwas erstellt — wie ein Issue oder ein Deployment — können spätere Schritte in derselben Automatisierung dies automatisch wiederverwenden, ohne zusätzliche Einrichtung.
• Um eine Review von einem Teams-Eintrag anzufordern, ist eine Organisation-Verbindung erforderlich, kein persönliches Konto.

TipManche Aktionen zeigen ein Pro-Abzeichen im Builder — diese erfordern einen höheren Plan zur Nutzung.

Problembehandlung

• Wenn ein GitHub-Trigger nie ausgelöst wird, prüfen Sie, ob GitHub unter Integrationen korrekt verbunden ist, und bitten Sie Ihren Administrator zu bestätigen, dass die App diesen Ereignistyp abonniert hat.
• Wenn eine Automatisierung Letzter Lauf fehlgeschlagen anzeigt oder Nach wiederholten Fehlern automatisch deaktiviert wird, öffnen Sie die Automatisierung und prüfen Sie den Laufverlauf auf Details, und nutzen Sie dann bei Bedarf Erneut versuchen oder Erneut ausführen.