Menginstal ekstensi Cloud Code untuk VS Code

Ekstensi Cloud Code untuk 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:

  3. Instal Git. Git diperlukan untuk menyalin sampel 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 melewatkan proses penginstalan Docker.
    • Jika Anda menggunakan Windows Home, guna mengetahui langkah-langkah penyiapan klien Docker Anda, 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.

    Dengan project, Anda dapat 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 Install (Instal).

  4. Jika diminta, mulai ulang VS Code.

    Setelah ekstensi berhasil diinstal, ikon Cloud Code ditambahkan ke panel aktivitas dan siap digunakan. Anda dapat mengonfigurasi penginstalan Cloud Code lebih lanjut dengan menentukan preferensi menggunakan taskbar aplikasi level atas: Code > Preferences > Settings > Extensions > Cloud Code.

Versi kustom dependensi

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 dapat berfungsi.

Untuk menggunakan versi kustom dependensi Cloud Code:

  1. Klik settings Manage > Settings, lalu tetapkan Auto Dependencies (cloudcode.autoDependencies) ke off.
  2. Instal dependensi berikut di PATH Anda:

Opsional: Memverifikasi vsix Cloud Code 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 Ikon ekstensi di VSC Extensions > Cloud Code.

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

  5. Di halaman Marketplace pada browser Anda, pada 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.

  6. Jika Anda ingin memverifikasi versi yang berbeda dari yang terbaru, klik tab Version History, lalu 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 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 akan diperbarui.

Login ke Google Cloud

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

  1. Pada 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 Configure Trusted Domains pada dialog yang muncul:

    Dialog Konfigurasi Domain Tepercaya

  3. Ikuti petunjuk untuk login menggunakan browser web.

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

Masalah umum: Browser Edge mengalihkan ke HTTPS saat 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. Ini 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 Delete.

Logout dari Google Cloud

  1. Klik Cloud Code, lalu luaskan Bantuan dan Masukan.
  2. Klik Logout dari Google Cloud, lalu saat diminta, pilih Logout.
  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 yang aktif

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

    Nama project aktif di status bar

  2. Di menu Pilihan 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 juga harus mengautentikasi kredensial untuk men-debug aplikasi secara lokal di IDE Anda 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.

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

  1. Instal gcloud ke mesin Anda jika belum melakukannya.

  2. Jalankan perintah berikut:

    gcloud auth application-default login
    
  3. Setelah selesai melakukan proses 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.