Integriere Gitlab Commits, Branches und Merge-Requests mit ClickUp Aufgaben. So kannst du:
- Sehen Sie alle GitLab-Aktivitäten, die mit einer Aufgabe in ClickUp zusammenhängen.
- Optional ClickUp-Benachrichtigungen erhalten, wenn neue GitLab-Aktivitäten zu Aufgaben hinzugefügt werden.
- Automatisch oder manuell GitLab-Aktivitäten an ClickUp-Aufgaben anhängen.
-
Verändere automatisch den Status mit Gitlab Aktionen, indem du die ClickUp Aufgabe ID mit diesem Format zu deinen Commits hinzufügst:
#{taskID}[Status]
.- Beispiel:
#1abc2de[geschlossen]
- Beispiel:
Was Sie benötigen
- Die GitLab-Integration ist in allen ClickUp-Plänen verfügbar.
- Nur Eigentümer und Administratoren des Workspaces können Integrationen einrichten.
- Gäste können die GitLab-Integration nicht nutzen.
- Die GitLab-Integration funktioniert sowohl mit On-Premise- als auch mit selbst gehosteten Versionen von GitLab.
Persönliche und Team-Repositorys
Die Tabelle unten erklärt die Unterschiede zwischen persönlichen und Team-Repositorys.
Repository-Typ | Name in ClickUp | Beschreibung |
Privat | Meine Repositorys von Gitlab |
Repositorys, auf die du persönlich in GitLab Zugriff hast, werden im Bereich Meine Repositorys aus GitLab angezeigt. Der erste Schritt, um unsere GitLab-Integration einzurichten, besteht darin, ClickUp den Zugriff auf diese Repos zu autorisieren, damit du sie in die Repos deines ClickUp-Workspaces integrieren kannst. Entweder HTTP oder HTTPS wird benötigt, um auf deine gehosteten Server zuzugreifen. Stelle sicher, dass du die Basis-URL deines GitLab-Servers verwendest. Zum Beispiel: https://gitlab.meinefirma.com Aus Sicherheitsgründen erfordern wir, dass alle GitLab-Integrationen, die eine selbst gehostete GitLab-Instanz verwenden, eine Top-Level-Domain (TLD) besitzen. Wir erlauben keine IP-Adressen oder Domains, die nicht als Top-Level-Domain anerkannt sind. |
Team | Zu ClickUp hinzugefügte GitLab-Repositorys |
Repositorys, auf die dein Workspace Zugriff hat, werden unter Zu ClickUp hinzugefügte GitLab-Repositorys angezeigt. Hier angezeigte Repos bedeuten, dass Mitglieder deines Workspaces sie autorisiert haben, vom gesamten ClickUp-Workspace abgerufen zu werden. Um GitLab Repos in ClickUp zu verwenden, müssen sie zu deinen ClickUp Workspace Repos hinzugefügt werden. |
Schritt 1: Gitlab autorisieren
Du kannst GitLab mit gitlab.com oder einem selbst gehosteten GitLab autorisieren.
Autorisiere mit gitlab.com
Um dich bei gitlab.com zu autorisieren:
- Öffne das App-Center.
- Suche und wähle GitLab aus.
- Wähle Verwalten aus.
- Klicke auf Gitlab für das Team aktivieren.
- Klicke auf + Gitlab hinzufügen.
- Wählen Sie Nein, ich verwende gitlab.com.
- Klicke auf Link Gitlab.
- Klicken Sie auf Autorisieren. Sie müssen ClickUp autorisieren, um GitLab-Aktivitäten mit ClickUp-Aufgaben zu verknüpfen.
Autorisiere mit selbst gehostetem GitLab
Um ein selbst gehostetes GitLab zu autorisieren:
- Öffne das App-Center.
- Suche und wähle GitLab aus.
- Wähle Verwalten aus.
- Klicke auf Gitlab für das Team aktivieren.
- Klicken Sie auf + Gitlab hinzufügen.
- Wählen Sie Ja, ich verwende eine gehostete Version von Gitlab.
- Fügen Sie Ihre GitLab-URL in das Host-URL -Textfeld ein.
- Beispiel-URL: https: //gitlab.mydomain.com/
- Befolge die Anweisungen, um dein persönliches Token für den Zugriff zu finden, zu kopieren und in das Textfeld Token für den Zugriff einzufügen.
Wenn sich dein Team hinter einer Firewall befindet, nimm deine statische IP-Adresse vor der Integration in die Liste der zulässigen Firewall-Adressen auf. Diese statische IP-Adresse wird bei diesem Schritt angezeigt.
- Klicke auf Link Gitlab.
- Klicken Sie auf Autorisieren. Sie müssen ClickUp autorisieren, um GitLab-Aktivitäten mit ClickUp-Aufgaben zu verknüpfen.
Aus Sicherheitsgründen erfordern wir, dass alle GitLab-Integrationen, die eine selbst gehostete GitLab-Instanz verwenden, eine Top-Level-Domain (TLD) haben. Die URL darf keine angehängte Portnummer enthalten. Wir erlauben keine IP-Adressen oder Domains, die nicht als Top-Level-Domain anerkannt sind. Ein Beispiel für eine gültige URL wäre https://gitlab.clickup.com.
Schritt 2: Persönliche Repositories zu ClickUp hinzufügen
Mehrere Personen können Gitlab in deinem Workspace autorisieren. Sie können anpassen, welche Repositorys mit Ihrem Workspace geteilt werden, sodass Sie Ihr persönliches Konto autorisieren können, ohne alle Ihre Repositorys anzuhängen.
Das Anhängen eines Repositorys gewährt Benutzern keinen Zugriff auf den Codebasis Ihres Repositorys. Dies ermöglicht es Benutzern, Verlaufsdaten für dieses Repository den Spaces, die Sie angeben, anzuhängen.
So fügen Sie ein Repository zu ClickUp hinzu:
- Im App-Center suche und wähle GitLab aus.
- Klicke auf Verwalten.
- Repositories sind im Abschnitt Meine Repositories von Gitlab aufgelistet.
- Klicke rechts neben dem Repository, das du hinzufügen möchtest, auf + Zu ClickUp hinzufügen.
Schritt 3: Wählen Sie aus, welche Spaces mit Ihren Repositories verknüpft sind
Hinzugefügte Repositories werden im Abschnitt Gitlab Repositories hinzugefügt zu ClickUp unten rechts aufgelistet.
Um ein Repository einem ClickUp-Space zuzuordnen, klicken Sie auf das Dropdown-Menü rechts vom Repositoriumsnamen und wählen Sie einen oder mehrere Spaces aus.
Das Repository muss an einen Space angehängt sein, bevor du Gitlab-Elemente an Aufgaben anhängen kannst.
Automatische Verknüpfung von GitLab-Aktivitäten in ClickUp
ClickUp kann automatisch neue GitLab-Aktivitäten mit Aufgaben verknüpfen.
Um dies zu tun, fügen Sie eine ClickUp Aufgaben-ID in einem Teil des Titels des Merge-Requests, des Branch-Namens oder der Commit-Nachricht in einem dieser Formate hinzu:
#{task_id}
CU-{task_id}
{custom_task_id}
#{custom_task_id}
Zum Beispiel:
#1abc2de
CU-1abc2de
prefix-1
#prefix-1
GitLab-Commits manuell zuordnen
Um manuell ein GitLab-Commit mit einer ClickUp-Aufgabe zu verknüpfen:
- Öffnen Sie eine Aufgabe und klicken Sie auf das GitLab -Symbol.
- Klicken Sie auf den Tab Commits.
- Verwenden Sie das Dropdown-Menü neben Neuer Merge-Request , um ein Repository auszuwählen.
- Verwenden Sie das Dropdown-Menü Bereich auswählen, um einen Bereich auszuwählen.
- Fügen Sie Ihren Commit hinzu.
Manuelle Zuordnung von GitLab-Bereichen
Um manuell einen GitLab-Bereich zu verknüpfen:
- Öffnen Sie eine Aufgabe und klicken Sie auf das GitLab -Symbol.
- Klicken Sie auf die Registerkarte Bereiche.
- Verwenden Sie das Dropdown-Menü neben Neuer Merge-Request , um ein Repository auszuwählen.
- Verwende die Auswahl "Bereich auswählen ", um einen Bereich anzuhängen.
Ändern Sie automatisch den Status von Aufgaben aus GitLab.
Sie können den Status einer Aufgabe aus einem Commit, Problem oder Merge-Request ändern:
- Fügen Sie die ClickUp Aufgaben-ID in einen beliebigen Teil der Commit-Nachricht ein und schließen Sie den gewünschten Status in eckige Klammern ein.
- Zum Beispiel:
#u7hu[staged]
Alle in dem Abschnitt Automatische Zuordnung von GitLab-Aktivitäten in ClickUp dieses Artikels aufgeführten Formate können verwendet werden. Um eine korrekte Formatierung zu gewährleisten, fügen Sie keinen Leerzeichen zwischen der Aufgaben-ID und den Statusinformationen hinzu.
- Zum Beispiel:
- Der Status der Aufgabe wird sich ändern.
Erstellen Sie neue Zweige aus ClickUp
Erstellen Sie neue Zweige mit Schnellaktionen in ClickUp:
- Öffnen Sie eine Aufgabe und klicken Sie auf das GitLab -Symbol.
- Links finden Sie mehrere automatisch generierte Schnellkopieroptionen. Wenn Sie direkt in GitLab einen neuen Bereich erstellen möchten, klicken Sie unten links im modales Fenster auf Bereich erstellen.
Passen Sie automatisch generierte Bereichsnamen an
Sie können das Format der automatisch generierten Branch-Namen anpassen, das bei Schnellaktionen verwendet wird:
- Wähle im App Center GitLab aus.
- Unter Automatisch generierte Branch-Namen formatieren, nehmen Sie Änderungen vor.
- Unten rechts klicken Sie auf Speichern.
Erstellen Sie Merge-Anfragen aus ClickUp
Erstelle oder verknüpfe Merge-Requests von ClickUp.
Um einen neuen Merge-Request zu erstellen:
- Öffnen Sie eine Aufgabe und klicken Sie auf das GitLab -Symbol.
- Klicke unten links im modalen Fenster auf Neuer Merge-Request.
- Verwenden Sie den vorgefertigten Titel für Merge-Anfragen oder erstellen Sie Ihren eigenen.
- Wählen Sie ein Repository, einen Quellbereich und einen Zielbereich aus.
- Geben Sie eine Beschreibung ein.
- Erstellen Sie den Merge-Request, indem Sie auf Neuer Merge-Request klicken.
Sobald Sie eine Anfrage in ClickUp erstellen oder zusammenführen, wird automatisch ein Link zur zugehörigen ClickUp-Aufgabe in den Merge-Request in GitLab hinzugefügt.
Nachdem ein Merge-Request verknüpft wurde, können Sie innerhalb der verknüpften ClickUp-Aufgabe sehen, wer ihn geöffnet hat, den Prüfer, den CI/CD-Status und den Status des Merge-Requests einsehen.
Verbindungsprobleme
Wenn du versehentlich das falsche GitLab-Konto verbunden hast oder es ein Problem mit der Verbindung gibt, kannst du deine Repos oder dein gesamtes Konto trennen und erneut verbinden.
Musst du ein Problem mit einem GitLab-Vertreter klären? Fordere den Kundensupport von GitLab hier an.
GitLab-Integration entfernen
Nur Eigentümer und Administratoren des Workspaces können die GitLab-Integration entfernen.
Um die GitLab-Integration zu entfernen:
- Wählen Sie im App-Center GitLab aus.
- Unten rechts klicken Sie auf Gitlab entfernen.