Integracja GitLab z ChatGPT i Codex jest obecnie w wersji beta.
Omówienie
Użyj szablonu aplikacji GitLab Self-Managed, aby utworzyć w przestrzeni roboczej wersję roboczą aplikacji dla instancji GitLab Self-Managed lub GitLab Dedicated. Podaj nazwę hosta GitLab i dane uwierzytelniające aplikacji OAuth, sprawdź wersję roboczą aplikacji, a następnie opublikuj ją dla uprawnionych członków przestrzeni roboczej. Po opublikowaniu włączone działania aplikacji są dostępne w rozmowach w ChatGPT i sesjach Codex.
Informacje o obsługiwanych funkcjach GitLab, dostępności, uprawnieniach, wykorzystaniu danych i wymaganiach sieciowych znajdziesz w artykule: Łączenie GitLab z ChatGPT i Codex.
Co konfigurujesz
Tworzysz aplikację dla konkretnej przestrzeni roboczej na podstawie szablonu aplikacji GitLab Self-Managed. Aplikacja korzysta z następujących elementów:
Aplikacja OAuth GitLab zarejestrowana na Twoim hoście GitLab Self-Managed lub GitLab Dedicated.
Identyfikator aplikacji i Klucz tajny OAuth GitLab służące do autoryzacji użytkowników.
Wymagane zakresy OAuth: api, write_repository i openid.
Nazwa hosta GitLab, np. gitlab.example.com, na podstawie której ustalane są punkty końcowe interfejsu WWW, API, autoryzacji i tokenów.
Zanim zaczniesz
Potrzebujesz:
Uprawnień administratora lub właściciela przestrzeni roboczej ChatGPT.
Uprawnień do utworzenia aplikacji OAuth w GitLab: roli Właściciel w grupie w przypadku aplikacji należącej do grupy lub uprawnień administratora instancji w przypadku aplikacji dla całej instancji.
Samej nazwy hosta GitLab, bez https://, portu ani ścieżki. Użyj hosta GitLab Self-Managed lub GitLab Dedicated, a nie gitlab.com.
Decyzji, które działania GitLab mają obsługiwać ChatGPT i Codex, np. wyszukiwanie w repozytorium, obsługę żądań scalenia i zgłoszeń, edycję plików czy bardziej rozbudowane procesy w Codex.
Pozostaw ChatGPT i GitLab otwarte w osobnych kartach. Skopiuj dokładny URI przekierowania widoczny w ChatGPT. Nie twórz go ani nie modyfikuj samodzielnie.
Aby otworzyć stronę Aplikacje z poziomu konsoli administratora, wybierz docelową przestrzeń roboczą ChatGPT, otwórz Wtyczki i wybierz Zarządzaj starszymi aplikacjami.
Wartości, które należy przygotować
Nazwa hosta GitLab: np. gitlab.example.com.
URI przekierowania: skopiuj go podczas konfiguracji szablonu w ChatGPT.
Identyfikator aplikacji OAuth GitLab.
Klucz tajny OAuth GitLab.
Zakresy OAuth: skopiuj je podczas konfiguracji szablonu w 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.
Utwórz aplikację OAuth GitLab w GitLab
Wybierz, gdzie utworzyć aplikację
Otwórz stronę swojego hosta GitLab, np. https://gitlab.example.com.
Wybierz, czy chcesz utworzyć aplikację dla całej instancji, czy aplikację należącą do grupy. Ten wybór określa, kto zarządza aplikacją. Dostęp do projektów nadal zależy od uprawnień użytkownika udzielającego autoryzacji w GitLab i przyznanych zakresów OAuth.
W przypadku aplikacji dla całej instancji przejdź do sekcji Administracja > Aplikacje. W przypadku aplikacji należącej do grupy przejdź do sekcji Ustawienia > Aplikacje w tej grupie.
Dodaj dane aplikacji
Wybierz Nowa aplikacja lub Dodaj nową aplikację.
Wpisz jednoznaczną nazwę aplikacji, np. GitLab Self-Managed lub GitLab Dedicated.
W polu URI przekierowania wklej dokładny identyfikator URI skopiowany z ChatGPT.
Pozostaw włączoną opcję Poufna dla tej aplikacji OAuth działającej po stronie serwera.
Skonfiguruj dostęp i zapisz
W przypadku aplikacji dla całej instancji GitLab zaleca wybranie opcji Zaufana. Dzięki temu użytkownik nie zobaczy prośby o autoryzację.
Wybierz zakresy api, write_repository i openid.
Sprawdź, kto może zarządzać aplikacją, i upewnij się, że użytkownicy GitLab udzielający autoryzacji mają odpowiednie uprawnienia do grup i projektów.
Zapisz aplikację.
Wymagania dotyczące zakresów OAuth
Szablon wymaga następujących zakresów OAuth dla włączonych działań GitLab w ChatGPT i Codex:
api: wymagany do operacji API GitLab udostępnianych przez aplikację, w tym działań dotyczących żądań scalenia, zgłoszeń i CI/CD.
write_repository: wymagany do operacji zapisu w repozytorium przez Git.
openid: wymagany do uzyskiwania informacji o tożsamości i członkostwie przez OpenID Connect.
Skopiuj dane uwierzytelniające OAuth GitLab
W zapisanej aplikacji GitLab skopiuj Identyfikator aplikacji i Klucz tajny. Chroń Klucz tajny tak jak inne dane uwierzytelniające. Jeśli zostanie ujawniony, wygeneruj go ponownie w GitLab i utwórz nową aplikację w przestrzeni roboczej.
Dokończ konfigurację w ChatGPT
Wróć do karty konfiguracji szablonu w ChatGPT.
Wklej Identyfikator aplikacji z GitLab w polu Identyfikator klienta OAuth.
Wklej Klucz tajny z GitLab w polu Klucz tajny klienta OAuth.
Sprawdź, czy pole nazwy hosta GitLab zawiera wyłącznie nazwę hosta, np. gitlab.example.com.
Wybierz Utwórz wersję roboczą.
Otwórz szczegóły wersji roboczej aplikacji i sprawdź sekcje Dostęp według ról oraz Konfiguruj działania.
Opublikuj aplikację dla ChatGPT i Codex i zarządzaj nią
Utworzenie wersji roboczej aplikacji nie udostępnia jej automatycznie członkom przestrzeni roboczej. Po sprawdzeniu wersji roboczej:
Wybierz Opublikuj dla wersji roboczej aplikacji.
Przejdź do konsoli administratora, wybierz docelową przestrzeń roboczą ChatGPT i otwórz Wtyczki. Następnie sprawdź, czy GitLab jest dostępny dla odpowiednich ról.
Sprawdź Dostęp według ról dla ról, które powinny korzystać z aplikacji.
W sekcji Konfiguruj działania sprawdź dostępne działania odczytu i zapisu.
W sekcji Konfiguruj zatwierdzenia wybierz, kiedy użytkownicy muszą zatwierdzić działanie, zanim ChatGPT lub Codex użyje aplikacji.
Poproś użytkownika testowego z odpowiednim dostępem, aby otworzył GitLab w katalogu wtyczek lub w sekcji Ustawienia > Wtyczki. Sprawdź, czy użytkownik może zainstalować wtyczkę i połączyć się z aplikacją utworzoną na podstawie szablonu GitLab Self-Managed.
Te ustawienia zatwierdzania działań aplikacji dotyczą rozmów w ChatGPT i wątków w Codex.
Skonfiguruj aktywność GitLab na potrzeby przeglądów kodu w Codex
Jeśli planujesz korzystać z przeglądów kodu w Codex, po opublikowaniu aplikacji skonfiguruj aktywność GitLab w Codex. Ta konfiguracja aktywności ustawia wymagane zdarzenia webhooków.
Otwórz ustawienia konektorów Codex.
Skonfiguruj konto usługi dla przestrzeni roboczej. Pozwól Codex utworzyć konto lub podaj osobisty token dostępu do istniejącego konta usługi.
Włącz Aktywność GitLab dla projektu lub jednej z jego grup nadrzędnych.
Jeśli Codex ma wykonywać zadania programistyczne lub korzystać z konfiguracji specyficznej dla projektu, utwórz środowisko projektu.
Aplikacja GitLab korzysta z autoryzacji OAuth użytkownika do odczytu i włączonych działań w ChatGPT i Codex. W przypadku operacji zapisu podczas przeglądów kodu przez Codex w GitLab Self-Managed lub GitLab Dedicated token konta usługi zarządzany w przestrzeni roboczej określa tożsamość używaną przez Codex oraz projekty, w których może on dodawać komentarze lub reakcje.
Dowiedz się więcej: Przeglądanie żądań scalenia GitLab za pomocą Codex.
Połącz i przetestuj aplikację GitLab
Jako użytkownik z odpowiednim dostępem otwórz GitLab w katalogu wtyczek lub w sekcji Ustawienia > Wtyczki. Wybierz Zainstaluj wtyczkę, a następnie Połącz.
Jeśli w Twojej przestrzeni roboczej jest więcej niż jedna aplikacja GitLab, wybierz aplikację dla tego hosta GitLab Self-Managed lub GitLab Dedicated.
Gdy pojawi się prośba, udziel autoryzacji aplikacji OAuth GitLab.
Najpierw wykonaj proste działanie odczytu w ChatGPT lub Codex, np. wyświetl listę dostępnych projektów lub pobierz znane żądanie scalenia.
Jeśli działania zapisu są włączone, przed szerszym wdrożeniem przetestuj je w projekcie o niskim ryzyku oraz w każdym produkcie, w którym planujesz z nich korzystać.
Nazwa hosta i działanie OAuth
Aplikacja ustala punkty końcowe GitLab na podstawie nazwy hosta. Wpisz tylko nazwę hosta, np. gitlab.example.com. Nie podawaj https://, ścieżki API ani repozytorium, portu ani gitlab.com. Ten szablon jest przeznaczony dla GitLab Self-Managed lub GitLab Dedicated. W przypadku GitLab.com (SaaS) użyj aplikacji GitLab.
Rozwiązywanie problemów z konfiguracją aplikacji GitLab Self-Managed
Niezgodność identyfikatora URI przekierowania: Sprawdź, czy identyfikator URI przekierowania aplikacji OAuth GitLab jest identyczny z identyfikatorem URI przekierowania widocznym w ChatGPT.
ChatGPT nie może utworzyć lub zapisać wersji roboczej aplikacji: Sprawdź, czy podano nazwę hosta, identyfikator aplikacji, klucz tajny i identyfikator URI przekierowania.
Uwierzytelnianie działa, ale wywołania dotyczące projektu kończą się niepowodzeniem: Sprawdź, czy użytkownik GitLab udzielający autoryzacji ma dostęp do projektu, a aplikacja OAuth ma zakresy wymagane przez szablon.
API zwraca błąd 403 lub informację o niewystarczających uprawnieniach: Sprawdź, czy połączone konto GitLab ma wymagane uprawnienia do projektu lub grupy, a aplikacja OAuth obejmuje zakresy wymagane przez szablon.
Brak dostępu do projektów: Sprawdź, czy użytkownik ma dostęp do projektów, jest połączony z właściwą instancją GitLab i wybrał odpowiednią aplikację GitLab w ChatGPT lub Codex.