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.
Schritt 1: Gitlab autorisieren
Verbinden und autorisieren Sie GitLab von ClickUp aus:
- Klicken Sie in der oberen rechten Ecke auf das Schnellaktionsmenü.
- Klicken Sie auf das App-Center.
- Wählen Sie im Seitenleiste des App-Centers die Option Entwicklung aus.
- Klicken Sie auf GitLab.
- Wählen Sie Verbinden.
- Melden Sie sich bei Ihrem GitLab-Konto an.
Autorisieren Sie sich bei gitlab.com oder einem selbst gehosteten GitLab
Sobald Sie Ihr GitLab-Konto verbunden haben, können Sie wählen, ob Sie sich über gitlab.com oder ein selbst gehostetes GitLab autorisieren möchten.
Verwendung von gitlab.com:
- Auf der GitLab App-Center-Seite klicken Sie auf Verwalten.
- 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.
Verwendung von selbst gehostetem GitLab:
- Auf der GitLab App-Center-Seite klicken Sie auf Verwalten.
- 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:
- Wählen Sie aus dem App-Center 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.
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.
Fehlerbehebung bei der Integration
Lesen Sie unseren GitLab Fehlerbehebungsartikel oder treten Sie hier mit dem GitLab-Kundensupport in Verbindung.