GitLab ChatGPT:ssä ja Codexissa on tällä hetkellä beetavaiheessa.
Yleiskatsaus
Luo työtilakohtainen sovellusluonnos GitLab Self-Managed- tai GitLab Dedicated -instanssia varten käyttämällä GitLab Self-Managed -sovellusmallia. Anna GitLabin isäntänimi ja OAuth-sovelluksen tunnistetiedot, tarkista sovellusluonnos ja julkaise se sitten työtilan jäsenille, joilla on siihen käyttöoikeus. Julkaisun jälkeen sovelluksen käyttöön otetut toiminnot ovat käytettävissä ChatGPT-keskusteluissa ja Codex-istunnoissa.
Yleiskatsauksen tuetuista GitLab-toiminnoista, saatavuudesta, käyttöoikeuksista, tietojen käytöstä ja verkkovaatimuksista löydät artikkelista GitLabin yhdistäminen ChatGPT:hen ja Codexiin.
Mitä olet määrittämässä
Olet luomassa työtilakohtaista sovellusta GitLab Self-Managed -sovellusmallista. Sovellus käyttää seuraavia:
GitLab OAuth -sovellus, joka on rekisteröity GitLab Self-Managed- tai GitLab Dedicated -palvelimellesi.
GitLab OAuth -sovelluksen Sovellustunnus ja Salaisuus käyttäjän valtuutusta varten.
Vaaditut OAuth-käyttöoikeusalueet: api, write_repository ja openid.
GitLabin isäntänimi, esimerkiksi gitlab.example.com, verkko-, API-, valtuutus- ja tunnistepäätepisteiden muodostamista varten.
Ennen aloittamista
Tarvitset seuraavat:
ChatGPT-työtilan ylläpitäjän tai omistajan käyttöoikeudet.
GitLab-käyttöoikeudet OAuth-sovelluksen luomiseen: ryhmän omistajan oikeudet ryhmän omistamaa sovellusta varten tai instanssin ylläpitäjän oikeudet koko instanssin kattavaa sovellusta varten.
Pelkkä GitLabin isäntänimi ilman https://-etuliitettä, porttia tai polkua. Käytä GitLab Self-Managed- tai GitLab Dedicated -palvelinta, älä gitlab.com-palvelua.
Päätös siitä, mitä GitLab-toimintoja ChatGPT:n ja Codexin tulee tukea, esimerkiksi repositoriohakua, yhdistämispyyntöjen tai tehtävien työnkulkuja, tiedostojen muokkausta tai laajempia Codex-työnkulkuja.
Pidä ChatGPT ja GitLab auki eri välilehdillä. Kopioi ChatGPT:ssä näkyvä Uudelleenohjaus-URI täsmälleen sellaisenaan. Älä luo tai muokkaa sitä.
Avaa Sovellukset-sivu hallintakonsolista valitsemalla haluamasi ChatGPT-työtila, avaamalla Lisäosat ja valitsemalla Hallitse vanhoja sovelluksia.
Valmistele nämä arvot
GitLabin isäntänimi: esimerkiksi gitlab.example.com.
Uudelleenohjaus-URI: kopioi tämä ChatGPT:n mallin ohjatusta määrityksestä.
GitLab OAuth -sovelluksen Sovellustunnus.
GitLab OAuth -sovelluksen Salaisuus.
OAuth-käyttöoikeusalueet: kopioi nämä ChatGPT:n mallin ohjatusta määrityksestä.
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.
Luo GitLab OAuth -sovellus GitLabissa
Valitse, minne sovellus luodaan
Avaa GitLab-palvelimesi, esimerkiksi https://gitlab.example.com.
Valitse, luotko koko instanssin kattavan vai ryhmän omistaman sovelluksen. Tämä valinta määrittää, kuka hallitsee sovellusta. Pääsy projekteihin määräytyy silti valtuutuksen antavan käyttäjän GitLab-käyttöoikeuksien ja myönnettyjen OAuth-käyttöoikeusalueiden perusteella.
Jos luot koko instanssin kattavan sovelluksen, siirry kohtaan Ylläpito > Sovellukset. Jos luot ryhmän omistaman sovelluksen, siirry ryhmän kohtaan Asetukset > Sovellukset.
Lisää sovelluksen tiedot
Valitse Uusi sovellus tai Lisää uusi sovellus.
Anna sovellukselle selkeä nimi, kuten GitLab Self-Managed tai GitLab Dedicated.
Liitä ChatGPT:stä kopioitu URI sellaisenaan kenttään Uudelleenohjaus-URI.
Pidä Luottamuksellinen-asetus käytössä tälle palvelinpuolen OAuth-sovellukselle.
Määritä käyttöoikeudet ja tallenna
GitLab suosittelee valitsemaan koko instanssin kattavalle sovellukselle asetuksen Luotettu. Tällöin käyttäjälle ei näytetä valtuutuspyyntöä.
Valitse käyttöoikeusalueet api, write_repository ja openid.
Tarkista, ketkä voivat hallita sovellusta, ja varmista, että valtuutuksen antavilla GitLab-käyttäjillä on asianmukaiset ryhmä- ja projektioikeudet.
Tallenna sovellus.
OAuth-käyttöoikeusalueiden vaatimukset
Malli pyytää seuraavia OAuth-käyttöoikeusalueita ChatGPT:ssä ja Codexissa käyttöön otettuja GitLab-toimintoja varten:
api: tarvitaan sovelluksen tarjoamiin GitLab API -toimintoihin, mukaan lukien yhdistämispyyntö-, tehtävä- ja CI/CD-toiminnot.
write_repository: tarvitaan repositorion kirjoitustoimintoihin Gitin kautta.
openid: tarvitaan OpenID Connectin identiteetti- ja jäsenyystietoihin.
Kopioi GitLab OAuth -tunnistetiedot
Kopioi tallennetusta GitLab-sovelluksesta Sovellustunnus ja Salaisuus. Käsittele Salaisuus-arvoa luottamuksellisena tunnistetietona. Jos se paljastuu ulkopuolisille, uusi se GitLabissa ja luo uusi työtilasovellus.
Viimeistele määritys ChatGPT:ssä
Palaa ChatGPT:n mallin määritysvälilehdelle.
Liitä GitLabin Sovellustunnus kenttään OAuth-asiakastunnus.
Liitä GitLabin Salaisuus kenttään OAuth-asiakkaan salaisuus.
Varmista, että GitLabin isäntänimi sisältää vain isäntänimen, esimerkiksi gitlab.example.com.
Valitse Luo luonnos.
Avaa sovellusluonnoksen tiedot ja tarkista Roolien käyttöoikeudet- ja Määritä toiminnot -osiot.
Julkaise sovellus ChatGPT:n ja Codexin käyttöön ja hallitse sitä
Sovellusluonnoksen luominen ei automaattisesti tuo sovellusta jäsenten saataville. Kun olet tarkistanut luonnoksen:
Valitse sovellusluonnoksen kohdalla Julkaise.
Siirry hallintakonsoliin, valitse haluamasi ChatGPT-työtila ja avaa Lisäosat. Varmista sitten, että GitLab on haluamiesi roolien käytettävissä.
Tarkista Roolien käyttöoikeudet niiden roolien osalta, joiden on tarkoitus käyttää sovellusta.
Tarkista käytettävissä olevat luku- ja kirjoitustoiminnot kohdassa Määritä toiminnot.
Valitse kohdassa Määritä hyväksynnät, milloin käyttäjien on hyväksyttävä toiminto ennen kuin ChatGPT tai Codex käyttää sovellusta.
Pyydä testikäyttäjää, jolla on käyttöoikeus, avaamaan GitLab lisäosahakemistosta tai kohdasta Asetukset > Lisäosat. Varmista, että käyttäjä voi asentaa lisäosan ja yhdistää sen GitLab Self-Managed -mallista luotuun sovellukseen.
Nämä sovelluksen hyväksyntäasetukset koskevat ChatGPT-keskusteluja ja Codex-ketjuja.
Määritä GitLab-tapahtumat Codexin koodikatselmointia varten
Jos aiot käyttää Codexin koodikatselmointia, määritä GitLab-tapahtumat Codexissa sovelluksen julkaisun jälkeen. Tämä tapahtumien määritys määrittää tarvittavat webhook-tapahtumat.
Määritä työtilan palvelutili. Anna Codexin luoda tili tai anna olemassa olevan palvelutilin henkilökohtainen käyttöoikeustunniste.
Ota GitLab-tapahtumat käyttöön projektissa tai jossakin sen ylemmän tason ryhmistä.
Jos Codexin täytyy suorittaa koodaustehtäviä tai käyttää projektikohtaisia määrityksiä, luo projektiympäristö.
GitLab-sovellus käyttää käyttäjän OAuth-valtuutusta lukutoimintoihin ja käyttöön otettuihin toimintoihin ChatGPT:ssä ja Codexissa. Kun Codex kirjoittaa katselmointitietoja GitLab Self-Managed- tai GitLab Dedicated -ympäristössä, työtilan hallinnoima palvelutilin tunniste määrittää, millä identiteetillä ja missä projekteissa Codex voi kommentoida tai reagoida.
Lue lisää: GitLabin yhdistämispyyntöjen katselmointi Codexilla.
Yhdistä GitLab-sovellukseen ja testaa sitä
Avaa käyttöoikeuden omaavana käyttäjänä GitLab lisäosahakemistosta tai kohdasta Asetukset > Lisäosat. Valitse Asenna lisäosa ja sitten Yhdistä.
Jos työtilassasi on useita GitLab-sovelluksia, valitse tälle GitLab Self-Managed- tai GitLab Dedicated -palvelimelle tarkoitettu sovellus.
Valtuuta GitLab OAuth -sovellus pyydettäessä.
Suorita ensin pieni lukutoiminto ChatGPT:ssä tai Codexissa. Listaa esimerkiksi projektit, joihin sinulla on pääsy, tai hae tunnettu yhdistämispyyntö.
Jos kirjoitustoiminnot ovat käytössä, testaa niitä vähäriskisessä projektissa ja jokaisessa tuotteessa, jossa aiot niitä käyttää, ennen laajempaa käyttöönottoa.
Isäntänimi ja OAuthin toiminta
Sovellus muodostaa GitLab-päätepisteet isäntänimen perusteella. Anna vain isäntänimi, esimerkiksi gitlab.example.com. Älä sisällytä siihen https://-etuliitettä, API- tai repositoriopolkua tai porttia. Älä käytä isäntänimeä gitlab.com. Tämä malli on tarkoitettu GitLab Self-Managed- tai GitLab Dedicated -ympäristöön. Käytä GitLab.com-palvelun (SaaS) kanssa GitLab-sovellusta.
GitLab Self-Managed -sovelluksen määrityksen vianmääritys
Uudelleenohjaus-URI ei täsmää: Varmista, että GitLab OAuth -sovelluksen uudelleenohjaus-URI vastaa täsmälleen ChatGPT:ssä näkyvää uudelleenohjaus-URIa.
ChatGPT ei voi luoda tai tallentaa sovellusluonnosta: Varmista, että isäntänimi, sovellustunnus, salaisuus ja uudelleenohjaus-URI on annettu.
Todennus onnistuu, mutta projektikutsut epäonnistuvat: Varmista, että valtuutuksen antavalla GitLab-käyttäjällä on pääsy projektiin ja että OAuth-sovelluksella on mallin mukaiset käyttöoikeusalueet.
API palauttaa virheen 403 tai ilmoittaa riittämättömistä käyttöoikeuksista: Varmista, että yhdistetyllä GitLab-tilillä on tarvittavat projekti- tai ryhmäoikeudet ja että OAuth-sovelluksella on mallin edellyttämät käyttöoikeusalueet.
Yhteenkään projektiin ei ole pääsyä: Varmista, että käyttäjällä on pääsy projektiin, että hän on yhdistänyt oikeaan GitLab-instanssiin ja että hän on valinnut oikean GitLab-sovelluksen ChatGPT:ssä tai Codexissa.