Nutzt du unsere GitHub-Integration, um Arbeit zwischen GitHub und ClickUp zu synchronisieren? Füge GitHub-Automatisierungen hinzu, um einen effizienten Workflow aufzubauen. Software-Teams können Kontextwechsel reduzieren, indem sie Automatisierungen nutzen, um alles auf dem neuesten Stand zu halten.
Automatisierungs-Integrationen sind für Business-Pläne und höher verfügbar.
Der Workspace-Administrator oder Eigentümer muss den 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 verwenden.
GitHub-Automatisierung in ClickUp erstellen
So richtest du eine GitHub-Automatisierung ein – aus einer Liste, einem Unterordner, einem Ordner oder einem Space:
- Klicke oben rechts auf das Roboter-Symbol.
- 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.
- 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 anzulegen.
- 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.
- 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 Merged
- Branch Merged
- On Commit
- Pull Request Review Created
- Pull Request Review Updated
- CI/CD Status Changed
- Pull Request Linked
- Branch Linked
- Commit Linked
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 hinterlassen, wenn ein Pull Request mit dem Label hotfix in den Branch QA gemergt 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 zusätzlich:
- ist gesetzt: Mindestens ein Label wurde auf den Pull Request angewendet.
- ist nicht gesetzt: Es wurden keine Bezeichnungen auf den Pull Request angewendet.
Bedingung hinzufügen
So fügst du deiner GitHub-Automatisierung eine Bedingung hinzu:
- Klicke in einer Automatisierung unter dem Abschnitt „Trigger" auf Bedingung hinzufügen.
- 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.
- Wähle die Bedingungslogik aus.
- Wähle den Label- oder Branch-Wert, der mit dieser Bedingung verwendet werden soll. Bei Bedingungen wird Groß- und Kleinschreibung berücksichtigt. Sie müssen exakt mit dem Label- oder Branch-Namen übereinstimmen, sonst werden die Kriterien nicht erfüllt und die Automatisierung nicht ausgelöst.
- Klicke auf Weiteres hinzufügen, um einen zusätzlichen Label- oder Branch-Wert hinzuzufügen.
- 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, 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 anlegt.
Wenn beispielsweise ein Bug-Formular ausgefüllt und dadurch eine Aufgabe in einer bestimmten Liste erstellt wird, kann eine Automatisierung ein Issue in GitHub erstellen.