Menginstal ekstensi Cloud Code for VS Code

Catatan: Kami telah menyatukan alat kami ke dalam satu platform multi-agen yang disebut Antigravity, dengan Antigravity CLI kini tersedia. Mulai 18 Juni 2026, Ekstensi IDE Gemini Code Assist dan Gemini CLI berhenti menayangkan permintaan untuk Gemini Code Assist untuk individu, Google AI Pro, dan Google AI Ultra. Pengguna yang terpengaruh harus bermigrasi ke Antigravity dan Antigravity CLI. Untuk mempelajari lebih lanjut, lihat halaman penghentian penggunaan .

Ekstensi Cloud Code for VS Code menambahkan dukungan untuk Google Cloud pengembangan ke VS Code.

Sebelum memulai

Sebelum menginstal Cloud Code, pastikan alat berikut telah diinstal dan disiapkan di sistem Anda:

1. Instal dan siapkan Visual Studio Code di komputer Anda.

2. Instal dan konfigurasi dukungan bahasa.

   Ekstensi Cloud Code berfungsi paling baik dengan bahasa berikut:

   • NodeJS (dukungan bawaan; tidak ada tindakan yang diperlukan)
   • Go
   • Python
   • Java
   • .NET

3. Instal Git. Git diperlukan untuk menyalin sampel ke komputer Anda.

4. Instal klien Docker dan tambahkan ke variabel lingkungan PATH:

   • Jika Anda membuat build secara eksklusif menggunakan Cloud Build atau Jib, Anda dapat melewati penginstalan Docker.
   • Jika Anda menggunakan WSL tetapi tidak dapat menginstal Docker for Desktop, gunakan minikube sebagai gantinya untuk pengembangan lokal dengan Cloud Code.

5. Jika Anda menggunakan Google Cloud, buat Google Cloud project lalu aktifkan penagihan.

   Project memungkinkan Anda mengumpulkan resource terkait untuk satu aplikasi di satu tempat, mengelola API, mengaktifkan Google Cloud layanan, menambahkan dan menghapus kolaborator, serta mengelola izin untuk Google Cloud resource.

Menginstal Cloud Code

Catatan: Saat menginstal Cloud Code, ekstensi Gemini Code Assist juga diinstal secara default.

Instal ekstensi Google Cloud Code dari Visual Studio Code Marketplace.

Atau, buka tampilan Extensions di VS Code:

1. Klik Extensions atau tekan Ctrl/Cmd+Shift+X.

2. Telusuri Google Cloud Code.

   

3. Klik Install.

4. Jika diminta, mulai ulang VS Code.

   Setelah ekstensi berhasil diinstal, ikon Cloud Code akan ditambahkan ke panel aktivitas dan siap digunakan. Anda dapat mengonfigurasi lebih lanjut penginstalan Cloud Code dengan menentukan preferensi menggunakan panel tugas aplikasi tingkat atas: buka Code > Settings > Settings > Extensions dan telusuri Gemini Code Assist + Google Cloud Code.

Versi dependensi kustom

Secara default, Cloud Code mengaktifkan Dependensi otomatis dan menginstal beberapa dependensi command line untuk Anda secara otomatis. Jika menonaktifkan dependensi otomatis, Anda dapat menggunakan versi dependensi kustom, tetapi Anda harus menginstal dependensi sendiri agar Cloud Code berfungsi.

Untuk menggunakan versi dependensi Cloud Code kustom:

1. Klik setelan Manage > Settings , lalu tetapkan Auto Dependencies (cloudcode.autoDependencies) ke off.

2. Instal dependensi berikut di PATH Anda:

   • kubectl
   • Skaffold
   • minikube untuk pengembangan lokal

Menginstal Google Cloud CLI

Saat pertama kali menggunakan fitur yang memerlukan gcloud CLI, Anda akan diberi opsi untuk mempelajari cara menginstal CLI dari IDE, menggunakan penginstalan yang ada, atau melanjutkan dengan dependensi terkelola. Jika Anda lebih suka menginstal gcloud CLI secara manual, lihat Menginstal gcloud CLI.

Opsional: Memverifikasi Cloud Code vsix menggunakan VsixSignTool

Untuk memverifikasi Cloud Code vsix dengan VsixSignTool, lakukan langkah-langkah berikut:

1. Pastikan Anda menggunakan hal berikut:

   • Pengelola paket Nuget
   • OS Windows
   • Rilis produksi Cloud Code

2. Instal Microsoft VsixSignTool dan catat jalur penginstalannya.

3. Buka VS Code dan buka Extensions > Cloud Code.

4. Di tab Details, di bagian Extension Resources, klik Marketplace.

