Halaman ini menjelaskan cara mengonfigurasi proxy Developer Connect.
Proxy Developer Connect meningkatkan cara Developer Connect menangani autentikasi dan akses jaringan ke sistem pengelolaan kode sumber (SCM) dan endpoint HTTP arbitrer (Pratinjau). Saat Anda mengaktifkan proxy untuk koneksi, Developer Connect menggunakan server proxy untuk memproksi permintaan Git, seperti git clone, atau panggilan API ke endpoint HTTP (Pratinjau). Saat Anda membuat koneksi menggunakan
konsolGoogle Cloud , proxy diaktifkan secara default. Dengan cara ini, Anda hanya perlu memberikan izin IAM kepada pengguna atau akun layanan, bukan mengelola token akses di Secret Manager.
Misalnya, mengaktifkan proxy Developer Connect pada koneksi memungkinkan Anda melakukan hal berikut:
- Gunakan penyesuaian kode Gemini Code Assist dengan SCM di jaringan yang dihosting secara pribadi, termasuk jaringan lokal.
- Meng-clone kode sumber dari SCM eksternal menggunakan Google Cloud autentikasi dan izin Identity and Access Management.
- Gunakan Agen Peninjauan Kode Gemini dengan SCM di jaringan yang dihosting secara pribadi, termasuk jaringan lokal (Pratinjau).
Ada dua komponen proxy Developer Connect:
Proxy Git
Untuk koneksi ke sistem pengelolaan kode sumber (SCM)
Proxy HTTP (Pratinjau)
Untuk koneksi ke endpoint HTTP arbitrer
Kedua komponen ini diaktifkan menggunakan setelan yang sama. Proxy Git memberi Anda lebih banyak kontrol atas penggunaan.
Sebelum memulai
Pastikan Anda memiliki setidaknya satu koneksi di Developer Connect ke SCM seperti GitHub, GitLab, atau Bitbucket.
Untuk mendapatkan izin yang
diperlukan untuk mengonfigurasi proxy Developer Connect untuk koneksi,
minta administrator untuk memberi Anda
Peran IAM Developer Connect Admin (developerconnect.admin)
pada pengguna yang mengaktifkan atau menonaktifkan proxy Developer Connect.
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.
Untuk mendapatkan izin yang diperlukan untuk mengirim permintaan ke proxy untuk koneksi, minta administrator untuk memberi Anda peran IAM berikut pada akun pengguna atau akun layanan yang mengirim permintaan Git:
-
Membuat permintaan baca Git seperti
git clone: Git Proxy Reader (roles/developerconnect.gitProxyReader) -
Membuat permintaan penulisan Git seperti
git push: Pengguna Proxy Git (roles/developerconnect.gitProxyUser)
Melihat dan memperbarui setelan proxy Developer Connect
Proxy Developer Connect diaktifkan secara default. Jika diaktifkan, proxy Git dan proxy HTTP akan diaktifkan.
Untuk melihat dan memperbarui setelan proxy, lakukan hal berikut:
Konsol
Di konsol Google Cloud , buka Developer Connect.
Klik tab Koneksi, lalu klik nama koneksi yang ingin Anda gunakan.
Di halaman Connection details, klik tab Additional configuration.
Klik tombol Developer Connect proxy untuk menonaktifkan atau mengaktifkan kembali fitur Developer Connect proxy.
Proxy Developer Connect diaktifkan secara default.
Google Cloud CLI
Mengaktifkan setelan proxy Developer Connect untuk koneksi
Untuk mengaktifkan proxy Developer Connect untuk koneksi, aktifkan setelan
proxy dengan menjalankan perintah gcloud developer-connect connections update:
gcloud developer-connect connections update CONNECTION_NAME \
--location=REGION \
--git-proxy-config-enabled
Menonaktifkan proxy Developer Connect untuk koneksi
Untuk menonaktifkan proxy Developer Connect untuk koneksi, nonaktifkan setelan proxy dengan menjalankan perintah gcloud developer-connect connections update:
gcloud developer-connect connections update CONNECTION_NAME \
--location=REGION \
--no-git-proxy-config-enabled
Melihat setelan proxy untuk koneksi
Untuk melihat detail tentang setelan proxy Developer Connect untuk koneksi, jalankan perintah gcloud developer-connect connections describe:
gcloud developer-connect connections describe CONNECTION_NAME \
--location=REGION
Ganti kode berikut:
- CONNECTION_NAME dengan nama koneksi Anda.
- REGION dengan region koneksi Anda.
Bagian lain dari dokumen ini hanya mencakup petunjuk proxy Git.
Menemukan URI proxy Git
Dengan mengaktifkan proxy Developer Connect, Anda dapat menemukan URI proxy Git untuk koneksi dengan melakukan hal berikut:
Konsol
Di konsol Google Cloud , buka Developer Connect.
Klik tab Koneksi, lalu klik nama koneksi yang ingin Anda gunakan.
Di halaman Connection details, klik tab Repositories.
Temukan repositori untuk koneksi Anda, lalu klik Copy git proxy URL.
Google Cloud CLI
Untuk mendapatkan URI proxy Git, jalankan perintah
gcloud developer-connect connections git-repository-links describe:
gcloud developer-connect connections git-repository-links describe REPOSITORY_NAME \
--connection=CONNECTION_NAME \
--location=REGION
Ganti kode berikut:
- REPOSITORY_NAME dengan nama repositori Anda.
- CONNECTION_NAME dengan nama koneksi Anda.
- REGION dengan region koneksi Anda.
Developer Connect API
URI proxy Git terletak di kolom git_proxy_url pada
GitRepositoryLink
untuk koneksi Anda.
Mengirim permintaan ke proxy Git
Setelah memiliki URI proxy Git, Anda dapat mengirim permintaan ke proxy Git dengan melakukan hal berikut:
Konfigurasi Git CLI untuk menggunakan helper kredensial Google Cloud CLI:
git config --global credential.'https://*.developerconnect.dev'.helper gcloud.shKirim permintaan, seperti
git clone, ke proxy Git:git clone https://REGION.developerconnect.dev/PROJECT_NAME/CONNECTION_NAME/REPOSITORY NAMEJika tidak ingin menggunakan credential helper, Anda dapat menyematkan token akses cloud ke dalam permintaan:
git clone https://unused:$(gcloud auth print-access-token)@REGION-git.developerconnect.dev/PROJECT_NAME/CONNECTION_NAME/REPOSITORY NAMEGanti kode berikut:
- REPOSITORY_NAME dengan nama repositori Anda.
- CONNECTION_NAME dengan nama koneksi Anda.
- REGION dengan region koneksi Anda.