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. Berikan nama host GitLab dan kredensial aplikasi Oauth, tinjau draf aplikasi, lalu publikasikan untuk anggota workspace yang memenuhi syarat. Setelah dipublikasikan, tindakan aplikasi yang diaktifkan tersedia dalam percakapan ChatGPT dan sesi Codex.
Untuk ringkasan perilaku GitLab yang didukung, ketersediaan, izin, penggunaan data, dan persyaratan jaringan, lihat: Menghubungkan GitLab ke ChatGPT dan Codex.
Yang sedang Anda siapkan
Anda 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, misalnya gitlab.example.com, untuk menentukan endpoint web, API, otorisasi, dan token.
Sebelum memulai
Anda memerlukan:
Akses sebagai admin atau pemilik workspace ChatGPT.
Izin GitLab untuk membuat aplikasi Oauth: akses Pemilik grup untuk aplikasi milik grup, atau akses administrator instans untuk aplikasi seluruh instans.
Hanya nama host GitLab, 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.
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 > 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.
Membuat aplikasi Oauth GitLab di GitLab
Pilih tempat untuk membuat aplikasi
Buka host GitLab Anda, misalnya https://gitlab.example.com.
Pilih apakah akan membuat aplikasi seluruh instans atau aplikasi milik grup. Pilihan ini menentukan siapa yang mengelola aplikasi; akses proyek tetap mengikuti izin GitLab pengguna yang memberikan otorisasi dan cakupan Oauth yang diberikan.
Untuk aplikasi seluruh instans, buka Admin > Aplikasi. Untuk aplikasi milik grup, buka Pengaturan > Aplikasi grup.
Tambahkan detail aplikasi
Pilih Aplikasi baru atau Tambahkan aplikasi baru.
Masukkan nama aplikasi yang jelas, misalnya GitLab Self-Managed atau GitLab Dedicated.
Di URI Pengalihan, tempel URI persis yang disalin dari ChatGPT.
Biarkan Rahasia tetap diaktifkan untuk aplikasi Oauth sisi server ini.
Konfigurasikan akses dan simpan
Untuk aplikasi seluruh instans, GitLab menyarankan memilih Tepercaya. Tindakan ini melewati prompt otorisasi pengguna.
Pilih cakupan api, write_repository, dan openid.
Tinjau siapa yang dapat mengelola aplikasi dan 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 oleh aplikasi, termasuk tindakan permintaan penggabungan, isu, dan CI/CD.
write_repository: diperlukan untuk operasi penulisan 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 terekspos, perbarui di GitLab dan buat aplikasi workspace baru.
Selesaikan penyiapan di ChatGPT
Kembali ke tab penyiapan templat ChatGPT.
Tempel ID Aplikasi GitLab ke ID klien Oauth.
Tempel Rahasia GitLab ke rahasia klien Oauth.
Pastikan nama host GitLab hanya berisi nama host, misalnya gitlab.example.com.
Pilih Buat draf.
Buka detail draf aplikasi, lalu tinjau Akses peran dan Konfigurasikan 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 Pengaturan workspace > Plugin, lalu pastikan GitLab tersedia bagi peran yang dimaksud.
Tinjau Akses peran untuk peran yang perlu menggunakan aplikasi.
Di Konfigurasikan tindakan, tinjau tindakan baca dan tulis yang tersedia.
Di Konfigurasikan 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 Self-Managed GitLab.
Pengaturan persetujuan aplikasi ini berlaku untuk percakapan ChatGPT dan utas Codex.
Siapkan aktivitas GitLab untuk tinjauan kode Codex
Setelah aplikasi dipublikasikan, konfigurasikan aktivitas GitLab di Codex jika Anda berencana menggunakan tinjauan kode Codex. Penyiapan aktivitas ini mengonfigurasi peristiwa webhook yang diperlukan.
Konfigurasikan akun layanan workspace. Biarkan Codex membuat akun 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 pengodean atau menggunakan penyiapan khusus proyek, buat lingkungan proyek.
Aplikasi GitLab menggunakan Oauth pengguna untuk pembacaan dan tindakan yang diaktifkan di ChatGPT dan Codex. Untuk penulisan tinjauan Codex di GitLab Self-Managed atau GitLab Dedicated, token akun layanan yang dikelola workspace menentukan identitas dan 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 mencantumkan proyek yang dapat diakses atau mengambil permintaan penggabungan yang diketahui.
Jika tindakan tulis diaktifkan, ujilah pada proyek berisiko rendah dan di setiap produk tempat Anda akan menggunakannya sebelum meluncurkannya secara lebih luas.
Perilaku nama host dan Oauth
Aplikasi menggunakan nama host untuk menentukan endpoint GitLab. Masukkan hanya host, misalnya gitlab.example.com. Jangan sertakan https://, jalur API atau repositori, port, maupun gitlab.com. Templat ini ditujukan untuk GitLab Self-Managed atau GitLab Dedicated. Untuk GitLab.com (SaaS), gunakan aplikasi GitLab.
Memecahkan 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 proyek gagal: Pastikan pengguna GitLab yang memberikan otorisasi dapat mengakses proyek dan aplikasi Oauth memiliki cakupan templat.
API menampilkan 403 atau izin tidak memadai: Pastikan akun GitLab yang terhubung memiliki izin proyek atau grup yang diperlukan dan aplikasi Oauth menyertakan cakupan templat yang diperlukan.
Tidak ada proyek yang dapat diakses: Pastikan pengguna memiliki akses proyek, terhubung ke instans GitLab yang dimaksud, dan memilih aplikasi GitLab yang benar di ChatGPT atau Codex.