GitLab în ChatGPT și Codex este momentan în versiune beta.
Prezentare generală
Folosește șablonul de aplicație GitLab Self-Managed pentru a crea o versiune preliminară a unei aplicații specifice spațiului de lucru, destinată unei instanțe GitLab Self-Managed sau GitLab Dedicated. Furnizează numele gazdei GitLab și datele de autentificare ale aplicației OAuth, verifică versiunea preliminară a aplicației, apoi public-o pentru membrii eligibili ai spațiului de lucru. După publicare, acțiunile activate ale aplicației sunt disponibile în conversațiile ChatGPT și în sesiunile Codex.
Pentru o prezentare generală a funcționalităților GitLab acceptate, a disponibilității, permisiunilor, utilizării datelor și cerințelor de rețea, consultă: Conectarea GitLab la ChatGPT și Codex.
Ce configurezi
Creezi o aplicație specifică spațiului de lucru, pornind de la șablonul de aplicație GitLab Self-Managed. Aplicația folosește:
O aplicație OAuth GitLab înregistrată pe gazda ta GitLab Self-Managed sau GitLab Dedicated.
Valorile ID aplicație și Secret ale aplicației OAuth GitLab, pentru autorizarea utilizatorilor.
Domeniile de acces OAuth necesare: api, write_repository și openid.
Numele gazdei tale GitLab, de exemplu gitlab.example.com, pentru a determina punctele finale web, API, de autorizare și de token.
Înainte de a începe
Ai nevoie de:
Acces de administrator sau proprietar al spațiului de lucru ChatGPT.
Permisiunea de a crea aplicația OAuth în GitLab: acces de Proprietar al grupului pentru o aplicație deținută de un grup sau acces de administrator al instanței pentru o aplicație la nivelul întregii instanțe.
Doar numele gazdei GitLab, fără https://, port sau cale. Folosește o gazdă GitLab Self-Managed sau GitLab Dedicated, nu gitlab.com.
O decizie privind acțiunile GitLab pe care ChatGPT și Codex ar trebui să le accepte, cum ar fi căutarea în depozite, fluxurile de lucru pentru cereri de îmbinare sau probleme, editarea fișierelor ori fluxuri de lucru Codex mai ample.
Păstrează ChatGPT și GitLab deschise în file separate. Copiază exact URI-ul de redirecționare afișat în ChatGPT; nu îl crea și nu îl modifica.
Pentru a deschide pagina Aplicații din Consola de administrare, selectează spațiul de lucru ChatGPT dorit, deschide Pluginuri și selectează Gestionează aplicațiile vechi.
Valori de pregătit
Numele gazdei GitLab: de exemplu, gitlab.example.com.
URI de redirecționare: copiază-l din fluxul de configurare a șablonului din ChatGPT.
Valoarea ID aplicație a aplicației OAuth GitLab.
Valoarea Secret a aplicației OAuth GitLab.
Domenii de acces OAuth: copiază-le din fluxul de configurare a șablonului din 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.
Creează aplicația OAuth GitLab în GitLab
Alege unde să creezi aplicația
Accesează gazda ta GitLab, de exemplu https://gitlab.example.com.
Alege dacă vrei să creezi o aplicație la nivelul întregii instanțe sau una deținută de un grup. Această alegere stabilește cine gestionează aplicația; accesul la proiecte depinde în continuare de permisiunile GitLab ale utilizatorului care acordă autorizarea și de domeniile de acces OAuth acordate.
Pentru o aplicație la nivelul întregii instanțe, accesează Administrare > Aplicații. Pentru o aplicație deținută de un grup, accesează Setări > Aplicații în cadrul grupului.
Adaugă detaliile aplicației
Selectează Aplicație nouă sau Adaugă o aplicație nouă.
Introdu un nume clar pentru aplicație, de exemplu GitLab Self-Managed sau GitLab Dedicated.
În URI de redirecționare, lipește URI-ul exact copiat din ChatGPT.
Păstrează opțiunea Confidențială activată pentru această aplicație OAuth care rulează pe server.
Configurează accesul și salvează
Pentru o aplicație la nivelul întregii instanțe, GitLab recomandă selectarea opțiunii De încredere. Astfel, utilizatorului nu i se mai solicită autorizarea.
Selectează domeniile de acces api, write_repository și openid.
Verifică cine poate gestiona aplicația și asigură-te că utilizatorii GitLab care acordă autorizarea au permisiunile corespunzătoare pentru grupuri și proiecte.
Salvează aplicația.
Cerințe privind domeniile de acces OAuth
Șablonul solicită următoarele domenii de acces OAuth pentru acțiunile GitLab activate în ChatGPT și Codex:
api: necesar pentru operațiunile API GitLab oferite de aplicație, inclusiv acțiunile pentru cereri de îmbinare, probleme și CI/CD.
write_repository: necesar pentru operațiunile de scriere în depozite prin Git.
openid: necesar pentru informațiile despre identitate și apartenență prin OpenID Connect.
Copiază datele de autentificare OAuth GitLab
În aplicația GitLab salvată, copiază valorile din câmpurile ID aplicație și Secret. Tratează valoarea din câmpul Secret ca pe o dată de autentificare. Dacă secretul este expus, regenerează-l în GitLab și creează o nouă aplicație pentru spațiul de lucru.
Finalizează configurarea în ChatGPT
Revino la fila de configurare a șablonului din ChatGPT.
Lipește valoarea din câmpul ID aplicație din GitLab în ID client OAuth.
Lipește valoarea din câmpul Secret din GitLab în Secret client OAuth.
Asigură-te că în câmpul pentru numele gazdei GitLab apare doar numele gazdei, de exemplu gitlab.example.com.
Selectează Creează versiune preliminară.
Deschide detaliile versiunii preliminare a aplicației și verifică secțiunile Acces pe roluri și Configurează acțiunile.
Publică și gestionează aplicația pentru ChatGPT și Codex
Crearea versiunii preliminare a aplicației nu o face automat disponibilă membrilor. După verificarea versiunii preliminare:
Selectează Publică pentru versiunea preliminară a aplicației.
Accesează Consola de administrare, selectează spațiul de lucru ChatGPT dorit și deschide Pluginuri, apoi asigură-te că GitLab este disponibil pentru rolurile vizate.
Verifică secțiunea Acces pe roluri pentru rolurile care ar trebui să folosească aplicația.
În Configurează acțiunile, verifică acțiunile de citire și scriere disponibile.
În Configurează aprobările, alege când trebuie utilizatorii să aprobe o acțiune înainte ca ChatGPT sau Codex să folosească aplicația.
Roagă un utilizator de test care are acces să deschidă GitLab din Catalogul de pluginuri sau din Setări > Pluginuri. Asigură-te că utilizatorul poate instala pluginul și se poate conecta la aplicația creată din șablonul GitLab Self-Managed.
Aceste setări de aprobare pentru aplicație se aplică conversațiilor ChatGPT și firelor de discuție Codex.
Configurează activitatea GitLab pentru revizuirea codului cu Codex
După publicarea aplicației, configurează activitatea GitLab în Codex dacă intenționezi să folosești Codex pentru revizuirea codului. Această configurare a activității stabilește evenimentele webhook necesare.
Deschide setările conectorilor Codex.
Configurează un cont de serviciu pentru spațiul de lucru. Lasă Codex să creeze contul sau furnizează un token de acces personal pentru un cont de serviciu existent.
Activează Activitate GitLab pentru proiect sau pentru unul dintre grupurile sale părinte.
Dacă Codex trebuie să execute sarcini de programare sau să folosească o configurare specifică proiectului, creează un mediu de proiect.
Aplicația GitLab folosește autorizarea OAuth a utilizatorului pentru operațiunile de citire și acțiunile activate în ChatGPT și Codex. Pentru operațiunile de scriere efectuate de Codex în timpul revizuirii pe GitLab Self-Managed sau GitLab Dedicated, tokenul contului de serviciu gestionat de spațiul de lucru stabilește identitatea folosită și proiectele în care Codex poate adăuga comentarii sau reacții.
Află mai multe: Revizuiește cererile de îmbinare GitLab cu Codex.
Conectează și testează aplicația GitLab
Ca utilizator care are acces, deschide GitLab din Catalogul de pluginuri sau din Setări > Pluginuri. Selectează Instalează pluginul, apoi selectează Conectează.
Dacă spațiul tău de lucru are mai multe aplicații GitLab, alege aplicația pentru această gazdă GitLab Self-Managed sau GitLab Dedicated.
Autorizează aplicația OAuth GitLab când ți se solicită.
Rulează mai întâi o acțiune simplă de citire în ChatGPT sau Codex, cum ar fi listarea proiectelor accesibile sau preluarea unei cereri de îmbinare cunoscute.
Dacă acțiunile de scriere sunt activate, testează-le într-un proiect cu risc scăzut și în fiecare produs în care intenționezi să le folosești, înainte de a extinde utilizarea.
Numele gazdei și funcționarea OAuth
Aplicația folosește numele gazdei pentru a determina punctele finale GitLab. Introdu doar numele gazdei, de exemplu gitlab.example.com. Nu include https://, o cale API sau de depozit, un port ori gitlab.com. Acest șablon este destinat GitLab Self-Managed sau GitLab Dedicated. Pentru GitLab.com (SaaS), folosește aplicația GitLab.
Depanarea configurării aplicației GitLab Self-Managed
URI-ul de redirecționare nu corespunde: Asigură-te că URI-ul de redirecționare al aplicației OAuth GitLab corespunde exact celui afișat în ChatGPT.
ChatGPT nu poate crea sau salva versiunea preliminară a aplicației: Asigură-te că sunt completate numele gazdei, ID-ul aplicației, secretul și URI-ul de redirecționare.
Autentificarea reușește, dar apelurile către proiect eșuează: Asigură-te că utilizatorul GitLab care acordă autorizarea poate accesa proiectul și că aplicația OAuth are domeniile de acces ale șablonului.
API-ul returnează 403 sau indică permisiuni insuficiente: Asigură-te că contul GitLab conectat are permisiunile necesare pentru proiect sau grup și că aplicația OAuth include domeniile de acces cerute de șablon.
Niciun proiect nu este accesibil: Asigură-te că utilizatorul are acces la proiecte, este conectat la instanța GitLab dorită și a selectat aplicația GitLab corectă în ChatGPT sau Codex.