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 per un'istanza GitLab Self-Managed o GitLab Dedicated. Fornisci il nome host GitLab e le credenziali dell'applicazione OAuth, controlla la bozza dell'app e pubblicala per i membri idonei dell'area di lavoro. Dopo la pubblicazione, le azioni abilitate dell'app sono disponibili nelle conversazioni di ChatGPT e nelle sessioni di Codex.
Per una panoramica del funzionamento supportato di GitLab, della disponibilità, delle autorizzazioni, dell'uso dei dati e dei requisiti di rete, consulta: Connettere GitLab a ChatGPT e Codex.
Cosa stai configurando
Stai creando un'app specifica per l'area di lavoro dal modello di app GitLab Self-Managed. L'app usa:
Un'applicazione OAuth GitLab registrata sul tuo host GitLab Self-Managed o GitLab Dedicated.
L'ID applicazione e il Segreto OAuth GitLab per l'autorizzazione degli utenti.
Gli ambiti OAuth richiesti: api, write_repository e openid.
Il nome host GitLab, ad esempio gitlab.example.com, per ricavare gli endpoint web, API, di autorizzazione e dei token.
Prima di iniziare
Occorrono:
Accesso come amministratore o proprietario dell'area di lavoro ChatGPT.
L'autorizzazione GitLab per creare l'applicazione OAuth: accesso come Proprietario del gruppo per un'app di proprietà del gruppo oppure accesso come amministratore dell'istanza per un'app disponibile nell'intera istanza.
Solo il nome host GitLab, senza https://, porta o percorso. Usa un host GitLab Self-Managed o GitLab Dedicated, non gitlab.com.
La decisione sulle azioni GitLab che ChatGPT e Codex devono supportare, ad esempio la ricerca nei repository, i flussi di lavoro delle richieste di merge e dei problemi, le modifiche ai file o flussi di lavoro Codex più ampi.
Tieni aperti ChatGPT e GitLab in schede separate. Copia esattamente l'URI di reindirizzamento mostrato in ChatGPT, senza crearlo né modificarlo.
Valori da preparare
Nome host GitLab: ad esempio, gitlab.example.com.
URI di reindirizzamento: copialo dalla procedura di configurazione del modello in ChatGPT.
ID applicazione OAuth GitLab.
Segreto OAuth 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 > Plugins.
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.
Creare l'applicazione OAuth GitLab in GitLab
Scegliere dove creare l'applicazione
Apri il tuo host GitLab, ad esempio https://gitlab.example.com.
Scegli se creare un'applicazione per l'intera istanza o un'applicazione 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 concede l'autorizzazione e dagli ambiti OAuth concessi.
Per un'applicazione disponibile nell'intera istanza, vai a Amministrazione > Applicazioni. Per un'applicazione di proprietà di un gruppo, vai a Impostazioni > Applicazioni del gruppo.
Aggiungere 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.
Configurare l'accesso e salvare
Per un'applicazione disponibile nell'intera istanza, GitLab consiglia di selezionare Attendibile. In questo modo la richiesta di autorizzazione all'utente viene ignorata.
Seleziona gli ambiti api, write_repository e openid.
Verifica chi può gestire l'applicazione e assicurati che gli utenti GitLab che concedono l'autorizzazione 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 dell'API GitLab rese disponibili dall'app, incluse le azioni relative a richieste di merge, problemi e CI/CD.
write_repository: necessario per le operazioni di scrittura nei repository tramite Git.
openid: necessario per le informazioni su identità e appartenenza di OpenID Connect.
Copiare le credenziali OAuth 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.
Completare la configurazione in ChatGPT
Torna alla scheda di configurazione del modello in ChatGPT.
Incolla l'ID applicazione GitLab in ID client OAuth.
Incolla il Segreto GitLab in Segreto client OAuth.
Verifica che il nome host 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.
Pubblicare e gestire l'app per ChatGPT e Codex
La creazione della bozza dell'app non la rende automaticamente disponibile ai membri. Dopo aver controllato la bozza:
Seleziona Pubblica per la bozza dell'app.
Vai a Impostazioni dell'area di lavoro > Plugin e 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 connettersi all'app creata dal modello Self-Managed di GitLab.
Queste impostazioni di approvazione dell'app si applicano alle conversazioni di ChatGPT e ai thread di Codex.
Configurare l'attività GitLab per la revisione del codice con Codex
Dopo la pubblicazione dell'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 dell'area di lavoro. Consenti a Codex di creare 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 relativi gruppi principali.
Se Codex deve eseguire attività di programmazione o usare una configurazione specifica del progetto, crea un ambiente di progetto.
L'app GitLab usa OAuth utente per le letture e le azioni abilitate in ChatGPT e Codex. Per le operazioni di scrittura delle revisioni Codex su GitLab Self-Managed o GitLab Dedicated, il token dell'account di servizio gestito dall'area di lavoro determina l'identità e i progetti in cui Codex può commentare o aggiungere reazioni.
Approfondisci: Revisionare le richieste di merge GitLab con Codex.
Connettere e testare l'app GitLab
Come utente con accesso, apri GitLab dalla Directory dei plugin o da Impostazioni > Plugin. Seleziona Installa plugin, quindi Connetti.
Se la tua area di lavoro dispone di più app GitLab, scegli l'app per questo host GitLab Self-Managed o GitLab Dedicated.
Quando richiesto, autorizza l'applicazione OAuth GitLab.
Esegui prima una semplice azione di lettura in ChatGPT o Codex, ad esempio elencando i progetti accessibili o recuperando una richiesta di merge nota.
Se le azioni di scrittura sono abilitate, provale in un progetto a basso rischio e in ogni prodotto in cui intendi usarle prima di distribuirle su più ampia scala.
Comportamento del nome host e di OAuth
L'app usa il nome host per ricavare gli endpoint GitLab. Inserisci solo l'host, ad esempio gitlab.example.com. Non includere https://, un percorso API o di 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
Mancata corrispondenza dell'URI di reindirizzamento: verifica che l'URI di reindirizzamento dell'applicazione OAuth 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 funzionano: verifica che l'utente GitLab che concede l'autorizzazione possa accedere al progetto e che l'applicazione OAuth disponga degli ambiti previsti dal modello.
L'API restituisce 403 o autorizzazioni insufficienti: verifica che l'account GitLab connesso 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 al progetto, sia connesso all'istanza GitLab corretta e abbia selezionato l'app GitLab appropriata in ChatGPT o Codex.