Collega GitLab a Notion
GitLab aiuta i team a gestire il codice, collaborare allo sviluppo software e tracciare le release. Puoi sincronizzare in Notion progetti, issue, merge request, pipeline e release di GitLab per tenere il lavoro di sviluppo con piani e documenti del team.
Stiamo sostituendo le sincronizzazioni GitLab gestite esistenti con sincronizzazioni su misura basate sui Worker di Notion. Puoi personalizzare i dati da sincronizzare e il modo in cui vengono organizzati in Notion. I tuoi dati sincronizzati esistenti rimangono in Notion; segui questa guida per configurare una sostituzione. Scopri di più sui Worker di Notion →
Le sincronizzazioni GitLab esistenti smetteranno di funzionare il 30 ottobre 2026. Continueranno a funzionare normalmente fino ad allora, ma non verranno trasferite automaticamente. Ti consigliamo di configurare la sincronizzazione sostitutiva prima di tale data.
I worker eseguono la tua sincronizzazione sull'infrastruttura di Notion. Per configurare la tua sostituzione, @-menziona il tuo database sincronizzato esistente in una chat con Notion AI e includi la skill di sincronizzazione GitLab.
Tieni pronti questi elementi:
Il tuo database sincronizzato GitLab esistente in Notion. Assicurati che Notion AI possa accedervi.
L'elenco completo dei progetti GitLab da includere. Puoi fornire URL di progetto, ID numerici o percorsi come my-team/my-project. Scopri come visualizzare i progetti in GitLab →
Un token di accesso personale o di progetto GitLab con read_api e accesso a ogni progetto selezionato.
Accesso ai worker e agli strumenti di cui Notion AI ha bisogno per creare e distribuire un worker nel tuo spazio di lavoro.
Questa pagina della skill, che copierai nel tuo account Notion: GitLab Guide: Worker Sync. Questa skill è per GitLab.com. Se utilizzi un'istanza GitLab autogestita, comunicalo a Notion AI prima della configurazione. L'indirizzo API e la configurazione delle credenziali della guida necessitano di adattamento e convalida per la tua istanza.
Nota: questa guida crea database sostitutivi. Il tuo database esistente rimane disponibile mentre lo controlli. I collegamenti alle pagine, le viste, le relazioni e le informazioni presenti solo in Notion non vengono trasferiti automaticamente.
Apri una chat con Notion AI nello spazio di lavoro che contiene il tuo database sincronizzato esistente.
Copia il prompt qui sotto. Sostituisci @Existing GitLab sync database digitando @ e selezionando il database effettivo dal menu delle menzioni. Se le issue e le merge request si trovano in database sincronizzati separati, menzionale entrambi.
Sostituisci la mia attuale sincronizzazione GitLab, @Existing GitLab sync database, con un worker di Notion utilizzando la GitLab Guide: Worker Sync.
Esamina il database esistente e conferma con me l'elenco completo dei progetti GitLab. Segui la skill per creare le sincronizzazioni orarie, cinque database correlati, le visualizzazioni e la dashboard in una pagina privata GitLab Sync. Se esiste già un worker sostitutivo, esaminalo e riutilizzalo ove appropriato.
Mantieni intatto il mio database esistente. Identifica le proprietà personalizzate, i valori solo Notion, le visualizzazioni, le relazioni e i collegamenti che richiedono una gestione separata. Richiedi il mio token GitLab tramite un input di credenziali sicuro, non in chat.
Visualizza in anteprima ogni progetto e tipo di dati selezionati, completa la prima sincronizzazione e controlla i record e le relazioni dei progetti. Mostrami i database sostitutivi, eventuali differenze e i passaggi per effettuare il passaggio prima di modificare la vecchia sincronizzazione.
Seleziona una menzione effettiva del database nel prompt. Digitare solo il nome del database non fornisce a Notion AI un link da esaminare.
Conferma l'elenco completo dei progetti, inclusi i progetti nascosti dai filtri della tua vista Notion attuale. Un token limitato a un solo progetto non sarà sufficiente per una sincronizzazione che richiede anche l'accesso ad altri progetti.
Segui le istruzioni di Notion AI per fornire il tuo token GitLab tramite l'input di credenziali sicuro. Deve avere read_api e l'accesso ai progetti selezionati.
Non incollare il token nella chat, in una pagina Notion o in una proprietà del database. Il worker utilizza una credenziale mediata, quindi il suo codice non ha bisogno di leggere il token non elaborato.
Questa configurazione utilizza una nuova credenziale worker. La tua connessione GitLab esistente non la fornisce automaticamente.
Se Notion AI non riesce ad accedere alla skill o agli strumenti worker, risolvi prima tale accesso. La guida collegata contiene anche le istruzioni di configurazione per qualcuno del tuo team che può utilizzare la CLI di Notion.
La skill crea una pagina privata GitLab Sync contenente cinque database sincronizzati e una dashboard:
Database | Cosa include |
|---|---|
Progetti GitLab | Nomi dei progetti, percorsi, descrizioni, stato di archiviazione, visibilità, branch predefiniti, link e date delle attività. |
Issue GitLab | Issue in vari stati, con assegnatari, etichette, milestone, gravità, date di scadenza e relazioni di progetto. |
Merge request GitLab | Merge request in vari stati, con stato di bozza, autori, assegnatari, branch, stato di merge e relazioni di progetto. |
Pipeline GitLab | Stato della pipeline, riferimenti, fonte, date, link e relazioni di progetto. |
Release GitLab | Nomi delle release, tag, descrizioni, date di rilascio, link e relazioni di progetto. |
GitLab Dashboard riunisce questi record in grafici e code di lavoro. Include issue aperte, merge request aperte, pipeline non riuscite, release recenti e attività di progetto.
I cinque database sincronizzati contengono i record. La dashboard visualizza le viste di tali record. Il tuo vecchio database di issue o merge request potrebbe aver coperto meno tipi di dati rispetto alla configurazione predefinita di questa skill.
Controlla queste differenze prima di passare:
Persone ed etichette: Autori, assegnatari ed etichette sono archiviati come testo in questa guida. Non sono proprietà di tipo persona o selezione multipla di Notion.
Relazioni tra progetti: Le issue, le merge request, le pipeline e le release devono essere collegate ai rispettivi record dei progetti selezionati.
Identità del record: I record di progetti diversi devono rimanere distinti anche quando utilizzano lo stesso numero di issue o di merge request locale al progetto.
Contenuto aggiuntivo: La guida non sincronizza i commenti alle issue, le conversazioni sulle merge request, i file del repository o i log dei job. Chiedi a Notion AI di valutare eventuali campi extra necessari al tuo flusso di lavoro esistente.
Attendi che Notion AI confermi che tutte e cinque le sincronizzazioni siano integre e che l'importazione iniziale sia completa.
Confronta ogni progetto selezionato con GitLab. Controlla un campione di issue aperte e chiuse, merge request, pipeline e release.
Conferma che le relazioni dei progetti e le viste della dashboard mostrino i record previsti.
Verifica che una recente modifica di GitLab arrivi alla sostituzione dopo un aggiornamento riuscito.
Esamina le proprietà personalizzate del vecchio database e i valori esclusivi di Notion con Notion AI. Trasferisci ciò di cui hai bisogno utilizzando gli ID di record stabili di GitLab.
Aggiorna i collegamenti, le viste del database collegato, le relazioni e le automazioni che dovrebbero utilizzare la sostituzione. Esamina i permessi di condivisione della nuova pagina.
Una volta che il tuo team sta utilizzando la sostituzione, chiedi a Notion AI di aiutarti a dismettere la vecchia sincronizzazione, mantenendo il vecchio database disponibile per riferimento.
Non è necessario eliminare il vecchio database per utilizzare il worker. Conservalo finché non avrai verificato che le informazioni e i workflow del tuo team siano stati presi in considerazione.
La skill configura cinque sincronizzazioni orarie, una per ogni tipo di dati. I progetti si sincronizzano per primi durante la configurazione, in modo che gli altri database possano collegare i loro record ai progetti corretti.
Ogni aggiornamento riuscito legge tutte le pagine dei risultati per i progetti configurati e aggiorna il database Notion corrispondente. Il Worker continua a funzionare quando Notion è chiuso.
Gli aggiornamenti fluiscono da GitLab a Notion. Apporta le modifiche ai valori sincronizzati in GitLab; le modifiche in Notion non vengono riscritte.
La frequenza prevede aggiornamenti orari, ma ciò non garantisce che ogni aggiornamento termini entro un tempo fisso. Le cronologie dei progetti di grandi dimensioni e i limiti delle richieste di GitLab possono ritardare il completamento.
Suggerimento: Mantieni l'elenco completo dei progetti. Queste sincronizzazioni utilizzano la modalità di sostituzione: i record mancanti da un aggiornamento completato vengono rimossi dal database sincronizzato. La rimozione di un progetto dalla configurazione può comportare l'eliminazione dei relativi record sincronizzati, incluse le informazioni presenti solo su Notion in quelle pagine. Chiedi a Notion AI di visualizzare in anteprima ogni progetto e tipo di dati selezionato prima di applicare una modifica.
La skill inizia con una pagina privata GitLab Sync. Condividila solo con le persone che dovrebbero vedere i record importati.
Le autorizzazioni di Notion controllano l'accesso ai dati sincronizzati. La proprietà Visibility di un progetto GitLab o la proprietà Confidential di un problema non applicano tale autorizzazione di origine in Notion. Esamina i dati inclusi dal token prima di condividere la pagina.
Manca un progetto
Conferma l'elenco completo dei progetti e l'accesso al token. Fornisci a Notion AI l'URL o l'ID numerico del progetto se il suo percorso è cambiato. Non eseguire un aggiornamento con un elenco ridotto solo per aggirare un errore di accesso.
Manca un'issue o una merge request
Chiedi a Notion AI di controllare la selezione del progetto, se sta controllando issue e merge request in ogni stato e ogni pagina dei risultati. Controlla anche i filtri della visualizzazione di Notion.
La dashboard è vuota
Chiedi a Notion AI di controllare i database di origine, gli ultimi risultati di sincronizzazione e le relazioni tra i progetti prima di ricostruire la dashboard. Una dashboard può rimanere vuota mentre l'import iniziale è ancora in esecuzione.
Vedo database duplicati
Chiedi a Notion AI di ispezionare il Worker esistente, gli URL dei database e la struttura della pagina prima di creare altro. La skill prevede cinque database sincronizzati effettivi e una dashboard in GitLab Sync. Fai in modo che Notion AI identifichi eventuali duplicati prima di rimuoverli.
Gli aggiornamenti si sono interrotti
Chiedi a Notion AI di controllare le ultime esecuzioni del Worker, la scadenza del token, i permessi del token e l'accesso a ogni progetto selezionato. Per un'istanza autogestita, controlla anche l'host GitLab configurato. I limiti di chiamata possono ritardare gli aggiornamenti.