5. Di halaman Marketplace di browser Anda, di bagian Resources, klik Download Extension untuk mendownload versi paket Cloud Code. Tindakan ini akan mendownload versi paket Cloud Code, yang memiliki ekstensi file .vsix, ke direktori download default Anda.

6. Jika Anda ingin memverifikasi versi yang berbeda dari versi terbaru, klik tab Version History dan pilih versi lain untuk didownload.

   Catatan: Versi Cloud Code paling awal yang dapat Anda verifikasi dengan VsixSignTool adalah 1.20.2.

7. Setelah download selesai, buka jendela terminal dan jalankan perintah berikut:

   PATH_TO_VSIXSIGNTOOL verify PATH_TO_DOWNLOADED_VSIX
   

8. Pastikan output-nya cocok dengan yang berikut:

   VsixSignTool Success: Package PATH_TO_DOWNLOADED_VSIX is valid.

Mengautentikasi kredensial untuk Google Cloud

Untuk membantu pengembangan aplikasi dengan Google Cloud API, saat Anda login ke gcloud CLI, Kredensial Default Aplikasi Anda akan diperbarui.

Login ke Google Cloud

Jika Anda belum login ke Google Cloud, ikuti langkah-langkah berikut untuk login:

1. Di status bar Cloud Code, klik Cloud Code - Sign in.

2. Jika ini adalah kali pertama Anda terhubung ke Google Cloud di IDE, Anda diminta untuk menambahkan https://accounts.google.com ke Domain Tepercaya. Klik Configure Trusted Domains di dialog yang muncul:

   

3. Ikuti petunjuk untuk login menggunakan browser web Anda.

4. Saat diminta untuk mengizinkan Cloud Code mengakses Akun Google Anda, klik Allow.

Masalah umum: Browser Edge mengalihkan ke HTTPS pada callback autentikasi

Saat menggunakan browser Microsoft Edge untuk mengautentikasi kredensial, Anda mungkin melihat bahwa browser Edge mengalihkan URL http://localhost:3000 ke https://localhost:3000. Hal ini menyebabkan pesan kegagalan berikut:

The connection for this site is not secure. localhost sent an invalid response. Try running Windows Network Diagnostics. ERR_SSL_PROTOCOL_ERROR.

Untuk mengatasi masalah ini, Anda dapat mengecualikan localhost dari pengalihan:

1. Di kolom URL browser Edge Anda, masukkan edge://net-internals/#hsts.

2. Buka bagian Delete domain security policies.

3. Masukkan localhost, lalu klik Delete.

Logout dari Google Cloud

1. Klik Cloud Code , lalu luaskan Help and Feedback.
2. Klik Sign Out of Google Cloud, lalu pilih Sign-out saat diminta.
3. Atau, Anda dapat logout menggunakan Command Palette. Tekan Ctrl/Cmd+Shift+P atau klik View > Command Palette, lalu klik Sign out of all accounts in Google Cloud SDK.

Mengubahproject aktif Google Cloud

1. Di status bar Cloud Code, klik nama project aktif.

   

2. Di menu Pilih Cepat yang muncul, pilih sync_alt Switch Project.

3. Pilih project atau masukkan kata kunci di kotak penelusuran untuk memfilter project.

Mengautentikasi kredensial untuk men-debug aplikasi secara lokal

Selain langkah-langkah autentikasi di bagian Login ke Google Cloud, Anda harus mengautentikasi kredensial untuk men-debug aplikasi secara lokal di IDE yang melakukan panggilan Google API.

Jika Anda tidak mengautentikasi kredensial untuk men-debug aplikasi, pesan error akan muncul di IDE saat Anda mencoba menjalankan/men-debug aplikasi lokal yang mencoba melakukan panggilan ke Google API.

Untuk mengautentikasi kredensial Anda untuk men-debug aplikasi secara lokal, lakukan langkah-langkah berikut:

1. Instal gcloud ke komputer Anda jika belum melakukannya.

2. Jalankan perintah berikut:

   gcloud auth application-default login
   

3. Setelah selesai men-debug secara lokal, Anda dapat logout dengan menjalankan perintah berikut:

   gcloud auth application-default revoke
   

Untuk mempelajari Kredensial Default Aplikasi dan Google API lebih lanjut, lihat Mengautentikasi ke layanan Cloud menggunakan library klien.

Langkah berikutnya

• Membuat aplikasi
• Membuat dan mengonfigurasi cluster GKE
• Mengembangkan API menggunakan Apigee

Dapatkan Dukungan

Untuk mengirim masukan, laporkan masalah di GitHub, atau ajukan pertanyaan di Stack Overflow.