Conectar o GitLab ao Notion
O GitLab ajuda equipes a gerenciar código, colaborar no desenvolvimento e acompanhar lançamentos. Sincronize projetos, issues, merge requests, pipelines e lançamentos do GitLab no Notion para manter o desenvolvimento junto aos planos e docs da equipe.
Estamos substituindo as sincronizações gerenciadas do GitLab existentes por sincronizações personalizadas alimentadas pelos Workers do Notion. Você pode personalizar quais dados sincronizar e como eles são organizados no Notion. Seus dados sincronizados existentes permanecem no Notion; siga este guia para configurar uma substituição. Saiba mais sobre Workers do Notion →
As sincronizações do GitLab existentes pararão de funcionar em 30 de outubro de 2026. Elas continuarão funcionando normalmente até lá, mas não serão migradas automaticamente. Recomendamos configurar sua sincronização de substituição antes dessa data.
Os Workers executam sua sincronização na infraestrutura do Notion. Para configurar sua substituição, faça uma @-menção ao seu banco de dados sincronizado existente em um chat com o Notion AI e inclua a skill de sincronização do GitLab.
Tenha estes itens prontos:
Sua Base de dados sincronizada do GitLab no Notion. Certifique-se de que o Notion AI possa acessá-la.
A lista completa de projetos do GitLab a serem incluídos. Você pode fornecer URLs de projetos, IDs numéricos ou caminhos como my-team/my-project. Saiba como visualizar projetos no GitLab →
Um token de acesso pessoal ou de projeto do GitLab com read_api e acesso a todos os projetos selecionados.
Acesso aos Workers e às ferramentas que o Notion AI precisa para criar e implantar um Worker em seu espaço de trabalho.
Esta página de skill, que você copiará para sua conta do Notion: GitLab Guide: Worker Sync. Esta skill é para GitLab.com. Se você usa uma instância do GitLab autogerenciada, informe ao Notion AI antes da configuração. O endereço da API e a configuração de credenciais do guia precisam de adaptação e validação para sua instância.
Observação: Este guia cria bases de dados de substituição. Sua base de dados existente permanece disponível enquanto você as verifica. Seus links de página, visualizações, relações e informações exclusivas do Notion não são transferidas automaticamente.
Abra um chat com o Notion AI no espaço de trabalho que contém sua Base de dados sincronizada existente.
Copie o prompt abaixo. Substitua @Existing GitLab sync database digitando @ e selecionando o banco de dados real no menu de menções. Se os issues e merge requests estiverem em bancos de dados sincronizados separados, mencione ambos.
Substitua minha sincronização atual do GitLab, @Existing GitLab sync database, por um Worker do Notion usando o GitLab Guide: Worker Sync.
Inspecione a base de dados existente e confirme a lista completa de projetos do GitLab comigo. Siga a skill para criar as sincronizações horárias, cinco bases de dados relacionadas, visualizações e um painel de controle em uma página privada de Sincronização do GitLab. Se um Worker de substituição já existir, inspecione-o e reutilize-o quando apropriado.
Mantenha minha base de dados existente intacta. Identifique propriedades personalizadas, valores exclusivos do Notion, visualizações, relações e links que precisam de tratamento separado. Solicite meu token do GitLab por meio de uma entrada segura de credenciais, não no chat.
Visualize cada projeto e tipo de dado selecionado, conclua a primeira sincronização e verifique os registros e as relações dos projetos. Mostre-me as bases de dados de substituição, quaisquer diferenças e os passos para realizar a troca antes de alterar a sincronização antiga.
Selecione uma menção de base de dados real no prompt. Digitar apenas o nome da base de dados não fornece ao Notion AI um link para inspeção.
Confirme a lista completa de projetos, incluindo projetos ocultos pelos filtros da sua visualização atual no Notion. Um token limitado a um projeto não será suficiente para uma sincronização que também precisa de acesso a outros projetos.
Siga as instruções do Notion AI para fornecer seu token do GitLab por meio de uma entrada segura de credenciais. Ele precisa de read_api e acesso aos projetos selecionados.
Não cole o token no chat, em uma página do Notion ou em uma propriedade da base de dados. O Worker usa credenciais intermediadas, portanto, seu código não precisa ler o token bruto.
Esta configuração usa novas credenciais de Worker. Sua conexão existente com o GitLab não as fornece automaticamente.
Se o Notion AI não conseguir acessar a skill ou as ferramentas do Worker, resolva esse acesso primeiro. O guia vinculado também contém instruções de configuração para alguém da sua equipe que possa usar a Notion CLI.
A skill cria uma página privada GitLab Sync contendo cinco bases de dados sincronizadas e um painel de controle:
Base de dados | O que inclui |
|---|---|
Projetos do GitLab | Nomes de projeto, rotas, descrições, status de arquivo, visibilidade, branches padrão, links e datas de atividade. |
Issues do GitLab | Issues em vários estados, com Responsáveis, rótulos, marcos, gravidade, Prazos e relações de projeto. |
GitLab Merge Requests | Merge requests em vários estados, com status de rascunho, autores, Responsáveis, branches, status de merge e relações de projeto. |
Pipelines do GitLab | Status de pipeline, referências, fonte, datas, links e relações de projeto. |
GitLab Releases | Nomes de lançamentos, tags, descrições, datas de lançamento, links e relações de projeto. |
O Painel de Controle do GitLab reúne esses registros em gráficos e filas de trabalho. Ele inclui issues abertos, merge requests abertos, pipelines com falha, lançamentos recentes e atividade do projeto.
As cinco bases de dados sincronizadas contêm os registros. O painel de controle exibe visualizações desses registros. Sua antiga base de dados de issues ou merge requests pode ter coberto menos tipos de dados do que a configuração padrão desta skill.
Verifique essas diferenças antes de mudar:
Pessoas e rótulos: Autores, Responsáveis e rótulos são armazenados como texto neste guia. Eles não são propriedades de pessoa ou de seleção múltipla do Notion.
Relações de projeto: Issues, merge requests, pipelines e lançamentos devem estar vinculados aos registros dos respectivos projetos selecionados.
Identidade do registro: Registros de projetos diferentes devem permanecer distintos, mesmo quando utilizam o mesmo número de issue ou merge request local do projeto.
Conteúdo adicional: O guia não sincroniza /comentário de issues, discussões de merge requests, arquivos de repositório ou registros de trabalho. Peça ao Notion AI para avaliar quaisquer campos extras que seu fluxo de trabalho existente precise.
Aguarde até que o Notion AI confirme que todas as cinco sincronizações estão saudáveis e que a importação inicial foi concluída.
Compare cada projeto selecionado com o GitLab. Verifique uma amostra de issues abertas e fechadas, merge requests, pipelines e lançamentos.
Confirme se as relações de projeto e as visualizações do painel mostram os registros esperados.
Verifique se uma alteração recente no GitLab chega à substituição após uma atualização bem-sucedida.
Revise as propriedades personalizadas da base de dados antiga e os valores exclusivos do Notion com a IA do Notion. Transfira o que você precisa usando IDs de registro estáveis do GitLab.
Atualize links, visualizações de base de dados vinculada, relações e automações que devem usar a substituição. Revise as autorizações de compartilhamento da nova página.
Assim que sua equipe estiver usando a substituição, peça à IA do Notion para ajudar a desativar a sincronização antiga, mantendo a base de dados antiga disponível para referência.
Você não precisa excluir a base de dados antiga para usar o Worker. Mantenha-a até verificar se as informações e os Fluxos de Trabalho da sua equipe foram contabilizados.
A skill configura cinco sincronizações por hora, uma para cada tipo de dado. Os projetos são sincronizados primeiro durante a configuração para que as outras bases de dados possam relacionar seus registros aos projetos corretos.
Cada atualização bem-sucedida lê todas as páginas de resultados dos projetos configurados e atualiza a base de dados do Notion correspondente. O Worker continua sendo executado quando o Notion está fechado.
As atualizações fluem do GitLab para o Notion. Faça alterações nos valores sincronizados no GitLab; as alterações no Notion não são gravadas de volta.
Por hora é o agendamento, não uma garantia de que cada atualização termine dentro de um tempo fixo. Históricos de projetos grandes e limites de solicitação do GitLab podem atrasar a conclusão.
Dica: Mantenha a lista completa de projetos. Essas sincronizações usam o modo de substituição: registros ausentes de uma atualização concluída são removidos da base de dados sincronizada. Remover um projeto da configuração pode remover seus registros sincronizados, incluindo informações exclusivas do Notion nessas páginas. Peça ao Notion AI para visualizar cada projeto e tipo de dados selecionado antes de aplicar uma alteração.
A skill começa com uma página privada GitLab Sync. Compartilhe-a apenas com as pessoas que devem ver os registros importados.
As permissões do Notion controlam o acesso aos dados sincronizados. A propriedade Visibility de um projeto do GitLab ou a propriedade Confidential de um problema não impõe essa permissão de origem no Notion. Revise os dados incluídos pelo token antes de compartilhar a página.
Confirme a lista completa de projetos e o acesso ao token. Forneça ao Notion AI a URL ou o ID numérico do projeto caso o caminho tenha mudado. Não execute uma atualização com uma lista reduzida apenas para contornar um erro de acesso.
Peça ao Notion AI para verificar a seleção de projetos, se ele está verificando problemas e solicitações de merge em todos os estados e em todas as páginas de resultados. Verifique também os filtros da visualização do Notion.
Peça ao Notion AI para verificar as bases de dados de origem, seus resultados de sincronização mais recentes e as relações de projeto antes de reconstruir o painel. Um painel pode ficar vazio enquanto a importação inicial ainda está em execução.
Peça ao Notion AI para inspecionar o Worker existente, as URLs das bases de dados e a estrutura da página antes de criar qualquer outra coisa. A habilidade requer cinco bases de dados sincronizadas reais e um painel de controle em GitLab Sync. Peça ao Notion AI para identificar quaisquer duplicatas antes de removê-las.
Peça ao Notion AI para verificar as execuções mais recentes do Worker, a expiração do token, as autorizações do token e o acesso a cada projeto selecionado. Para uma instância autogerenciada, verifique também o anfitrião do GitLab configurado. Limites de solicitação podem atrasar todas as atualizações.
