GitLab-Integration

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]

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:

  1. Öffne das App-Center.
  2. Suche und wähle GitLab aus.
  3. Wähle Verwalten aus.
  4. Klicke auf Gitlab für das Team aktivieren.
  5. Klicke auf + Gitlab hinzufügen.
  6. Wählen Sie Nein, ich verwende gitlab.com.
  7. Klicke auf Link Gitlab.
  8. 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:

  1. Öffne das App-Center.
  2. Suche und wähle GitLab aus.
  3. Wähle Verwalten aus.
  4. Klicke auf Gitlab für das Team aktivieren.
  5. Klicken Sie auf + Gitlab hinzufügen.
  6. Wählen Sie Ja, ich verwende eine gehostete Version von Gitlab.
  7. Fügen Sie Ihre GitLab-URL in das Host-URL -Textfeld ein.
  8. 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.

  9. Klicke auf Link Gitlab.
  10. 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:

  1. Im App-Center suche und wähle GitLab aus.
  2. Klicke auf Verwalten.
  3. Repositories sind im Abschnitt Meine Repositories von Gitlab aufgelistet.
  4. Klicke rechts neben dem Repository, das du hinzufügen möchtest, auf + Zu ClickUp hinzufügen.

Screenshot von jemandem, der ein Repository zu ClickUp hinzufügt.

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.

Screenshot einer Person, die ClickUp Spaces für ein Repository auswählt.

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:

  1. Öffnen Sie eine Aufgabe und klicken Sie auf das GitLab -Symbol.
  2. Klicken Sie auf den Tab Commits.
  3. Verwenden Sie das Dropdown-Menü neben Neuer Merge-Request , um ein Repository auszuwählen.
  4. Verwenden Sie das Dropdown-Menü Bereich auswählen, um einen Bereich auszuwählen.
  5. Fügen Sie Ihren Commit hinzu.

Screenshot einer Person, die manuell ein GitLab-Commit mit einer ClickUp-Aufgabe verknüpft.

Manuelle Zuordnung von GitLab-Bereichen

Um manuell einen GitLab-Bereich zu verknüpfen:

  1. Öffnen Sie eine Aufgabe und klicken Sie auf das GitLab -Symbol.
  2. Klicken Sie auf die Registerkarte Bereiche.
  3. Verwenden Sie das Dropdown-Menü neben Neuer Merge-Request , um ein Repository auszuwählen.
  4. Verwende die Auswahl "Bereich auswählen ", um einen Bereich anzuhängen.

Screenshot von jemandem, der einen Zweig anhängt.

Ändern Sie automatisch den Status von Aufgaben aus GitLab. 

Sie können den Status einer Aufgabe aus einem Commit, Problem oder Merge-Request ändern:

  1. 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.

  2. Der Status der Aufgabe wird sich ändern.

Erstellen Sie neue Zweige aus ClickUp

Erstellen Sie neue Zweige mit Schnellaktionen in ClickUp:

  1. Öffnen Sie eine Aufgabe und klicken Sie auf das GitLab -Symbol.
  2. 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.

Screenshot einer Person, die einen neuen Zweig aus ClickUp erstellt.

Passen Sie automatisch generierte Bereichsnamen an

Sie können das Format der automatisch generierten Branch-Namen anpassen, das bei Schnellaktionen verwendet wird:

  1. Wähle im App Center GitLab aus.
  2. Unter Automatisch generierte Branch-Namen formatieren, nehmen Sie Änderungen vor.Screenshot einer Person, die das automatisch generierte Branch-Format ändert.
  3. 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:

  1. Öffnen Sie eine Aufgabe und klicken Sie auf das GitLab -Symbol.
  2. Klicke unten links im modalen Fenster auf Neuer Merge-Request.
  3. Verwenden Sie den vorgefertigten Titel für Merge-Anfragen oder erstellen Sie Ihren eigenen.
  4. Wählen Sie ein Repository, einen Quellbereich und einen Zielbereich aus.
  5. Geben Sie eine Beschreibung ein.
  6. 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.

Screenshot einer Person, die eine Marge-Anfrage von ClickUp erstellt.

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:

  1. Wählen Sie im App-Center GitLab aus.
  2. Unten rechts klicken Sie auf Gitlab entfernen.

War dieser Beitrag hilfreich?