Menginstal ekstensi Cloud Code for VS Code

Ekstensi Cloud Code for VS Code menambahkan dukungan untuk pengembangan Google Cloud 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. Menginstal dan mengonfigurasi dukungan bahasa.

    Ekstensi Cloud Code berfungsi paling baik 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 mem-build secara eksklusif menggunakan Cloud Build atau Jib, Anda dapat melewati penginstalan Docker.
    • Jika Anda menggunakan Windows Home, untuk mengetahui langkah-langkah menyiapkan klien Docker, lihat panduan Docker Desktop untuk Windows Home.
    • Jika Anda menggunakan WSL, tetapi tidak dapat menginstal Docker untuk 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 Google Cloud, menambahkan dan menghapus kolaborator, serta mengelola izin untuk resource 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 akan ditambahkan ke panel aktivitas dan siap digunakan. Anda dapat lebih lanjut mengonfigurasi penginstalan Cloud Code dengan menentukan preferensi menggunakan taskbar 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 kustom dependensi, tetapi Anda harus menginstal dependensi sendiri agar Cloud Code berfungsi.

Untuk menggunakan versi kustom dependensi Cloud Code:

  1. Klik setelan Kelola > Setelan, lalu tetapkan Auto Dependencies (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: Memverifikasi 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 dan buka Ikon ekstensi di VSC Extensions > Cloud Code.

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

  5. Di halaman Marketplace di browser, pada bagian Referensi, klik Download Ekstensi untuk mendownload versi Cloud Code yang dipaketkan. Tindakan ini akan mendownload versi Cloud Code yang dipaketkan, 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 Version History 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 output cocok dengan berikut ini:

    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 pertama kalinya Anda terhubung ke Google Cloud di IDE, Anda akan diminta untuk menambahkan https://accounts.google.com ke Trusted Domain. Klik Konfigurasikan 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 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, 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 Logout dari Google Cloud dan saat diminta, pilih Logout.
  3. Atau, Anda dapat logout menggunakan Palette 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 yang aktif

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

    Nama project aktif di status bar

  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 aplikasi proses debug, 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 guna 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 selanjutnya

Dapatkan Dukungan

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