GitLab di ChatGPT dan Codex saat ini masih dalam versi beta.
Ringkasan
Gunakan templat aplikasi GitLab Self-Managed untuk membuat draf aplikasi khusus workspace bagi instans GitLab Self-Managed atau GitLab Dedicated. Masukkan nama host GitLab dan kredensial aplikasi Oauth, tinjau draf aplikasi, lalu publikasikan untuk anggota workspace yang memenuhi syarat. Setelah dipublikasikan, tindakan yang diaktifkan pada aplikasi tersedia dalam percakapan ChatGPT dan sesi Codex.
Untuk ringkasan tentang fungsi GitLab yang didukung, ketersediaan, izin, penggunaan data, dan persyaratan jaringan, lihat: Menghubungkan GitLab ke ChatGPT dan Codex.
Apa yang Anda siapkan
Anda akan membuat aplikasi khusus workspace dari templat aplikasi GitLab Self-Managed. Aplikasi ini menggunakan:
Aplikasi Oauth GitLab yang terdaftar di host GitLab Self-Managed atau GitLab Dedicated Anda.
ID Aplikasi dan Rahasia Oauth GitLab untuk otorisasi pengguna.
Cakupan Oauth yang diperlukan: api, write_repository, dan openid.
Nama host GitLab Anda, seperti gitlab.example.com, untuk menentukan endpoint web, API, otorisasi, dan token.
Sebelum memulai
Anda memerlukan:
Akses admin atau pemilik workspace ChatGPT.
Izin GitLab untuk membuat aplikasi Oauth: akses Pemilik grup untuk aplikasi milik grup, atau akses administrator instans untuk aplikasi yang berlaku di seluruh instans.
Nama host GitLab saja, tanpa https://, port, atau jalur. Gunakan host GitLab Self-Managed atau GitLab Dedicated, bukan gitlab.com.
Keputusan tentang tindakan GitLab yang perlu didukung ChatGPT dan Codex, seperti pencarian repositori, alur kerja permintaan penggabungan, alur kerja isu, pengeditan file, atau alur kerja Codex yang lebih luas.
Biarkan ChatGPT dan GitLab tetap terbuka di tab terpisah. Salin URI Pengalihan persis seperti yang ditampilkan di ChatGPT; jangan membuat atau mengubahnya.
Untuk membuka halaman Aplikasi dari Konsol admin, pilih workspace ChatGPT yang dituju, buka Plugin, lalu pilih Kelola Aplikasi Lama.
Nilai yang perlu disiapkan
Nama host GitLab: misalnya, gitlab.example.com.
URI Pengalihan: salin dari alur penyiapan templat ChatGPT.
ID Aplikasi Oauth GitLab.
Rahasia Oauth GitLab.
Cakupan Oauth: salin dari alur penyiapan templat 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.
Buat aplikasi Oauth GitLab di GitLab
Pilih tempat membuat aplikasi
Buka host GitLab Anda, seperti https://gitlab.example.com.
Pilih apakah Anda ingin membuat aplikasi yang berlaku di seluruh instans atau aplikasi milik grup. Pilihan ini menentukan siapa yang mengelola aplikasi; akses proyek tetap mengikuti izin GitLab milik pengguna yang memberikan otorisasi serta cakupan Oauth yang diberikan.
Untuk aplikasi yang berlaku di seluruh instans, buka Admin > Aplikasi. Untuk aplikasi milik grup, buka Pengaturan > Aplikasi pada grup.
Tambahkan detail aplikasi
Pilih Aplikasi baru atau Tambahkan aplikasi baru.
Masukkan nama aplikasi yang jelas, seperti GitLab Self-Managed atau GitLab Dedicated.
Di URI Pengalihan, tempelkan URI yang disalin dari ChatGPT tanpa perubahan.
Biarkan Konfidensial tetap aktif untuk aplikasi Oauth sisi server ini.
Konfigurasikan akses dan simpan
Untuk aplikasi yang berlaku di seluruh instans, GitLab menyarankan untuk memilih Tepercaya. Dengan begitu, permintaan otorisasi pengguna akan dilewati.
Pilih cakupan api, write_repository, dan openid.
Tinjau siapa yang dapat mengelola aplikasi, lalu pastikan pengguna GitLab yang memberikan otorisasi memiliki izin grup dan proyek yang sesuai.
Simpan aplikasi.
Persyaratan cakupan Oauth
Templat meminta cakupan Oauth berikut untuk tindakan GitLab yang diaktifkan di ChatGPT dan Codex:
api: diperlukan untuk operasi API GitLab yang disediakan aplikasi, termasuk tindakan permintaan penggabungan, isu, dan CI/CD.
write_repository: diperlukan untuk operasi tulis repositori melalui Git.
openid: diperlukan untuk informasi identitas dan keanggotaan OpenID Connect.
Salin kredensial Oauth GitLab
Di aplikasi GitLab yang telah disimpan, salin ID Aplikasi dan Rahasia. Perlakukan Rahasia sebagai kredensial. Jika bocor, perbarui di GitLab dan buat aplikasi workspace baru.
Selesaikan penyiapan di ChatGPT
Kembali ke tab penyiapan templat ChatGPT.
Tempelkan ID Aplikasi GitLab ke ID klien Oauth.
Tempelkan Rahasia GitLab ke Rahasia klien Oauth.
Pastikan kolom nama host GitLab hanya berisi nama host, seperti gitlab.example.com.
Pilih Buat draf.
Buka detail draf aplikasi, lalu tinjau Akses peran dan Konfigurasi tindakan.
Publikasikan dan kelola aplikasi untuk ChatGPT dan Codex
Membuat draf aplikasi tidak otomatis membuatnya tersedia bagi anggota. Setelah meninjau draf:
Pilih Publikasikan untuk draf aplikasi.
Buka Konsol admin, pilih workspace ChatGPT yang dituju, lalu buka Plugin dan pastikan GitLab tersedia bagi peran yang dituju.
Tinjau Akses peran untuk peran yang perlu menggunakan aplikasi.
Di Konfigurasi tindakan, tinjau tindakan baca dan tulis yang tersedia.
Di Konfigurasi persetujuan, pilih kapan pengguna harus menyetujui tindakan sebelum ChatGPT atau Codex menggunakan aplikasi.
Minta pengguna uji yang memiliki akses untuk membuka GitLab dari Direktori plugin atau Pengaturan > Plugin. Pastikan pengguna dapat menginstal plugin dan terhubung ke aplikasi yang dibuat dari templat GitLab Self-Managed.
Pengaturan persetujuan aplikasi ini berlaku untuk percakapan ChatGPT dan utas Codex.
Siapkan aktivitas GitLab untuk peninjauan kode Codex
Setelah aplikasi dipublikasikan, konfigurasikan aktivitas GitLab di Codex jika Anda berencana menggunakan peninjauan kode Codex. Penyiapan aktivitas ini mengonfigurasi peristiwa webhook yang diperlukan.
Konfigurasikan akun layanan workspace. Biarkan Codex membuat akun tersebut, atau berikan token akses pribadi untuk akun layanan yang sudah ada.
Aktifkan Aktivitas GitLab untuk proyek atau salah satu grup induknya.
Jika Codex perlu menjalankan tugas pemrograman atau menggunakan konfigurasi khusus proyek, buat lingkungan proyek.
Aplikasi GitLab menggunakan Oauth pengguna untuk operasi baca dan tindakan yang diaktifkan di ChatGPT dan Codex. Untuk operasi tulis dalam peninjauan Codex di GitLab Self-Managed atau GitLab Dedicated, token akun layanan yang dikelola workspace menentukan identitas yang digunakan Codex serta proyek tempat Codex dapat berkomentar atau memberikan reaksi.
Baca selengkapnya: Meninjau permintaan penggabungan GitLab dengan Codex.
Hubungkan dan uji aplikasi GitLab
Sebagai pengguna yang memiliki akses, buka GitLab dari Direktori plugin atau Pengaturan > Plugin. Pilih Instal Plugin, lalu pilih Hubungkan.
Jika workspace Anda memiliki lebih dari satu aplikasi GitLab, pilih aplikasi untuk host GitLab Self-Managed atau GitLab Dedicated ini.
Berikan otorisasi pada aplikasi Oauth GitLab saat diminta.
Jalankan tindakan baca sederhana terlebih dahulu di ChatGPT atau Codex, seperti menampilkan daftar proyek yang dapat diakses atau mengambil permintaan penggabungan yang diketahui.
Jika tindakan tulis diaktifkan, uji pada proyek berisiko rendah dan di setiap produk tempat Anda berencana menggunakannya sebelum diterapkan secara lebih luas.
Nama host dan cara kerja Oauth
Aplikasi menggunakan nama host untuk menentukan endpoint GitLab. Masukkan hanya nama host, seperti gitlab.example.com. Jangan sertakan https://, jalur API atau repositori, port, atau gitlab.com. Templat ini ditujukan untuk GitLab Self-Managed atau GitLab Dedicated. Untuk GitLab.com (SaaS), gunakan aplikasi GitLab.
Pemecahan masalah penyiapan aplikasi GitLab Self-Managed
URI Pengalihan tidak cocok: Pastikan URI Pengalihan aplikasi Oauth GitLab sama persis dengan URI Pengalihan yang ditampilkan di ChatGPT.
ChatGPT tidak dapat membuat atau menyimpan draf aplikasi: Pastikan nama host, ID Aplikasi, Rahasia, dan URI Pengalihan telah diisi.
Autentikasi berhasil, tetapi panggilan ke proyek gagal: Pastikan pengguna GitLab yang memberikan otorisasi dapat mengakses proyek dan aplikasi Oauth memiliki cakupan yang ditentukan templat.
API mengembalikan kode 403 atau pesan izin tidak memadai: Pastikan akun GitLab yang terhubung memiliki izin proyek atau grup yang diperlukan dan aplikasi Oauth mencakup cakupan yang diwajibkan templat.
Tidak ada proyek yang dapat diakses: Pastikan pengguna memiliki akses proyek, terhubung ke instans GitLab yang dituju, dan memilih aplikasi GitLab yang benar di ChatGPT atau Codex.