GitLab mit Notion verbinden

In diesem Hilfedokument

GitLab hilft deinem Team, Code zu verwalten, in der Softwareentwicklung zusammenzuarbeiten und Releases nachzuverfolgen. Du kannst Projekte, Issues, Merge Requests, Pipelines und Releases in Notion syncen, damit alles bei Plänen und Docs bleibt.


Wir ersetzen bestehende verwaltete GitLab-Synchronisierungen durch maßgeschneiderte Synchronisierungen, die von Notion-Workern unterstützt werden. Du kannst anpassen, welche Daten du synchronisierst und wie diese in Notion organisiert werden. Deine bestehenden synchronisierten Daten bleiben in Notion; folge dieser Anleitung, um einen Ersatz einzurichten. Erfahre mehr über Notion-Worker →.

Bestehende GitLab-Synchronisierungen funktionieren ab dem 30. Oktober 2026 nicht mehr. Bis dahin funktionieren sie wie gewohnt, übertragen sich aber nicht von selbst. Wir empfehlen, deine Ersatzsynchronisierung vor diesem Datum einzurichten.

Workers führen deine Synchronisierung auf der Infrastruktur von Notion aus. Um deinen Ersatz einzurichten, @-erwähne in einem Chat mit Notion AI deine bestehende synchronisierte Datenbank und füge den GitLab-Sync-Skill hinzu.

Mach Folgendes bereit:

  • Deine bestehende in Notion synchronisierte GitLab-Datenbank. Stelle sicher, dass Notion AI darauf zugreifen kann.

  • Die vollständige Liste der einzubeziehenden GitLab-Projekte. Du kannst Projekt-URLs, numerische IDs oder Pfade wie my-team/my-project angeben. Erfahre, wie du Projekte in GitLab anzeigst →

  • Dein persönliches oder projektbezogenes GitLab-Zugriffstoken mit read_api und Zugriff auf jedes ausgewählte Projekt.

  • Zugriff auf Workers und die Tools, die Notion AI benötigt, um einen Worker in deinem Workspace zu erstellen und bereitzustellen.

  • Diese Skill-Seite, die du in dein Notion-Konto kopierst: GitLab Guide: Worker Sync. Dieser Skill ist für GitLab.com gedacht. Wenn du eine selbstverwaltete GitLab-Instanz verwendest, teile Notion AI das vor der Einrichtung mit. Die API-Adresse und die Konfiguration der Anmeldeinformationen des Leitfadens müssen für deine Instanz angepasst und validiert werden.

Hinweis: Diese Anleitung erstellt Ersatzdatenbanken. Deine bestehende Datenbank bleibt verfügbar, während du diese überprüfst. Deine Seitenlinks, Ansichten, Verknüpfungen und Notion-spezifischen Informationen werden nicht automatisch übertragen.

Öffne einen Chat mit Notion AI in dem Workspace, der deine bestehende synchronisierte Datenbank enthält.

Kopiere den unten stehenden Prompt. Ersetze @Existing GitLab sync database, indem du @ eingibst und die tatsächliche Datenbank aus dem @-Erwähnungsmenü auswählst. Wenn Issues und Merge Requests in separaten synchronisierten Datenbanken gespeichert sind, erwähne beide.

Ersetze meine aktuelle GitLab-Synchronisierung, @Existing GitLab sync database, durch einen Notion Worker unter Verwendung des GitLab Guide: Worker Sync.

Überprüfe die bestehende Datenbank und bestätige die vollständige GitLab-Projektliste mit mir. Folge der Skill-Anleitung, um die stündlichen Synchronisierungen, fünf zugehörige Datenbanken, Ansichten und das Dashboard unter einer privaten ‚GitLab Sync‘-Seite zu erstellen. Falls bereits ein Ersatz-Worker existiert, überprüfe ihn und nutze ihn gegebenenfalls erneut.

Behalte deine bestehende Datenbank. Identifiziere benutzerdefinierte Eigenschaften, reine Notion-Werte, Ansichten, Verknüpfungen und Links, die separat behandelt werden müssen. Fordere dein GitLab-Token über eine sichere Anmeldeinformationen-Eingabe an, nicht im Chat.

Sieh dir jedes ausgewählte Projekt und jeden Datentyp in der Vorschau an, schließe die erste Synchronisierung ab und überprüfe Datensätze sowie Projektverknüpfungen. Zeig mir die Ersatzdatenbanken, etwaige Unterschiede und die Schritte für den Wechsel, bevor du die alte Synchronisierung änderst.

