Connecter GitLab à Notion
GitLab aide les équipes à gérer le code, collaborer au développement logiciel et suivre les versions. Synchronisez projets, tickets, demandes de fusion, pipelines et versions GitLab dans Notion pour garder le dev avec les plans et docs de l’équipe.
Nous remplaçons les synchronisations GitLab gérées existantes par des synchronisations personnalisées optimisées par les Workers Notion. Vous pouvez personnaliser les données que vous synchronisez et la manière dont elles sont organisées dans Notion. Vos données synchronisées existantes restent dans Notion ; suivez ce guide pour configurer un remplacement. En savoir plus sur Notion Workers →
Les synchronisations GitLab existantes cesseront de fonctionner le 30 octobre 2026. Elles continueront de fonctionner normalement jusqu'à cette date, mais ne seront pas transférées automatiquement. Nous vous recommandons de configurer votre synchronisation de remplacement avant cette date.
Les Workers exécutent votre synchronisation sur l'infrastructure de Notion. Pour configurer votre remplacement, @mentionnez votre Base de donnée synchronisée existante dans une discussion avec Notion AI et incluez la compétence de synchronisation GitLab.
Préparez les éléments suivants :
Votre Base de donnée synchronisée GitLab existante dans Notion. Assurez-vous que Notion AI peut y accéder.
La liste complète des projets GitLab à inclure. Vous pouvez fournir des URL de projet, des identifiants numériques ou des chemins tels que my-team/my-project. Apprenez comment afficher les projets dans GitLab →
Un jeton d'accès personnel ou de projet GitLab avec read_api et un accès à chaque projet sélectionné.
L'accès aux Workers et aux outils dont Notion AI a besoin pour créer et déployer un Worker dans votre espace de travail.
Cette page de compétence, que vous copierez dans votre compte Notion : GitLab Guide: Worker Sync. Cette compétence est destinée à GitLab.com. Si vous utilisez une instance GitLab auto-hébergée, informez-en Notion AI avant la configuration. L'adresse API et la configuration des identifiants du guide nécessitent une adaptation et une validation pour votre instance.
Remarque : Ce guide crée des bases de données de remplacement. Votre base de données existante reste disponible pendant que vous la vérifiez. Ses liens de page, vues, relations et informations propres à Notion ne sont pas transférés automatiquement.
Ouvrez une discussion avec Notion AI dans l'espace de travail qui contient votre Base de donnée synchronisée existante.
Copiez l'instruction ci-dessous. Remplacez @Existing GitLab sync database en tapant @ et en sélectionnant la base de données réelle dans le menu de mention. Si les problèmes et les demandes de fusion se trouvent dans des bases de données synchronisées distinctes, mentionnez les deux.
Remplacez ma synchronisation GitLab actuelle, @Existing GitLab sync database, par un Worker Notion utilisant le GitLab Guide: Worker Sync.
Inspectez la base de données existante et confirmez avec moi la liste complète des projets GitLab. Suivez la compétence pour créer les synchronisations horaires, cinq bases de données associées, des vues et un tableau de bord sous une page privée GitLab Sync. Si un Worker de remplacement existe déjà, inspectez-le et réutilisez-le le cas échéant.
Gardez ma base de données existante intacte. Identifiez les propriétés personnalisées, les valeurs propres à Notion, les vues, les relations et les liens qui nécessitent un traitement séparé. Demandez mon jeton GitLab via une saisie d'identifiants sécurisée, pas dans le chat.
Prévisualisez chaque projet et type de données sélectionné, effectuez la première synchronisation et vérifiez les enregistrements et les relations de projet. Montrez-moi les bases de données de remplacement, les éventuelles différences et les étapes à suivre pour passer à la nouvelle synchronisation avant de modifier l'ancienne synchronisation.
Sélectionnez une mention de base de données réelle dans l'instruction. Taper uniquement le nom de la base de données ne fournit pas à Notion AI un lien à inspecter.
Confirmez la liste complète des projets, y compris les projets masqués par les filtres de votre vue Notion actuelle. Un jeton limité à un seul projet ne suffira pas pour une synchronisation qui nécessite également un accès à d'autres projets.
Suivez les instructions de Notion AI pour fournir votre jeton GitLab via la saisie d'identifiants sécurisée. Il nécessite read_api et un accès aux projets sélectionnés.
Ne collez pas le jeton dans le chat, sur une page Notion ou dans une propriété de base de données. Le Worker utilise des identifiants négociés, son code n’a donc pas besoin de lire le jeton brut.
Cette configuration utilise de nouveaux identifiants de Worker. Votre connexion GitLab existante ne les fournit pas automatiquement.
Si Notion AI ne peut pas accéder à la compétence ou aux outils du Worker, résolvez d’abord ce problème d’accès. Le guide lié contient également des instructions de configuration pour une personne de votre équipe capable d’utiliser la CLI de Notion.
La compétence crée une page privée GitLab Sync contenant cinq bases de données synchronisées et un dashboard :
Base de données | Ce qu’il inclut |
|---|---|
Projets GitLab | Noms des projets, chemins, descriptions, statut d’archivage, visibilité, branches par défaut, liens et dates d’activité. |
Problèmes GitLab | Problèmes dans tous les états, avec responsables, étiquettes, jalons, gravité, Date d’échéance et relations avec les projets. |
Demandes de fusion GitLab | Demandes de fusion dans tous les états, avec statut de brouillon, auteurs, responsables, branches, statut de fusion et relations avec les projets. |
Pipelines GitLab | Statut du pipeline, références, source, dates, liens et relations avec les projets. |
Versions GitLab | Noms des versions, balises, descriptions, dates de publication, liens et relations avec les projets. |
Dashboard GitLab rassemble ces enregistrements dans des graphiques et des files d’attente de travail. Il inclut les problèmes ouverts, les demandes de fusion ouvertes, les pipelines ayant échoué, les versions récentes et l’activité des projets.
Les cinq bases de données synchronisées contiennent les enregistrements. Le dashboard affiche des vues de ces enregistrements. Votre ancienne base de données de problèmes ou de demandes de fusion couvrait peut-être moins de types de données que la configuration par /défaut de cette compétence.
Vérifiez ces différences avant de changer :
Personnes et étiquettes : Les auteurs, les responsables et les étiquettes sont stockés sous forme de texte dans ce guide. Ce ne sont pas des propriétés de personne ou de sélection multiple Notion.
Relations de projet : Les problèmes, les demandes de fusion, les pipelines et les versions doivent être liés aux enregistrements de projet sélectionnés.
Identité de l'enregistrement : Les enregistrements provenant de différents projets doivent rester distincts même lorsqu'ils utilisent le même numéro de problème ou de demande de fusion local au projet.
Contenu supplémentaire : Le guide ne synchronise pas les commentaires sur les problèmes, les discussions sur les demandes de fusion, les fichiers de dépôt ou les journaux de travail. Demandez à Notion AI d'évaluer les champs supplémentaires dont votre flux de travail existant a besoin.
Attendez que Notion AI confirme que les cinq synchronisations sont saines et que l'importation initiale est terminée.
Comparez chaque projet sélectionné avec GitLab. Vérifiez un échantillon de problèmes ouverts et fermés, de demandes de fusion, de pipelines et de versions.
Confirmez que les relations de projet et les vues du tableau de bord affichent les enregistrements attendus.
Vérifiez qu'une modification récente de GitLab atteint le remplacement après une actualisation réussie.
Examinez les propriétés personnalisées de l'ancienne base de données et les valeurs propres à Notion avec Notion AI. Transférez ce dont vous avez besoin en utilisant les identifiants d'enregistrement GitLab stables.
Mettez à jour les liens, les vues de base de données liées, les relations et les automatisations qui doivent utiliser le remplacement. Vérifiez les autorisations de partage de la nouvelle page.
Une fois que votre équipe utilise le remplacement, demandez à Notion AI de vous aider à retirer l'ancienne synchronisation tout en conservant l'ancienne base de données disponible pour référence.
Vous n'avez pas besoin de supprimer l'ancienne base de données pour utiliser le Worker. Conservez-la jusqu'à ce que vous ayez vérifié que les informations et les flux de travail de votre équipe sont pris en compte.
La compétence configure cinq synchronisations horaires, une pour chaque type de données. Les projets se synchronisent en premier lors de la configuration afin que les autres bases de données puissent relier leurs enregistrements aux bons projets.
Chaque actualisation réussie lit toutes les pages de résultats pour les projets configurés et met à jour la base de données Notion correspondante. Le Worker continue de fonctionner lorsque Notion est fermé.
Les Dernières modifications circulent de GitLab vers Notion. Effectuez les modifications des valeurs synchronisées dans GitLab ; les modifications dans Notion ne sont pas réécrites.
La fréquence est horaire, ce qui ne garantit pas que chaque actualisation se termine dans un délai fixe. L'historique important des projets et les limites de requêtes de GitLab peuvent retarder l'achèvement.
Conseil : Conservez la liste complète des projets. Ces synchronisations utilisent le mode remplacement : les enregistrements absents d'une actualisation terminée sont supprimés de la base de données synchronisée. La suppression d'un projet de la configuration peut entraîner la suppression de ses enregistrements synchronisés, y compris les informations propres à Notion sur ces pages. Demandez à Notion AI de prévisualiser chaque projet et type de données sélectionnés avant d'appliquer une modification.
La compétence commence par une page située dans Pages privées GitLab Sync. Partagez-la uniquement avec les personnes qui doivent voir les enregistrements importés.
Les autorisations de Notion contrôlent l'accès aux données synchronisées. La propriété Visibilité d'un projet GitLab ou la propriété Confidentiel d'un problème n'applique pas cette autorisation source dans Notion. Vérifiez les données incluses par le jeton avant de partager la page.
Un projet est manquant
Confirmez la liste complète des projets et l'accès au jeton. Donnez à Notion AI l'URL ou l'ID numérique du projet si son parcours a changé. N'exécutez pas d'actualisation avec une liste raccourcie simplement pour contourner une erreur d'accès.
Il manque un problème ou une demande de fusion.
Demandez à Notion AI de vérifier la sélection du projet, s'il vérifie les problèmes et les demandes de fusion dans chaque état, ainsi que chaque page de résultats. Vérifiez également les filtres de la vue Notion.
Le tableau de bord est vide
Demandez à Notion AI de vérifier les bases de données sources, leurs derniers résultats de synchronisation et les relations de projet avant de reconstruire le tableau de bord. Un tableau de bord peut être vide alors que l'importation initiale est toujours en cours.
Je vois des bases de données en double
Demandez à Notion AI d'inspecter le Worker existant, les URL des bases de données et la structure des pages avant de créer quoi que ce soit d'autre. La compétence nécessite cinq bases de données synchronisées et un dashboard sous GitLab Sync. Demandez à Notion AI d'identifier les doublons avant de les supprimer.
Les Dernières modifications se sont arrêtées
Demandez à Notion AI de vérifier les dernières exécutions du Worker, l'expiration du jeton, les autorisations du jeton et l'accès à chaque projet sélectionné. Pour une instance autogérée, vérifiez également l'hôte GitLab configuré. Les limites de requêtes peuvent retarder les Dernières modifications.
