Buat fungsi Cloud Run generasi ke-2 menggunakan Cloud Code untuk Cloud Shell
Pelajari cara membuat, men-deploy, memanggil, dan mendownload fungsi HTTP Cloud Run menggunakan Cloud Code di Cloud Shell Editor.
Cloud Code adalah ekstensi yang menghadirkan banyak layanan Google Cloud, seperti Google Kubernetes Engine dan Cloud Run, langsung ke IDE Anda, sehingga Anda dapat mengembangkan aplikasi tanpa harus beralih konteks. Cloud Code tersedia secara default di Cloud Shell Editor.
Anda dapat menginstal ekstensi Cloud Code di VS Code, yang juga mendukung membuat dan men-deploy fungsi, atau IntelliJ dan lainnya IDE JetBrains yang didukung, yang tidak mendukung fungsi-fungsi Cloud Run.
Untuk mengikuti panduan langkah demi langkah tugas ini langsung di Cloud Shell Editor, klik Pandu saya:
Sebelum memulai
- Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.
-
Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.
-
Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.
-
Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.
-
Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.
Menghubungkan ke Google Cloud
Di bagian ini, Anda akan meluncurkan Cloud Shell Editor, menghubungkan ke Google Cloud, dan memilih project Google Cloud.
Untuk terhubung ke Google Cloud, ikuti langkah-langkah berikut:
Buka Cloud Shell Editor.
Jika diminta untuk memberi otorisasi Cloud Code agar dapat menggunakan kredensial Anda untuk melakukan panggilan Google Cloud API, klik Authorize jika Anda menyetujui persyaratannya.
Jika Anda belum terhubung ke Google Cloud, di status bar Cloud Code, klik Connect to Google Cloud.
Jika Anda diminta untuk memberi otorisasi Cloud Code agar dapat menggunakan kredensial Anda untuk melakukan panggilan Google Cloud API, klik Authorize jika Anda menyetujui persyaratan ini.
Jika Anda belum memilih project Google Cloud, pada status bar Cloud Code, klik Select a Google Cloud Project.
Jika sudah memilih project Google Cloud, Anda akan melihat nama project di status bar Cloud Code dan dapat melanjutkan ke membuat fungsi.
Di menu Pilih Cepat Pilih Project Google Cloud yang muncul, pilih project Google Cloud Anda.
Project ini akan dimuat dan menjadi project aktif di Cloud Shell Editor. Anda dapat mengalihkan project ini kapan saja dengan mengklik nama project aktif pada status bar Cloud Code dan memilih project yang berbeda.
Membuat fungsi
Gunakan Cloud Shell Editor sebagai lingkungan Anda untuk membuat dan men-deploy fungsi. Editor telah dilengkapi dengan alat yang diperlukan untuk pengembangan cloud.
Untuk membuat fungsi baru menggunakan contoh, ikuti langkah-langkah berikut:
Pada status bar Cloud Code, klik Cloud Code.
Di menu Pilih Cepat yang muncul, pilih Aplikasi Baru.
Pilih Aplikasi Cloud Functions sebagai jenis aplikasi sampel.
Dari daftar contoh aplikasi fungsi Cloud Run, pilih Node.js: Hello World.
Pilih folder untuk lokasi aplikasi Anda, lalu klik Create New Application.
Cloud Shell Editor memuat aplikasi Anda di ruang kerja baru. Setelah dimuat ulang, aplikasi Anda dapat diakses dengan tampilan Explorer.
File
launch.json
, yang terletak di folder.vscode
, berisi konfigurasi yang diperlukan untuk fungsi Anda:{ "configurations": [ { "name": "Deploy Cloud Function", "type": "cloudcode.cloudfunctions", "request": "launch", "functionName": "function-hello-world", "gen": "GEN_2", "entryPoint": "helloHttp", } ] }
Men-deploy fungsi
Setelah membuat fungsi, Anda dapat men-deploy-nya di Cloud Shell dengan mengikuti langkah-langkah berikut:
Klik Cloud Code lalu perluas penjelajah Cloud Functions.
Klik fungsi, lalu klik
Deploy function.Di menu Pilih Cepat, pilih project Google Cloud untuk men-deploy fungsi Anda.
Pilih region tempat fungsi akan di-deploy.
Pilih Node.js 20.
Deployment fungsi mungkin memerlukan waktu beberapa menit. Jika masih berlangsung, Anda akan melihat ikon progres
. Setelah selesai, Anda akan melihat ikon berhasil jika berhasil, ikon error jika gagal, atau ikon peringatan jika deployment gagal dan kembali ke deployment yang sebelumnya berhasil.Jika deployment gagal, lihat Output (Tampilan > Output) untuk pesan error. Mengklik link akan mengarahkan Anda ke log build di Google Cloud Console dan memberikan detail lebih lanjut tentang error tersebut.
(Opsional) Setelah fungsi di-deploy, Anda dapat melakukan tindakan berikut:
Untuk melihat file hanya-baca dari fungsi yang di-deploy, luaskan fungsi, lalu luaskan folder Source Code. Di sini, Anda dapat melihat
launch.json
pada.vscode
, kode yang di-deploy, danpackage.json
.Untuk melihat fungsi di konsol Google Cloud, klik kanan fungsi tersebut, lalu pilih Open in Cloud Console, dan jika diminta, pilih Open.
Untuk mengedit metadata fungsi Anda, klik kanan fungsi dan pilih Edit metadata in Cloud Console.
Untuk melihat log dari fungsi yang di-deploy, klik kanan fungsi, lalu pilih View logs.
Memanggil fungsi
Dengan memanggil fungsi, Anda dapat menjalankan fungsi yang di-deploy di konsol Google Cloud dari terminal Cloud Shell Editor. Untuk memanggil fungsi, ikuti langkah-langkah berikut:
Klik kanan fungsi, lalu pilih Invoke function via HTTP.
Di menu Pilih cepat Trigger function via HTTP yang muncul, pilih Invoke with no argument.
Terminal akan terbuka di IDE dan menjalankan perintah untuk menjalankan fungsi tersebut di Google Cloud.
Opsional: Download fungsi yang ada ke ruang kerja baru
Untuk mendownload fungsi yang ada ke ruang kerja baru, ikuti langkah-langkah berikut:
Klik Cloud Code, lalu luaskan explorer Cloud Functions.
Luaskan cuplikan project Google Cloud Anda, klik kanan fungsi yang ingin didownload, lalu pilih Download ke ruang kerja baru.
Saat diminta, masukkan nama untuk aplikasi baru, lalu klik Create New Application.
Tindakan ini akan mendownload fungsi ke komputer lokal Anda dan membukanya di ruang kerja baru di Cloud Shell Editor.
Pembersihan
Untuk menghapus hanya fungsi yang Anda buat untuk panduan memulai ini:
Di penjelajah Cloud Functions, klik kanan nama fungsi, lalu pilih Open in Cloud Console.
Klik Delete, lalu klik Delete.
Untuk menghapus project Anda (dan resource terkait):
Buka halaman BigQuery di konsol Google Cloud.
Pilih project yang Anda buat untuk panduan memulai ini, lalu klik Delete.
Ketik project ID untuk mengonfirmasi, lalu klik Shut down.
Tindakan ini akan menghentikan project dan menjadwalkannya untuk dihapus.
Langkah selanjutnya
- Pelajari lebih lanjut cara mengelola fungsi di ruang kerja Cloud Shell atau menjalankan secara lokal dengan Framework Functions.
- Pelajari lebih lanjut cara menulis fungsi Cloud Run.
- Pelajari lebih lanjut cara men-deploy fungsi Cloud Run.
- Pelajari lebih lanjut cara memanggil fungsi Cloud Run.
- Pelajari lebih lanjut cara memantau fungsi Cloud Run.
- Pelajari lebih lanjut cara menjalankan fungsi Cloud Run secara lokal.
- Pelajari tutorial fungsi Cloud Run lanjutan lainnya.