Mengonfigurasi dan menggunakan proxy Developer Connect

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), endpoint HTTP arbitrer (Pratinjau), dan koneksi ke penyedia alat developer non-Google, menggunakan penghubung akun .

Saat Anda mengaktifkan proxy untuk koneksi sistem atau konektor akun, Developer Connect menggunakan server proxy untuk mengeluarkan 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 autentikasi dan izin Identity and Access Management. Google Cloud

• Gunakan Agen Peninjauan Kode Gemini dengan SCM di jaringan yang dihosting secara pribadi, termasuk jaringan lokal (Pratinjau).

Developer Connect mendukung dua jenis proxy:

• Proxy pada koneksi sistem

  Proxy koneksi sistem mencakup hal berikut:

  • Proxy Git

  Untuk koneksi ke sistem pengelolaan kode sumber (SCM)

  • Proxy HTTP (Pratinjau)

  Untuk koneksi ke endpoint HTTP arbitrer

• Proxy untuk konektor akun (Pratinjau)

  Proxy Developer Connect dapat digunakan dengan konektor akun.

Semua fitur ini diaktifkan menggunakan setelan yang sama.

Sebelum memulai

Pastikan Anda memiliki setidaknya satu koneksi sistem di Developer Connect (ke SCM seperti GitHub, GitLab, atau Bitbucket, atau ke endpoint HTTP) atau konektor akun.

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, untuk koneksi sistem: Git Proxy Reader (roles/developerconnect.gitProxyReader)
• Buat permintaan penulisan Git seperti git push, untuk koneksi sistem: Pengguna Proxy Git (roles/developerconnect.gitProxyUser)
• Membuat permintaan baca dan tulis Git untuk penghubung akun: Pengguna OAuth Penghubung Akun (roles/developerconnect.oauthUser)

Mengaktifkan dan menonaktifkan setelan proxy Developer Connect untuk koneksi sistem

Saat Anda membuat koneksi sistem menggunakan konsol Google Cloud , proxy diaktifkan secara default. Jika diaktifkan, proxy Git dan proxy HTTP akan diaktifkan.

Untuk melihat dan memperbarui setelan proxy, lakukan hal berikut:

Konsol

1. Di konsol Google Cloud , buka Developer Connect.

   Buka Developer Connect

2. Klik tab Koneksi, lalu klik nama koneksi yang ingin Anda gunakan.

3. Di halaman Connection details, klik tab Additional configuration.

4. 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 dokumen ini hanya mencakup petunjuk proxy Git.

Mengaktifkan dan menonaktifkan setelan proxy Developer Connect untuk konektor akun

Saat Anda membuat konektor akun menggunakan konsol Google Cloud , proxy diaktifkan secara default. Jika diaktifkan, proxy Git dan proxy HTTP akan diaktifkan.

Untuk melihat dan memperbarui setelan proxy, lakukan hal berikut:

Konsol

1. Di konsol Google Cloud , buka Developer Connect.

   Buka Developer Connect

2. Klik tab Konektor Akun, lalu klik nama konektor akun yang ingin Anda gunakan.

3. Di halaman Connector details, klik tab Configuration.

4. 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 konektor akun

Untuk mengaktifkan proxy Developer Connect untuk konektor akun, jalankan perintah berikut:

gcloud alpha developer-connect account-connectors update CONNECTOR_NAME \
  --location=REGION \
  --proxy-config-enabled

Menonaktifkan proxy Developer Connect untuk konektor akun

Untuk menonaktifkan proxy Developer Connect untuk koneksi, jalankan perintah berikut:

gcloud alpha developer-connect account-connectors update CONNECTOR_NAME \
  --location=REGION \
  --no-proxy-config-enabled

Melihat setelan proxy untuk konektor akun

Untuk melihat detail tentang setelan proxy Developer Connect untuk koneksi, jalankan perintah berikut:

gcloud alpha developer-connect account-connectors describe CONNECTOR_NAME \
  --location=REGION

Ganti kode berikut:

• CONNECTOR_NAME dengan nama konektor akun Anda.
• REGION dengan region konektor akun Anda.

Menemukan URI proxy Git

Untuk koneksi sistem

Dengan mengaktifkan proxy Developer Connect, Anda dapat menemukan URI proxy Git untuk koneksi sistem Anda dengan melakukan hal berikut:

Konsol

1. Di konsol Google Cloud , buka Developer Connect.

   Buka Developer Connect

2. Klik tab Koneksi, lalu klik nama koneksi yang ingin Anda gunakan.

3. Di halaman Connection details, klik tab Repositories.

4. 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.

Untuk konektor akun

Dengan mengaktifkan proxy Developer Connect, Anda dapat membuat URI proxy Git untuk konektor akun menggunakan format berikut:

https://REGION-git.developerconnect.dev/a/PROJECT_ID/CONNECTOR_ID/REPO_PATH

Dengan:

• REGION adalah region tempat Anda membuat konektor akun.

• PROJECT_ID adalah ID project tempat Anda membuat konektor akun.

• CONNECTOR_ID adalah ID konektor akun tempat Anda mengaktifkan proxy Git.

• REPO_PATH adalah semua yang ada setelah domain di URL git untuk repositori Anda.

  Misalnya, jika URL repositori adalah https://github.com/myusername/test-repo.git, REPO_PATH adalah myusername/test-repo.

Mengirim permintaan ke proxy Git

Setelah memiliki URI proxy Git, Anda dapat mengirim permintaan ke proxy Git dengan melakukan hal berikut:

1. Konfigurasi Git CLI untuk menggunakan helper kredensial Google Cloud CLI:

   git config --global credential.'https://*.developerconnect.dev'.helper gcloud.sh

2. Mengirim permintaan ke proxy Git. Contoh ini adalah permintaan git clone.

   Untuk konektor akun:

   git clone https://REGION-git.developerconnect.dev/a/PROJECT_NAME/ACCOUNT_CONNECTOR_NAME/ACCOUNT_CONNECTOR_NAME/REPO_PATH
   

   Jika tidak ingin menggunakan helper kredensial, Anda dapat menyematkan token akses cloud ke dalam permintaan:

   git clone https://unused:$(gcloud auth print-access-token)@REGION-git.developerconnect.dev/a/PROJECT_NAME/ACCOUNT_CONNECTOR_NAME/REPO_PATH
   
   

   Untuk koneksi sistem:

   git clone https://REGION.developerconnect.dev/PROJECT_NAME/CONNECTION_NAME/REPOSITORY_NAME
   

   Jika tidak ingin menggunakan helper kredensial, Anda dapat menyematkan token akses cloud ke dalam permintaan:

   git clone https://unused:$(gcloud auth print-access-token)@REGION.developerconnect.dev/PROJECT_NAME/CONNECTION_NAME/REPOSITORY_NAME
   

   Ganti kode berikut:

   • REGION dengan region konektor akun Anda.
   • PROJECT_NAME dengan nama project tempat Anda membuat konektor akun. Google Cloud
   • ACCOUNT_CONNECTOR_NAME dengan nama konektor akun Anda.
   • CONNECTION_NAME dengan nama koneksi sistem Anda.
   • REPOSITORY_NAME dengan nama repositori Anda.
   • REPO_PATH dengan jalur ke repositori Anda, misalnya my-org/my-repo.