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:
- Instal dan siapkan Visual Studio Code di komputer Anda.
Menginstal dan mengonfigurasi dukungan bahasa.
Ekstensi Cloud Code berfungsi paling baik dengan bahasa berikut:
Instal Git. Git diperlukan untuk menyalin sampel ke komputer Anda.
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.
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:
Klik Ekstensi atau tekan
Ctrl
/Cmd
+Shift
+X
.Telusuri
Google Cloud Code
.Klik Install (Instal).
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:
- Klik settings
Manage > Settings, lalu tetapkan Auto Dependencies
(
cloudcode.autoDependencies
) keoff
. Instal dependensi berikut di
PATH
Anda:- kubectl
- Skaffold
- minikube untuk pengembangan lokal
- Google Cloud CLI, jika melakukan pengembangan dengan Google Cloud
Opsional: Memverifikasi vsix Cloud Code menggunakan VsixSignTool
Untuk memverifikasi Cloud Code vsix dengan VsixSignTool, lakukan langkah-langkah berikut:
Pastikan Anda menggunakan hal berikut:
- Pengelola paket Nuget
- OS Windows
- Rilis produksi Cloud Code
Instal Microsoft VsixSignTool dan catat jalur penginstalannya.
Buka VS Code dan buka Extensions > Cloud Code.
Di tab Details, pada bagian Extension Resources, klik Marketplace.
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.Jika Anda ingin memverifikasi versi yang berbeda dari yang terbaru, klik tab Version History, lalu pilih versi lain untuk didownload.
Setelah download selesai, buka jendela terminal dan jalankan perintah berikut:
PATH_TO_VSIXSIGNTOOL verify PATH_TO_DOWNLOADED_VSIX
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:
- Pada status bar Cloud Code, klik Cloud Code - Sign in.
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:Ikuti petunjuk untuk login menggunakan browser web.
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:
Di kolom URL browser Edge Anda, masukkan
edge://net-internals/#hsts
.Buka bagian Hapus kebijakan keamanan domain.
Masukkan
localhost
, lalu klik Delete.
Logout dari Google Cloud
- Klik Cloud Code, lalu luaskan Bantuan dan Masukan.
- Klik Logout dari Google Cloud, lalu saat diminta, pilih Logout.
- 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
Di status bar Cloud Code, klik nama project yang aktif.
Di menu Pilihan Cepat yang muncul, pilih sync_alt Switch Project.
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:
Instal gcloud ke mesin Anda jika belum melakukannya.
Jalankan perintah berikut:
gcloud auth application-default login
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.