Wähle eine tatsächliche Datenbank-@-erwähnung im Prompt aus. Die bloße Eingabe des Datenbanknamens liefert Notion AI keinen /link zur Überprüfung.

Bestätige die vollständige Projektliste, inklusive der Projekte, die durch die Filter deiner aktuellen Notion-Ansicht verborgen sind. Ein auf ein Projekt beschränktes Token reicht nicht für eine Synchronisierung, die auch Zugriff auf andere Projekte benötigt.

Folge den Anweisungen von Notion AI, um dein GitLab-Token über die sichere Anmeldeinformationen-Eingabe bereitzustellen. Es benötigt read_api und Zugriff auf die ausgewählten Projekte.

Füge das Token nicht in den Chat, auf eine Notion-Seite oder in eine Datenbank-Eigenschaft ein. Der Worker verwendet vermittelte Anmeldeinformationen, sodass sein Code das rohe Token nicht auslesen muss.

Diese Einrichtung verwendet neue Worker-Anmeldeinformationen. Deine bestehende GitLab-Verbindung stellt diese nicht automatisch bereit.

Wenn Notion AI nicht auf den Skill oder die Worker-Tools zugreifen kann, behebe zuerst diesen Zugriff. Der verlinkte Leitfaden enthält auch Einrichtungsanweisungen für jemanden aus deinem Team, der die Notion CLI verwenden kann.

Der Skill erstellt eine private GitLab Sync-Seite, die fünf synchronisierte Datenbanken und ein Dashboard enthält:

Datenbank

Was es beinhaltet

GitLab-Projekte

Projektnamen, Pfade, Beschreibungen, Archivstatus, Sichtbarkeit, Standard-Branches, Links und Aktivitätsdaten.

GitLab Issues

Issues über verschiedene Status hinweg, mit Zuweisungen, Labels, Meilensteinen, Schweregrad, Fälligkeitsdaten und Projektverknüpfungen.

GitLab Merge Requests

Merge Requests über verschiedene Status hinweg, mit Entwurfsstatus, Autoren, Zuweisungen, Branches, Merge-Status und Projektverknüpfungen.

GitLab Pipelines

Pipeline-Status, Referenzen, Quelle, Daten, Links und Projektverknüpfungen.

GitLab Releases

Release-Namen, Tags, Beschreibungen, Release-Daten, Links und Projektverknüpfungen.

GitLab Dashboard führt diese Datensätze in Diagrammen und Arbeitswarteschlangen zusammen. Es enthält offene Issues, offene Merge Requests, fehlgeschlagene Pipelines, aktuelle Releases und Projektaktivität.

Die fünf synchronisierten Datenbanken enthalten die Datensätze. Das Dashboard zeigt Ansichten dieser Datensätze an. Deine alte Issue- oder Merge-Request-Datenbank deckte möglicherweise weniger Datentypen ab als die Standardeinrichtung dieses Skills.

Überprüfe diese Unterschiede vor dem Wechsel:

  • Personen und Labels: Autoren, Zuweisungen und Labels werden in dieser Anleitung als Text gespeichert. Es handelt sich nicht um Notion-Personen- oder Mehrfachauswahl-Eigenschaften.

  • Projektverknüpfungen: Issues, Merge Requests, Pipelines und Releases sollten mit ihren ausgewählten Projektdatensätzen verknüpft werden.

  • Datensätze aus verschiedenen Projekten müssen getrennt bleiben, auch wenn sie dieselbe projektlokale Issue- oder Merge-Request-Nummer verwenden.

  • Zusätzlicher Inhalt: Der Leitfaden synchronisiert keine Issue-Kommentare, Merge-Request-Diskussionen, Repository-Dateien oder Job-Protokolle. Bitte Notion AI, alle zusätzlichen Felder zu bewerten, die dein bestehender Workflow benötigt.

Warte, bis Notion AI bestätigt, dass alle fünf Synchronisierungen fehlerfrei sind und der anfängliche Import abgeschlossen ist.

  1. Vergleiche jedes ausgewählte Projekt mit GitLab. Überprüfe eine Stichprobe von offenen und geschlossenen Issues, Merge Requests, Pipelines und Releases.

  2. Bestätige, dass Projektverknüpfungen und Dashboard-Ansichten die erwarteten Datensätze anzeigen.

  3. Überprüfe, ob eine kürzliche GitLab-Änderung den Ersatz nach einer erfolgreichen Aktualisierung erreicht.

  4. Überprüfe die benutzerdefinierten Eigenschaften und die reinen Notion-Werte der alten Datenbank mit Notion AI. Übertrage, was du benötigst, unter Verwendung stabiler GitLab-Datensatz-IDs.

  5. Aktualisiere Links, verknüpfte Datenbankansichten, Verknüpfungen und Automatisierungen, die den Ersatz nutzen sollen. Überprüfe die Freigabeberechtigungen der neuen Seite.

  6. Sobald dein Team den Ersatz nutzt, bitte Notion AI, dir beim Stilllegen der alten Synchronisierung zu helfen, während die alte Datenbank als Referenz erhalten bleibt.

