Suche

Frag mich alles

GitHub-Automatisierungen verwenden

Nutzt du unsere GitHub-Integration, um Arbeit zwischen GitHub und ClickUp zu synchronisieren? Füge GitHub-Automatisierungen hinzu, um einen effizienten Workflow aufzubauen. Softwareteams können den Kontextwechsel reduzieren, indem sie Automatisierungen nutzen, um alles aktuell zu halten.

Automatisierungs-Integrationen sind ab dem Business-Plan verfügbar.

Der Workspace-Administrator oder Eigentümer muss die Automatisierungs-ClickApp aktivieren.

Du benötigst Administrator-Berechtigungen für das GitHub-Repository, um Automatisierungen einzurichten.

Gäste und eingeschränkte Mitglieder können die GitHub-Integration nicht nutzen.

Eine GitHub-Automatisierung in ClickUp erstellen

Um eine GitHub-Automatisierung einzurichten, gehe in einer Liste, einem Unterordner, einem Ordner oder einem Space wie folgt vor:

  1. Klicke oben rechts auf das Roboter-Symbol.
  2. Klicke auf Automatisierung erstellen:
    • Wähle einen GitHub-Trigger oder eine Aktion aus.
    • Oder klicke in der linken Seitenleiste auf GitHub und wähle eine Automatisierungsvorlage aus.
  3. Konfiguriere deinen Trigger, deine Bedingungen und deine Aktionen.
    • Wähle dein GitHub-Konto aus oder verbinde es.
    • Gib deinen GitHub-Benutzernamen ein, klicke auf Konto verbinden und autorisiere ClickUp.
    • Oder klicke auf Konto erstellen, um ein neues Konto auf GitHub.com zu erstellen.
    • Um ein zuvor autorisiertes GitHub-Konto zu aktualisieren, musst du es entfernen und erneut hinzufügen.
    • Das Entfernen eines Kontos hat keine Auswirkungen auf bestehende Automatisierungen, die dieses Konto verwenden. Du musst es erneut hinzufügen, um künftig GitHub-Automatisierungen erstellen zu können.
    • Lege fest, wer dein GitHub-Konto zum Erstellen von Automatisierungen verwenden darf.
    • Bei jeder GitHub-Automatisierung kannst du ein bestimmtes Repository (Repo) auswählen.
  4. Klicke auf Erstellen.

GitHub-Automatisierungen

GitHub-Automatisierungen verwenden dieselbe Struktur wie Automatisierungen in ClickUp.

Jede Automatisierung besteht aus einem Trigger und einer Aktion. Nutzer des Business-Plans und höher können zusätzlich Bedingungen verwenden.

GitHub-Trigger

Wenn die folgenden Ereignisse im angegebenen GitHub-Repo eintreten und die Bedingungen erfüllt sind, wird die Automatisierung ausgeführt und eine Aktion durchgeführt.

  • Pull Request zusammengeführt
  • Branch zusammengeführt
  • Bei Commit
  • Pull-Request-Review erstellt
  • Pull-Request-Review aktualisiert
  • CI/CD-Status geändert
  • Pull Request verknüpft
  • Branch verknüpft
  • Commit verknüpft

GitHub-Bedingungen

GitHub-Automatisierungen, die sich auf Pull Requests beziehen, unterstützen eine oder mehrere Bedingungen.

Du kannst beispielsweise den Aufgaben-Status aktualisieren, wenn ein Pull Request zum Branch main verknüpft wird. Oder die Aufgaben-Priorität auf „Dringend" setzen und einen Kommentar hinzufügen, wenn ein Pull Request mit dem Label hotfix in den Branch QA zusammengeführt wird.

Bedingungen können für mehrere Kombinationen aus Pull-Request-Labels, Base-Ref- und Head-Ref-Werten festgelegt werden.

Bedingungslogik

Du kannst die folgende Bedingungslogik verwenden:

  • Ist eines von: Der Pull Request enthält mindestens eines der angegebenen Bezeichnungen oder Branches.
  • Ist alles von: Der Pull Request enthält alle angegebenen Bezeichnungen oder Branches.
  • Ist keines von: Der Pull Request enthält keines der angegebenen Bezeichnungen oder Branches.
  • Ist nicht alles von: Der Pull Request enthält nicht alle angegebenen Bezeichnungen oder Branches.

Für Bezeichnungen kannst du die oben aufgeführte Logik verwenden und außerdem:

  • Ist gesetzt: Mindestens ein Label wurde auf den Pull Request angewendet.
  • Ist nicht gesetzt: Es wurden keine Bezeichnungen auf den Pull Request angewendet.

Eine Bedingung hinzufügen

So fügst du deiner GitHub-Automatisierung eine Bedingung hinzu:

  1. Klicke in einer Automatisierung im Abschnitt „Trigger" auf Bedingung hinzufügen.
  2. Wähle aus, worauf die Bedingung angewendet werden soll:
    • GitHub-Label-Bedingung: Bezeichnungen, die auf den Pull Request angewendet werden.
    • Head Ref: Der Quell-Branch, der deine vorgeschlagenen Änderungen enthält.
    • Base Ref: Der Ziel-Branch, auf den deine Änderungen angewendet werden.
  3. Wähle die Bedingungslogik aus.
  4. Wähle den Label- oder Branch-Wert aus, der für diese Bedingung verwendet werden soll. Bedingungen unterscheiden zwischen Groß- und Kleinschreibung und müssen genau mit dem Label- oder Branch-Namen übereinstimmen – sonst werden die Kriterien nicht erfüllt und die Automatisierung wird nicht ausgelöst.
  5. Klicke auf Weiteres hinzufügen, um einen weiteren Label- oder Branch-Wert einzufügen.
  6. Klicke auf Bedingung hinzufügen, um mehrere Bedingungen hinzuzufügen.

ClickUp-Aktionen

Jede Automatisierungsaktion – mit Ausnahme der Webhook-Aktion – steht zur Verfügung, um Aufgaben mithilfe von GitHub-Triggern zu aktualisieren.

Damit Automatisierungsaktionen auf bestehende Aufgaben angewendet werden können, muss die Aufgabe bereits mit dem GitHub-Repo verknüpft sein – über einen verknüpften Commit, Branch oder Pull Request. Die Aktion „Aufgabe erstellen" ist die einzige Ausnahme, da neue Aufgaben nicht im Voraus verknüpft werden können.

Aktionen in GitHub

Du kannst Automatisierungen mit der Aktion Issue erstellen verwenden, die ein neues Issue in GitHub erstellt.

Wenn beispielsweise ein Fehler-Formular ausgefüllt wird und eine Aufgabe in einer bestimmten Liste erstellt, kann eine Automatisierung ein Issue in GitHub erstellen.