GitHub-Repository-Web-Auslöser

Die GitHub-Repository-Webhooks werden verwendet, um ein Repository innerhalb einer GitHub-Organisation auf Ereignisse zu überwachen. Sobald das Ereignis im Repository auftritt, wird der Auslöser aktiviert und startet den Automatisierungs-Workflow.

Ordnen Sie Ihren Auslöser einem Repository innerhalb einer GitHub-Organisation zu und konfigurieren Sie den Auslöser so, dass die Automatisierung ausgeführt wird, wenn im Repository Ereignisse auftreten.

Der GitHub-Repository-Web-Auslöser unterstützt die folgenden Ereignisse in einem Repository:
  • Erstellen
  • Fork
  • Kommentar zum Problem
  • Probleme
  • Bezeichnung
  • Pull-Anfrage
  • Überprüfung von Pull-Anfragen
  • Push
  • Star
  • Ansehen

Zum Beispiel können Sie einen GitHub-Repository-Web-Auslöser erstellen, um ein Repository innerhalb einer GitHub-Organisation auf Pull-Anfragen zu überwachen. Wenn eine Pull-Anfrage im überwachten Repository auftritt, wird der Auslöser aktiviert und die nächsten Aktionen in der Automatisierung werden eingeleitet.

Vorbereitungen

  • Sie müssen über eine Bot Creator- oder Citizen Developer-Lizenz verfügen.
  • Sie müssen die Berechtigung Meine Bots anzeigen haben.
  • Sie müssen über alle EVENT TRIGGERS-Berechtigungen für die Rolle verfügen.
  • Sie müssen die Berechtigung Einchecken und Auschecken für die Ordner haben, in denen sich die Automatisierung befindet.
  • Sie müssen in Ihrem Control Room angemeldet sein.
  • Die GitHub-Web-Auslöser verwenden Personal Access Token, um die Identität des Benutzerprofils zu authentifizieren. Der GitHub-Web-Auslöser unterstützt klassische und feinabgestimmte Zugriffstoken. Sie müssen ein Personal Access Token in den GitHub-Benutzereinstellungen generieren und es im Credential Vault speichern. Weitere Informationen zum Erstellen und Verwalten des Personal Access Token finden Sie im Abschnitt Personal Access Token verwalten.

Prozedur

  1. Klicken Sie im linken Fensterbereich auf Automatisierung.
  2. Klicken Sie auf Erstellen > Task Bot.
    Der Assistent Task Bot erstellen wird angezeigt.
  3. Geben Sie einen geeigneten Namen für den Bot in das Feld Name ein.
    Alle Bots werden standardmäßig im Ordner \Bots gespeichert.
  4. Optional: Sie können eine Beschreibung für den Bot im Feld Beschreibung hinzufügen.
  5. Optional: Sie können die Auswählen-Schaltfläche verwenden, um den Bot in einem anderen Ordner zu speichern.
  6. Klicken Sie auf Erstellen und bearbeiten.
    Der Bot ist erstellt und der Task Bot bearbeiten wird angezeigt.
  7. Klicken Sie auf Auslöser > GitHub und doppelklicken Sie dann auf Repository-Web-Auslöser oder ziehen Sie ihn, um den Web-Auslöser zum Abschnitt Auslöser hinzuzufügen.
  8. Wählen Sie aus der Dropdown-Liste Auf Ereignis achten das oder die Ereignisse, auf die Sie achten möchten.
  9. Geben Sie den GitHub-Repository-Namen im Feld Repository-Name ein.
  10. Geben Sie den GitHub-Profilnamen im Benutzerprofil ein.
  11. Wählen Sie im Abschnitt Authentifizierungstyp auswählen eine der folgenden Optionen.
    Der Persönliche Zugriffstoken ist standardmäßig als Authentifizierungstyp unter Authentifizierungstyp wählen ausgewählt.
    • Anmeldedaten: Klicken Sie auf Auswählen, um den persönlichen Zugriffstoken auszuwählen, der bereits im Credential Vault konfiguriert ist.
    • Unsichere Zeichenfolge: Kopieren Sie die Zeichenfolge des persönlichen Zugriffstokens, die in den GitHub-Entwicklereinstellungen generiert wird, und fügen Sie sie ein.
      Anmerkung: Stellen Sie sicher, dass das persönliche Zugriffstoken nicht abgelaufen ist.
  12. Optional: Fügen Sie dem Auslöser in der Option Antwort Variablen hinzu. Weitere Informationen zu den Variablen finden Sie unter Übersicht über die Variablen.
    Anmerkung: Wenn Sie eine vorhandene Variable für die Antwort verwenden, achten SIe bitte darauf, dass das Kontrollkästchen Als Eingabe verwenden für die Variable aktiviert ist.
  13. Optional: Fügen Sie bei Bedarf weitere Auslöser im Abschnitt Auslöser hinzu.
  14. Doppelklicken Sie auf eine geeignete Aktion in der Palette Aktionen oder ziehen Sie sie in den Abschnitt Aktion.
    Weitere Informationen zu Aktionen finden Sie unter Aktionen zum Erstellen von Automatisierungen.
  15. Klicken Sie auf Speichern, um den Bot zu speichern.
Wenn Sie den Bot mit Mit Auslösern ausführen, wird der Web-Auslöser aktiviert und achtet auf Issues-, Star- und Watch-Ereignisse. Wenn eines der Ereignisse im Repository auftritt, löst der Auslöser die nachfolgende Nachrichtenfeld-Aktion aus.