GitLab in ChatGPT e Codex è attualmente in versione beta.
Panoramica
Usa il modello di app GitLab Self-Managed per creare una bozza di app specifica per l’area di lavoro, da usare con un’istanza GitLab Self-Managed o GitLab Dedicated. Fornisci il nome host di GitLab e le credenziali dell’applicazione OAuth, verifica la bozza dell’app e poi pubblicala per i membri dell’area di lavoro idonei. Dopo la pubblicazione, le azioni abilitate dell’app sono disponibili nelle conversazioni di ChatGPT e nelle sessioni di Codex.
Per una panoramica delle funzionalità GitLab supportate, della disponibilità, delle autorizzazioni, dell’uso dei dati e dei requisiti di rete, consulta: Collegare GitLab a ChatGPT e Codex.
Cosa stai configurando
Stai creando un’app specifica per l’area di lavoro a partire dal modello di app GitLab Self-Managed. L’app usa:
Un’applicazione OAuth di GitLab registrata sul tuo host GitLab Self-Managed o GitLab Dedicated.
L’ID applicazione e il Segreto OAuth di GitLab per l’autorizzazione degli utenti.
Gli ambiti OAuth richiesti: api, write_repository e openid.
Il tuo nome host di GitLab, ad esempio gitlab.example.com, per ricavare gli endpoint web, API, di autorizzazione e dei token.
Prima di iniziare
Ti servono:
Accesso come amministratore o proprietario dell’area di lavoro ChatGPT.
Autorizzazioni GitLab per creare l’applicazione OAuth: accesso come Proprietario del gruppo per un’app di proprietà di un gruppo, o come amministratore dell’istanza per un’app a livello di istanza.
Solo il nome host di GitLab, senza https://, porta o percorso. Usa un host GitLab Self-Managed o GitLab Dedicated, non gitlab.com.
Una scelta delle azioni GitLab che ChatGPT e Codex dovranno supportare, ad esempio la ricerca nei repository, i flussi di lavoro per richieste di merge e issue, le modifiche ai file o flussi di lavoro Codex più ampi.
Tieni aperti ChatGPT e GitLab in schede separate. Copia l’URI di reindirizzamento esatto mostrato in ChatGPT; non crearlo né modificarlo.
Per aprire la pagina App dalla Console di amministrazione, seleziona l’area di lavoro ChatGPT desiderata, apri Plugin e seleziona Gestisci app legacy.
Valori da preparare
Nome host di GitLab: ad esempio, gitlab.example.com.
URI di reindirizzamento: copialo dalla procedura di configurazione del modello in ChatGPT.
ID applicazione OAuth di GitLab.
Segreto OAuth di GitLab.
Ambiti OAuth: copiali dalla procedura di configurazione del modello in ChatGPT.
Start the template setup in ChatGPT
In ChatGPT, switch to the workspace where the app should be available.
Go to Workspace settings > Apps.
In Directory, find GitLab, open its GitLab Self-Managed app template, and select Enable.
Enter a clear app name and description.
Enter the GitLab hostname, such as gitlab.example.com.
Copy the Redirect URI shown in ChatGPT, and keep this tab open.
Example: https://chatgpt.com/connector/oauth/<redirect_id>. Do not remove the redirect ID, add a trailing slash, or replace the URI with a generic ChatGPT URL.
Crea l’applicazione OAuth di GitLab in GitLab
Scegli dove creare l’applicazione
Apri il tuo host GitLab, ad esempio https://gitlab.example.com.
Scegli se creare un’applicazione a livello di istanza o di proprietà di un gruppo. Questa scelta determina chi gestisce l’applicazione; l’accesso ai progetti continua a dipendere dalle autorizzazioni GitLab dell’utente che autorizza l’applicazione e dagli ambiti OAuth concessi.
Per un’applicazione a livello di istanza, vai su Amministrazione > Applicazioni. Per un’applicazione di proprietà di un gruppo, vai su Impostazioni > Applicazioni del gruppo.
Aggiungi i dettagli dell’applicazione
Seleziona Nuova applicazione o Aggiungi nuova applicazione.
Inserisci un nome chiaro per l’app, ad esempio GitLab Self-Managed o GitLab Dedicated.
In URI di reindirizzamento, incolla l’URI esatto copiato da ChatGPT.
Mantieni abilitata l’opzione Riservata per questa applicazione OAuth lato server.
Configura l’accesso e salva
Per un’applicazione a livello di istanza, GitLab consiglia di selezionare Attendibile. In questo modo, all’utente non viene chiesto di autorizzare l’applicazione.
Seleziona gli ambiti api, write_repository e openid.
Controlla chi può gestire l’applicazione e verifica che gli utenti GitLab che la autorizzano dispongano delle autorizzazioni appropriate per gruppi e progetti.
Salva l’applicazione.
Requisiti degli ambiti OAuth
Il modello richiede i seguenti ambiti OAuth per le azioni GitLab abilitate in ChatGPT e Codex:
api: necessario per le operazioni API di GitLab esposte dall’app, incluse le azioni su richieste di merge, issue e CI/CD.
write_repository: necessario per le operazioni di scrittura nei repository tramite Git.
openid: necessario per le informazioni su identità e appartenenza tramite OpenID Connect.
Copia le credenziali OAuth di GitLab
Nell’applicazione GitLab salvata, copia l’ID applicazione e il Segreto. Tratta il Segreto come una credenziale. Se viene esposto, rinnovalo in GitLab e crea una nuova app per l’area di lavoro.
Completa la configurazione in ChatGPT
Torna alla scheda di configurazione del modello in ChatGPT.
Incolla l’ID applicazione di GitLab in ID client OAuth.
Incolla il Segreto di GitLab in Segreto client OAuth.
Verifica che il campo del nome host di GitLab contenga solo il nome host, ad esempio gitlab.example.com.
Seleziona Crea bozza.
Apri i dettagli della bozza dell’app e controlla Accesso per ruolo e Configura azioni.
Pubblica e gestisci l’app per ChatGPT e Codex
La creazione della bozza dell’app non la rende automaticamente disponibile ai membri. Dopo aver verificato la bozza:
Seleziona Pubblica per la bozza dell’app.
Vai alla Console di amministrazione, seleziona l’area di lavoro ChatGPT desiderata e apri Plugin, quindi verifica che GitLab sia disponibile per i ruoli previsti.
Controlla Accesso per ruolo per i ruoli che devono usare l’app.
In Configura azioni, controlla le azioni di lettura e scrittura disponibili.
In Configura approvazioni, scegli quando gli utenti devono approvare un’azione prima che ChatGPT o Codex usi l’app.
Chiedi a un utente di prova con accesso di aprire GitLab dalla Directory dei plugin o da Impostazioni > Plugin. Verifica che l’utente possa installare il plugin e collegarsi all’app creata dal modello GitLab Self-Managed.
Queste impostazioni di approvazione dell’app si applicano alle conversazioni di ChatGPT e ai thread di Codex.
Configura l’attività GitLab per la revisione del codice con Codex
Dopo aver pubblicato l’app, configura l’attività GitLab in Codex se prevedi di usare Codex per la revisione del codice. Questa configurazione dell’attività imposta gli eventi webhook necessari.
Apri le impostazioni dei connettori di Codex.
Configura un account di servizio per l’area di lavoro. Lascia che Codex crei l’account oppure fornisci un token di accesso personale per un account di servizio esistente.
Abilita Attività GitLab per il progetto o per uno dei suoi gruppi padre.
Se Codex deve eseguire attività di programmazione o usare una configurazione specifica del progetto, crea un ambiente di progetto.
L’app GitLab usa OAuth dell’utente per le letture e le azioni abilitate in ChatGPT e Codex. Per le operazioni di scrittura delle revisioni di Codex su GitLab Self-Managed o GitLab Dedicated, il token dell’account di servizio gestito dall’area di lavoro determina con quale identità e in quali progetti Codex può commentare o aggiungere reazioni.
Per saperne di più: Rivedere le richieste di merge di GitLab con Codex.
Collega e testa l’app GitLab
Come utente con accesso, apri GitLab dalla Directory dei plugin o da Impostazioni > Plugin. Seleziona Installa plugin, quindi seleziona Collega.
Se nella tua area di lavoro sono presenti più app GitLab, scegli quella per questo host GitLab Self-Managed o GitLab Dedicated.
Quando richiesto, autorizza l’applicazione OAuth di GitLab.
Esegui prima una semplice azione di lettura in ChatGPT o Codex, ad esempio elencare i progetti accessibili o recuperare una richiesta di merge nota.
Se le azioni di scrittura sono abilitate, testale in un progetto a basso rischio e in ogni prodotto in cui prevedi di usarle, prima di estenderne l’utilizzo.
Nome host e funzionamento di OAuth
L’app usa il nome host per ricavare gli endpoint di GitLab. Inserisci solo l’host, ad esempio gitlab.example.com. Non includere https://, un percorso API o di un repository, una porta o gitlab.com. Questo modello è destinato a GitLab Self-Managed o GitLab Dedicated. Per GitLab.com (SaaS), usa l’app GitLab.
Risoluzione dei problemi di configurazione dell’app GitLab Self-Managed
L’URI di reindirizzamento non corrisponde: verifica che l’URI di reindirizzamento dell’applicazione OAuth di GitLab corrisponda esattamente a quello mostrato in ChatGPT.
ChatGPT non riesce a creare o salvare la bozza dell’app: verifica che siano presenti il nome host, l’ID applicazione, il segreto e l’URI di reindirizzamento.
L’autenticazione riesce, ma le chiamate al progetto non vanno a buon fine: verifica che l’utente GitLab che autorizza l’applicazione possa accedere al progetto e che l’applicazione OAuth disponga degli ambiti previsti dal modello.
L’API restituisce 403 o segnala autorizzazioni insufficienti: verifica che l’account GitLab collegato disponga delle autorizzazioni necessarie per il progetto o il gruppo e che l’applicazione OAuth includa gli ambiti richiesti dal modello.
Nessun progetto è accessibile: verifica che l’utente abbia accesso ai progetti, sia collegato all’istanza GitLab desiderata e abbia selezionato l’app GitLab corretta in ChatGPT o Codex.