Du musst die alte Datenbank nicht löschen, um den Worker zu nutzen. Behalte sie, bis du überprüft hast, dass die Informationen und Workflows deines Teams berücksichtigt wurden.

Die Fähigkeit richtet fünf stündliche Synchronisierungen ein, eine für jeden Datentyp. Projekte werden während der Einrichtung zuerst synchronisiert, damit die anderen Datenbanken ihre Datensätze mit den richtigen Projekten verknüpfen können.

Jede erfolgreiche Aktualisierung liest alle Ergebnisseiten für die konfigurierten Projekte und aktualisiert die entsprechende Notion-Datenbank. Der Worker läuft weiter, wenn Notion geschlossen ist.

Aktualisierungen fließen von GitLab zu Notion. Ändere die synchronisierten Werte in GitLab; Änderungen in Notion werden nicht zurückgeschrieben.

Stündlich ist der Zeitplan, keine Garantie dafür, dass jede Aktualisierung innerhalb einer festen Zeit abgeschlossen wird. Große Projekthistorien und GitLab-Anfragebeschränkungen können den Abschluss verzögern.

Tipp: Behalte die vollständige Projektliste bei. Diese Synchronisierungen verwenden den Ersetzungsmodus: Datensätze, die bei einer vollständigen Aktualisierung fehlen, werden aus der synchronisierten Datenbank entfernt. Das Entfernen eines Projekts aus der Konfiguration kann dessen synchronisierte Datensätze entfernen, einschließlich der Notion-spezifischen Informationen auf diesen Seiten. Bitte Notion-KI, jedes ausgewählte Projekt und jeden Datentyp vor dem Anwenden einer Änderung in der Vorschau anzuzeigen.

Die Fähigkeit beginnt mit einer privaten GitLab Sync-Seite. Teile sie nur mit den Personen, die die importierten Datensätze sehen sollen.

Notions Berechtigungen steuern den Zugriff auf die synchronisierten Daten. Die Visibility-Eigenschaft eines GitLab-Projekts oder die Confidential-Eigenschaft eines Issues erzwingt diese Berechtigung in Notion nicht. Überprüfe die vom Token einbezogenen Daten, bevor du die Seite teilst.

Ein Projekt fehlt

Bestätige die vollständige Projektliste und den Token-Zugriff. Gib Notion AI die URL oder die numerische ID des Projekts, falls sich dessen Lernpfad geändert hat. Führe keine Aktualisierung mit einer verkürzten Liste durch, nur um einen Zugriffsfehler zu umgehen.

Ein Issue oder Merge Request fehlt

Bitte Notion AI, die Projektauswahl zu überprüfen, ob Issues und Merge Requests in jedem Status sowie jede Ergebnisseite erfasst werden. Überprüfe außerdem die Filter der Notion-Ansicht.

Das Dashboard ist leer

Bitte Notion AI, die Quelldatenbanken, deren letzte Synchronisierungsergebnisse und Projektverknüpfungen zu überprüfen, bevor du das Dashboard neu erstellst. Ein Dashboard kann leer sein, während der erste Import noch läuft.

Ich sehe doppelte Datenbanken

Bitte Notion AI, den bestehenden Worker, die Datenbank-URLs und die Seitenstruktur zu überprüfen, bevor du etwas anderes erstellst. Die Fähigkeit erfordert fünf tatsächlich synchronisierte Datenbanken und ein Dashboard unter GitLab Sync. Lass Notion AI alle Duplikate identifizieren, bevor du diese entfernst.

Alle Updates wurden gestoppt

Bitte Notion AI, die letzten Ausführungen des Workers, den Token-Ablauf, die Token-Berechtigungen und den Zugriff auf jedes ausgewählte Projekt zu überprüfen. Überprüfe bei einer selbstverwalteten Instanz auch den konfigurierten GitLab-Host. Anforderungslimits können Aktualisierungen verzögern.


Feedback geben

War diese Ressource hilfreich?


Powered by Fruition