Nutzen Sie unsere GitHub-Integration, um Arbeit zwischen GitHub und ClickUp zu synchronisieren? Fügen Sie GitHub-Automatisierungen hinzu, um einen effizienten Workflow zu erstellen. Softwareteams können durch Automatisierungen den Kontextwechsel reduzieren und alles auf dem neuesten Stand halten.
Was du wissen musst
- Automatisierungsintegrationen sind im Business-Plan und höher verfügbar.
- Der Administrator oder Eigentümer des Workspaces muss die Automatisierungs-ClickApp aktivieren.
- Du benötigst Admin-Berechtigungen für das GitHub-Repository, um Automatisierungen einzurichten.
-
Gäste und eingeschränkte Mitglieder können die GitHub-Integration nicht nutzen.
Fügen Sie eine GitHub-Automatisierung in ClickUp hinzu.
Um eine GitHub-Automatisierung einzurichten, gehe von einer Liste, einem Ordner oder einem Space aus:
-
- Klicke auf die Automatisieren -Schaltfläche oder das Blitz -Symbol.
- Klicke auf Automatisierung erstellen:
- Wähle einen GitHub-Auslöser oder eine Aktion.
- Oder klicke in der linken Seitenleiste auf GitHub und wähle eine Automatisierungsvorlage aus.
- Konfiguriere deinen Auslöser, Bedingungen und Aktionen.
- Wähle dein GitHub-Konto aus oder verbinde es.
- Gib deinen GitHub-Benutzernamen ein und 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 sie erneut hinzufügen, um in Zukunft GitHub Automatisierungen zu erstellen.
- Legen Sie fest, wer Ihr GitHub-Konto zur Erstellung von Automatisierungen verwenden kann.
- Jede GitHub-Automatisierung ermöglicht es dir, ein bestimmtes Repository (Repo) auszuwählen.
- Wähle dein GitHub-Konto aus oder verbinde es.
-
Klicke auf Erstellen.
GitHub-Automatisierungen
GitHub-Automatisierungen verwenden die gleiche Struktur wie Automatisierungen in ClickUp.
Jede Automatisierung besteht aus einem Auslöser und einer Aktion. Benutzer des Business-Plans und höher haben die Möglichkeit, Bedingungen zu nutzen.
GitHub-Auslöser
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
- Zusammengeführter Bereich
- Beim Commit
- Pull Request Überprüfung erstellt
- Pull-Request-Überprüfung aktualisiert
- CI/CD-Status geändert
- Pull Request verknüpft
- Verknüpfte Niederlassung
- Commit Verknüpft
GitHub-Bedingungen
GitHub-Automatisierungen, die sich auf Pull Requests beziehen, unterstützen eine oder mehrere Bedingungen.
Zum Beispiel können Sie den Aufgabenstatus aktualisieren, wenn ein Pull Request mit dem Haupt Bereich verknüpft wird. Oder setzen Sie die Aufgabenpriorität auf dringend und kommentieren Sie, wenn ein Pull-Request mit dem Hotfix -Label in den QA -Bereich zusammengeführt wird.
Bedingungen können für mehrere Kombinationen von Bezeichnungen für Pull Requests, Basis- und Kopf-Referenzwerten eingestellt werden.
Bedingte Logik
Sie können die folgende Bedingungslogik verwenden:
- ist eines von: Der Pull Request enthält mindestens eines der angegebenen Labels oder Bereiche.
- umfasst alle: Der Pull Request beinhaltet alle angegebenen Beschreibungen oder Bereiche.
- ist keines von: Der Pull Request enthält keine der angegebenen Bezeichnungen oder Bereiche.
- ist nicht alles von: Der Pull Request enthält nicht alle der angegebenen Bezeichnungen oder Bereiche.
Für Bezeichnungen kannst du die oben aufgeführte Logik verwenden und:
- ist festgelegt: Mindestens ein Label wurde dem Pull-Request hinzugefügt.
- ist nicht festgelegt: Dem Pull Request wurden keine Beschreibungen hinzugefügt.
Bedingung hinzufügen
Um eine Bedingung zu Ihrer GitHub-Automatisierung hinzuzufügen:
- In einer Automatisierung klicken Sie im Bereich Auslöser auf Bedingung hinzufügen.
- Wählen Sie aus, worauf sich die Bedingung beziehen soll:
- Githublabelcondition: Labels, die dem Pull Request zugeordnet sind.
- Kopf-Referenz: Der Quellzweig, der Ihre vorgeschlagenen Änderungen enthält.
- Basisreferenz: Der Zielbereich, auf den Ihre Änderungen angewendet werden.
- Wählen Sie die Logik für die Bedingung aus.
- Wählen Sie die Beschreibung oder den Bereichswert, der für diese Bedingung verwendet werden soll. Bedingungen sind groß- und kleinschreibungsempfindlich. Sie müssen genau mit dem Beschriftungs- oder Bereichsnamen übereinstimmen, sonst erfüllen sie die Kriterien nicht und lösen die Automatisierung nicht aus.
- Klicke auf Weitere hinzufügen , um eine zusätzliche Bezeichnung oder einen Wert für den Bereich hinzuzufügen.
- Klicken Sie auf Bedingung hinzufügen, um mehrere Bedingungen hinzuzufügen.
ClickUp-Aktionen
Jede Automatisierungsaktion, außer unserer Webhook-Aktion, ist verfügbar, um Aufgaben mit GitHub-Auslösern zu aktualisieren.
Damit Aktionen zur Automatisierung auf bestehende Aufgaben angewendet werden können, muss die Aufgabe bereits mit dem GitHub Repo verknüpft sein, indem ein Commit, ein Bereich oder ein Pull Request angefordert wird. Die Aktion „Aufgabe erstellen“ ist die einzige Ausnahme, da neue Aufgaben nicht im Voraus verknüpft werden können.
Aktionen in GitHub
Sie können Automatisierungen mit der Issue erstellen -Aktion verwenden, die ein neues Problem in GitHub erstellt.
Zum Beispiel, wenn ein Fehlerformular eingereicht wird und eine Aufgabe in einer bestimmten Liste erstellt, kann eine Automatisierung ein Problem in GitHub erstellen.