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 skill 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 skill, que vous copierez dans votre compte Notion : GitLab Guide: Worker Sync. Cette skill 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 skill 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 skill 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 skill.
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 skill 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.
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.
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.
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.
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.
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.
