GitLab verbinden met Notion
GitLab helpt teams code beheren, samenwerken aan softwareontwikkeling en releases volgen. Je kunt GitLab-projecten, issues, merge requests, pipelines en releases synchroniseren naar Notion, zodat ontwikkelwerk bij de plannen en docs van je team staat.
We vervangen bestaande beheerde GitLab-synchronisaties door aangepaste synchronisaties die worden aangedreven door Notion Workers. Je kunt aanpassen welke gegevens je synchroniseert en hoe deze in Notion worden georganiseerd. Je bestaande gesynchroniseerde gegevens blijven in Notion staan; volg deze handleiding om een vervanging in te stellen. Lees meer over Notion Workers →
Bestaande GitLab-synchronisaties stoppen met werken op 30 oktober 2026. Ze blijven tot die tijd normaal werken, maar worden niet automatisch overgezet. We raden aan om vóór die datum je vervangende synchronisatie in te stellen.
Workers voeren je synchronisatie uit op de infrastructuur van Notion. Om je vervanging in te stellen, @-vermelding je je bestaande gesynchroniseerde database in een chat met Notion AI en voeg je de GitLab sync skill toe.
Zorg dat je het volgende bij de hand hebt:
Je bestaande GitLab-gesynchroniseerde database in Notion. Zorg ervoor dat Notion AI er toegang toe heeft.
De volledige lijst met GitLab-projecten die moeten worden opgenomen. Je kunt project-URL's, numerieke ID's of paden opgeven, zoals my-team/my-project. Leer hoe je projecten in GitLab kunt weergeven →
Een persoonlijk of project-toegangstoken voor GitLab met read_api en toegang tot elk geselecteerd project.
Toegang tot Workers en de tools die Notion AI nodig heeft om een worker in je werkruimte te maken en te implementeren.
Deze skill-pagina, die je naar je Notion-account kopieert: GitLab Handleiding: Worker Sync. Deze skill is voor GitLab.com. Als je een zelfbeheerde GitLab-instantie gebruikt, vertel dit dan aan Notion AI vóór de installatie. Het API-adres en de configuratie van inloggegevens van de handleiding moeten worden aangepast en gevalideerd voor jouw instantie.
Opmerking: Deze handleiding maakt vervangende databases aan. Je bestaande database blijft beschikbaar terwijl je ze controleert. De paginalinks, weergaven, relaties en informatie die alleen in Notion staan, worden niet automatisch overgedragen.
Open een chat met Notion AI in de werkruimte die je bestaande gesynchroniseerde database bevat.
Kopieer de onderstaande prompt. Vervang @Existing GitLab sync database door @ te typen en de daadwerkelijke database te selecteren uit het vermeldingenmenu. Als issues en merge requests in afzonderlijke gesynchroniseerde databases staan, vermeld dan beide.
Vervang mijn huidige GitLab-synchronisatie, @Existing GitLab sync database, door een Notion worker met behulp van de GitLab Handleiding: Worker Sync.
Inspecteer de bestaande database en bevestig de volledige lijst met GitLab-projecten met mij. Volg de skill om de uurlijkse synchronisaties, vijf gerelateerde databases, weergaven en het dashboard aan te maken onder een Privé GitLab Sync-pagina. Als er al een vervangende worker bestaat, inspecteer deze dan en hergebruik deze waar nodig.
Houd mijn bestaande database intact. Identificeer aangepaste eigenschappen, waarden die alleen in Notion staan, weergaven, relaties en koppelingen die afzonderlijk moeten worden afgehandeld. Vraag mijn GitLab-token aan via een beveiligde invoer voor inloggegevens, niet in de chat.
Bekijk een voorbeeld van elk geselecteerd project en gegevenstype, voltooi de eerste synchronisatie en controleer records en projectrelaties. Laat me de vervangende databases, eventuele verschillen en de stappen om over te schakelen zien voordat je de oude synchronisatie wijzigt.
Selecteer een daadwerkelijke databasevermelding in de prompt. Alleen de naam van de database typen geeft Notion AI geen koppeling om te inspecteren.
Bevestig de volledige projectlijst, inclusief projecten die verborgen zijn door de filters van je huidige Notion-weergave. Een token dat beperkt is tot één project is niet voldoende voor een synchronisatie die ook toegang nodig heeft tot andere projecten.
Volg de instructies van Notion AI om je GitLab-token op te geven via de beveiligde invoer voor inloggegevens. Het heeft read_api en toegang tot de geselecteerde projecten nodig.
Plak het token niet in de chat, een Notion-pagina of een database-eigenschap. De worker gebruikt een brokered credential, dus de code hoeft het onbewerkte token niet te lezen.
Deze configuratie gebruikt een nieuw worker-credential. Je bestaande GitLab-verbinding levert dit niet automatisch.
Als Notion AI geen toegang heeft tot de skill of de worker-tools, los die toegang dan eerst op. De gekoppelde handleiding bevat ook installatie-instructies voor iemand in je team die de Notion CLI kan gebruiken.
De skill maakt een privé GitLab-synchronisatie-pagina aan met vijf gesynchroniseerde databases en een dashboard:
Database | Wat het bevat |
|---|---|
GitLab-projecten | Projectnamen, paden, beschrijvingen, archiefstatus, zichtbaarheid, standaardbranches, links en activiteitsdatums. |
GitLab-issues | Issues in verschillende statussen, met toegewezen personen, labels, mijlpalen, ernst, vervaldatums en projectrelaties. |
GitLab Merge Requests | Merge requests in verschillende statussen, met conceptstatus, auteurs, toegewezen personen, branches, merge-status en projectrelaties. |
GitLab Pipelines | pipeline-status, referenties, bron, datums, links en projectrelaties. |
GitLab Releases | Releasenamen, tags, beschrijvingen, releasedatums, links en projectrelaties. |
GitLab Dashboard brengt deze records samen in diagrammen en werklijsten. Het bevat open issues, open merge requests, mislukte pipelines, recente releases en projectactiviteit.
De vijf gesynchroniseerde databases bevatten de records. Het dashboard toont weergaven van die records. Je oude database voor issues of merge requests bevatte mogelijk minder gegevenstypen dan de /standaard setup van deze skill.
Controleer deze verschillen voordat je overschakelt:
Personen en labels: Auteurs, toegewezen personen en labels worden in deze handleiding als tekst opgeslagen. Het zijn geen Notion-persoons- of eigenschappen voor meerdere selecteren.
Projectrelaties: Issues, merge requests, pipelines en releases moeten linken naar hun geselecteerde projectrecords.
Recordidentiteit: Records uit verschillende projecten moeten afzonderlijk blijven, zelfs wanneer ze hetzelfde project-lokale issue- of merge request-nummer gebruiken.
Aanvullende inhoud: De handleiding synchroniseert geen issue-opmerkingen, discussies over merge requests, repository-bestanden of job-logs. Vraag Notion AI om eventuele extra velden te beoordelen die je bestaande workflow nodig heeft.
Wacht tot Notion AI bevestigt dat alle vijf synchronisaties in orde zijn en dat de initiële import is voltooid.
Vergelijk elk geselecteerd project met GitLab. Controleer een steekproef van open en gesloten issues, merge requests, pipelines en releases.
Bevestig dat projectrelaties en dashboard-weergaven de verwachte records tonen.
Controleer of een recente GitLab-wijziging de vervanger bereikt na een succesvolle verversing.
Bekijk de aangepaste eigenschappen en Notion-only waarden van de oude database met Notion AI. Breng over wat je nodig hebt met behulp van stabiele GitLab-record-ID's.
Update links, gekoppelde databaseweergaven, relaties en Automatiseringen die de vervanger moeten gebruiken. Controleer de machtigingen voor delen van de nieuwe pagina.
Zodra je team de vervanger gebruikt, kun je Notion AI vragen om te helpen bij het buiten gebruik stellen van de oude synchronisatie, terwijl de oude database beschikbaar blijft voor naslag.
Je hoeft de oude database niet te verwijderen om de worker te gebruiken. Bewaar deze totdat je hebt gecontroleerd of de informatie en workflows van je team zijn verwerkt.
De skill stelt vijf synchronisaties per uur in, één voor elk datatype. Projecten worden als eerste gesynchroniseerd tijdens de configuratie, zodat de andere databases hun records aan de juiste projecten kunnen relateren.
Elke succesvolle verversing leest alle resultaatpagina's voor de geconfigureerde projecten en werkt de bijbehorende Notion database bij. De worker blijft uitvoeren wanneer Notion is gesloten.
Updates stromen van GitLab naar Notion. Breng wijzigingen aan in gesynchroniseerde waarden in GitLab; wijzigingen in Notion worden niet teruggeschreven.
Het schema is per uur, geen garantie dat elke verversing binnen een vaste tijd is voltooid. Grote projectgeschiedenissen en GitLab-verzoeklimieten kunnen de voltooiing vertragen.
Tip: Behoud de volledige projectlijst. Deze synchronisaties gebruiken de vervangingsmodus: records die ontbreken na een voltooide verversing worden verwijderd uit de gesynchroniseerde database. Het verwijderen van een project uit de configuratie kan de gesynchroniseerde records ervan verwijderen, inclusief informatie op die pagina's die alleen in Notion staat. Vraag Notion AI om elk geselecteerd project en elk gegevenstype te bekijken voordat je een wijziging doorvoert.
De Skill begint met een Privé GitLab Sync-pagina. Deel deze alleen met de mensen die de geïmporteerde records moeten zien.
De machtigingen van Notion bepalen de toegang tot de gesynchroniseerde gegevens. De Visibility-eigenschap van een GitLab-project of de Confidential-eigenschap van een issue dwingt die bronmachtiging niet af in Notion. Controleer de gegevens die door het token worden opgenomen voordat je de pagina deelt.
Een project ontbreekt
Bevestig de volledige projectlijst en tokentoegang. Geef Notion AI de URL of het numerieke ID van het project als het pad is gewijzigd. Voer geen verversing uit met een verkorte lijst om een toegangsfout te omzeilen.
Een issue of merge request ontbreekt
Vraag Notion AI om de projectselectie te controleren, of het issues en merge requests in elke status controleert, en elke pagina met resultaten. Controleer ook de filters van de Notion-weergave.
Het dashboard is leeg
Vraag Notion AI om de brondatabases, hun laatste synchronisatieresultaten en projectrelaties te controleren voordat je het dashboard opnieuw opbouwt. Een dashboard kan leeg zijn terwijl de initiële Importeren nog bezig is.
Ik zie /dupliceren databases
Vraag Notion AI om de bestaande worker, database-URL's en paginastructuur te inspecteren voordat je iets anders aanmaakt. De Skill vereist vijf daadwerkelijk gesynchroniseerde databases en één dashboard onder GitLab Sync. Laat Notion AI eventuele /dupliceren identificeren voordat je ze verwijdert.
Updates zijn gestopt
Vraag Notion AI om de laatste uitvoeringen van de worker, het verlopen van tokens, tokenmachtigingen en de toegang tot elk geselecteerd project te controleren. Controleer bij een zelfbeheerde instantie ook de geconfigureerde GitLab-host. Verzoeklimieten kunnen updates vertragen.
