Membuat dan men-deploy fungsi dengan Cloud Shell

Pelajari cara membuat, men-deploy, memanggil, dan mendownload fungsi HTTP generasi ke-2 menggunakan Cloud Functions dengan Cloud Code di Cloud Shell Editor.

---

Untuk mengikuti panduan langkah demi langkah tugas ini langsung di Cloud Shell Editor, klik Pandu saya:

Pandu saya

---

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

3. Make sure that billing is enabled for your Google Cloud project.

4. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

5. Make sure that billing is enabled for your Google Cloud project.

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:

1. Buka Cloud Shell Editor.

2. Jika diminta untuk memberi otorisasi Cloud Code agar dapat menggunakan kredensial Anda untuk melakukan panggilan Google Cloud API, klik Authorize jika Anda menyetujui persyaratannya.

3. Jika Anda belum terhubung ke Google Cloud, di status bar Cloud Code, klik Connect to Google Cloud.

   

4. 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.

5. 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.

6. 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:

1. Pada status bar Cloud Code, klik Cloud Code.

   

2. Di menu Pilih Cepat yang muncul, pilih Aplikasi Baru.

3. Pilih Aplikasi Cloud Functions sebagai jenis aplikasi sampel.

4. Dari daftar sampel aplikasi Cloud Functions, pilih Node.js: Hello World.

5. 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",
       }
   ]
   }
   

Untuk mempelajari lebih lanjut cara membuat beberapa fungsi dalam satu ruang kerja, lihat Mengelola fungsi di ruang kerja Shell.

Men-deploy fungsi

Setelah membuat fungsi, Anda dapat men-deploy-nya di Cloud Shell dengan mengikuti langkah-langkah berikut:

1. Klik Cloud Code, lalu luaskan explorer Cloud Functions.

2. Klik fungsi, lalu klik Deploy function.

3. Di menu Pilih Cepat, pilih project Google Cloud untuk men-deploy fungsi Anda.

4. Pilih region tempat fungsi akan di-deploy.

5. 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 pesan error di tampilan Output (View > Output). Mengklik link akan mengarahkan Anda ke log build di Google Cloud Console dan memberikan detail lebih lanjut tentang error tersebut.

6. (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, dan package.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:

1. Klik kanan fungsi, lalu pilih Invoke function via HTTP.

2. 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:

1. Klik Cloud Code, lalu luaskan explorer Cloud Functions.

2. Luaskan cuplikan project Google Cloud Anda, klik kanan fungsi yang ingin didownload, lalu pilih Download ke ruang kerja baru.

3. 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:

1. Di penjelajah Cloud Functions, klik kanan nama fungsi, lalu pilih Open in Cloud Console.

2. Klik Delete, lalu klik Delete.

Untuk menghapus project Anda (dan resource terkait):

1. Buka halaman BigQuery di konsol Google Cloud.

   Buka halaman Projects

2. Pilih project yang Anda buat untuk panduan memulai ini, lalu klik Delete.

3. Ketik project ID untuk mengonfirmasi, lalu klik Shut down.

   Tindakan ini akan menghentikan project dan menjadwalkannya untuk dihapus.

Langkah selanjutnya

• Baca ringkasan Bekerja dengan Cloud Functions untuk mempelajari lebih lanjut cara mengelola ruang kerja atau menyiapkan lingkungan pengembangan lokal.