Menginstal ekstensi Cloud Code for VS Code

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 paling cocok digunakan dengan bahasa berikut:

    • NodeJS (dukungan bawaan; tidak perlu melakukan tindakan apa pun)
    • Go
    • Python
    • Java
    • .NET

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

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

    • Jika Anda membangun 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 untuk pengembangan lokal dengan Cloud Code.

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

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

Instal Cloud Code

Instal ekstensi Google Cloud Code dari Visual Studio Code Marketplace.

Atau, buka tampilan Extensions di VS Code:

  1. Klik Ikon ekstensi Ekstensi atau tekan Ctrl/Cmd+Shift+X.

  2. Telusuri Google Cloud Code.

    Ekstensi Cloud Code di marketplace VSC

  3. Klik Instal.

  4. Jika diminta, mulai ulang VS Code.

    Setelah ekstensi berhasil diinstal, ikon Cloud Code ditambahkan ke kolom aktivitas dan siap digunakan. Anda dapat mengonfigurasi lebih lanjut penginstalan Cloud Code dengan menentukan preferensi menggunakan panel tugas aplikasi tingkat teratas: buka Code > Settings > Settings > Extensions, lalu cari 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 dependensi versi kustom, tetapi Anda harus menginstal dependensi sendiri agar Cloud Code berfungsi.

Untuk menggunakan versi kustom dependensi Cloud Code:

  1. Klik Setelan Kelola > Setelan, lalu tetapkan Dependensi Otomatis (cloudcode.autoDependencies) ke off.

  2. Instal dependensi berikut di PATH Anda:

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 memilih untuk menginstal gcloud CLI secara manual, lihat Menginstal gcloud CLI.

Opsional: Verifikasi vsix Cloud Code menggunakan VsixSignTool

Untuk memverifikasi vsix Cloud Code 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, lalu buka Ikon ekstensi di VSC Extensions > Cloud Code.

  4. Di tab Detail, di bagian Sumber Daya Ekstensi, 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 lebih memilih untuk memverifikasi versi yang berbeda dari versi terbaru, klik tab Histori Versi dan pilih versi lain untuk didownload.

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

    PATH_TO_VSIXSIGNTOOL verify PATH_TO_DOWNLOADED_VSIX

  8. Pastikan outputnya cocok dengan berikut ini:

    VsixSignTool Success: Package PATH_TO_DOWNLOADED_VSIX is valid.

Autentikasi 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 tidak login ke Google Cloud, ikuti langkah-langkah berikut untuk login:

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

  2. Jika ini pertama kalinya Anda terhubung ke Google Cloud di IDE, Anda akan diminta untuk menambahkan https://accounts.google.com ke Domain Tepercaya. Klik Konfigurasi Domain Tepercaya di dialog yang muncul:

    Dialog Konfigurasi Domain Tepercaya

  3. Ikuti petunjuk untuk login menggunakan browser web Anda.

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

Masalah yang diketahui: Browser Edge dialihkan ke HTTPS saat callback autentikasi

Saat menggunakan browser Microsoft Edge untuk mengautentikasi kredensial Anda, Anda mungkin melihat bahwa browser Edge mengalihkan URL http://localhost:3000 ke https://localhost:3000. Hal ini akan menghasilkan 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 Hapus kebijakan keamanan domain.

  3. Masukkan localhost, lalu klik Hapus.

Logout dari Google Cloud

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

Mengubah project Google Cloud aktif

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

    Nama project aktif di status bar

  2. Di menu Pilih Cepat yang muncul, pilih sync_alt Ganti 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 mesin Anda jika Anda 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 lebih lanjut Kredensial Default Aplikasi dan Google API, lihat Mengautentikasi ke layanan Cloud menggunakan library klien.

Langkah berikutnya

Dapatkan Dukungan

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