GSP080

Ringkasan

Fungsi Cloud Run merupakan potongan kode yang dijalankan untuk merespons suatu peristiwa, seperti permintaan HTTP, pesan dari layanan pesan, atau upload file. Peristiwa cloud adalah hal-hal yang terjadi di lingkungan cloud Anda. Hal-hal tersebut dapat berupa perubahan data dalam database, file yang ditambahkan ke sistem penyimpanan, atau instance virtual machine baru yang dibuat.

Karena dijalankan berdasarkan peristiwa, Cloud Run functions hanya akan dijalankan saat terjadi sesuatu. Hal ini menjadikan Cloud Run functions sebagai pilihan bagus untuk tugas-tugas yang harus dikerjakan dengan cepat atau yang tidak perlu dijalankan sepanjang waktu.

Sebagai contoh, Anda dapat menggunakan fungsi Cloud Run untuk:

• membuat thumbnail secara otomatis untuk gambar yang diupload ke Cloud Storage.
• mengirimkan notifikasi ke ponsel pengguna ketika pesan baru diterima di Pub/Sub.
• memproses data dari database Cloud Firestore dan membuat laporan.

Anda dapat menulis kode dalam bahasa apa pun yang mendukung Node.js, dan Anda dapat men-deploy kode ke cloud hanya dengan beberapa klik. Setelah di-deploy, fungsi Cloud Run Anda secara otomatis akan mulai dijalankan saat merespons peristiwa.

Lab interaktif ini menunjukkan kepada Anda cara membuat, men-deploy, dan menguji fungsi Cloud Run menggunakan Konsol Google Cloud.

Lab interaktif ini menunjukkan kepada Anda cara membuat, men-deploy, dan menguji fungsi Cloud Run menggunakan command line Google Cloud Shell.

Yang akan Anda lakukan

• Membuat fungsi Cloud Run
• Men-deploy dan menguji fungsi Cloud Run
• Melihat log

Penyiapan

Sebelum mengklik tombol Start Lab

Baca petunjuk ini. Lab memiliki timer dan Anda tidak dapat menjedanya. Timer yang dimulai saat Anda mengklik Start Lab akan menampilkan durasi ketersediaan resource Google Cloud untuk Anda.

Lab interaktif ini dapat Anda gunakan untuk melakukan aktivitas lab di lingkungan cloud sungguhan, bukan di lingkungan demo atau simulasi. Untuk mengakses lab ini, Anda akan diberi kredensial baru yang bersifat sementara dan dapat digunakan untuk login serta mengakses Google Cloud selama durasi lab.

Untuk menyelesaikan lab ini, Anda memerlukan:

• Akses ke browser internet standar (disarankan browser Chrome).

Catatan: Gunakan jendela Samaran (direkomendasikan) atau browser pribadi untuk menjalankan lab ini. Hal ini akan mencegah konflik antara akun pribadi Anda dan akun siswa yang dapat menyebabkan tagihan ekstra pada akun pribadi Anda.

• Waktu untuk menyelesaikan lab. Ingat, setelah dimulai, lab tidak dapat dijeda.

Catatan: Hanya gunakan akun siswa untuk lab ini. Jika Anda menggunakan akun Google Cloud yang berbeda, Anda mungkin akan dikenai tagihan ke akun tersebut.

Cara memulai lab dan login ke Google Cloud Console

1. Klik tombol Start Lab. Jika Anda perlu membayar lab, dialog akan terbuka untuk memilih metode pembayaran. Di sebelah kiri ada panel Lab Details yang berisi hal-hal berikut:

   • Tombol Open Google Cloud console
   • Waktu tersisa
   • Kredensial sementara yang harus Anda gunakan untuk lab ini
   • Informasi lain, jika diperlukan, untuk menyelesaikan lab ini

2. Klik Open Google Cloud console (atau klik kanan dan pilih Open Link in Incognito Window jika Anda menjalankan browser Chrome).

   Lab akan menjalankan resource, lalu membuka tab lain yang menampilkan halaman Sign in.

   Tips: Atur tab di jendela terpisah secara berdampingan.

   Catatan: Jika Anda melihat dialog Choose an account, klik Use Another Account.

3. Jika perlu, salin Username di bawah dan tempel ke dialog Sign in.

   {{{user_0.username | "Username"}}}

   Anda juga dapat menemukan Username di panel Lab Details.

4. Klik Next.

5. Salin Password di bawah dan tempel ke dialog Welcome.

   {{{user_0.password | "Password"}}}

   Anda juga dapat menemukan Password di panel Lab Details.

6. Klik Next.

   Penting: Anda harus menggunakan kredensial yang diberikan lab. Jangan menggunakan kredensial akun Google Cloud Anda. Catatan: Menggunakan akun Google Cloud sendiri untuk lab ini dapat dikenai biaya tambahan.

7. Klik halaman berikutnya:

   • Setujui persyaratan dan ketentuan.
   • Jangan tambahkan opsi pemulihan atau autentikasi 2 langkah (karena ini akun sementara).
   • Jangan mendaftar uji coba gratis.

Setelah beberapa saat, Konsol Google Cloud akan terbuka di tab ini.

Catatan: Untuk mengakses produk dan layanan Google Cloud, klik Navigation menu atau ketik nama layanan atau produk di kolom Search.

Mengaktifkan Cloud Shell

Cloud Shell adalah mesin virtual yang dilengkapi dengan berbagai alat pengembangan. Mesin virtual ini menawarkan direktori beranda persisten berkapasitas 5 GB dan berjalan di Google Cloud. Cloud Shell menyediakan akses command-line untuk resource Google Cloud Anda.

1. Klik Activate Cloud Shell di bagian atas Konsol Google Cloud.

2. Klik jendela berikut:

   • Lanjutkan melalui jendela informasi Cloud Shell.
   • Beri otorisasi ke Cloud Shell untuk menggunakan kredensial Anda guna melakukan panggilan Google Cloud API.

Setelah terhubung, Anda sudah diautentikasi, dan project ditetapkan ke Project_ID, . Output berisi baris yang mendeklarasikan Project_ID untuk sesi ini:

Project Cloud Platform Anda dalam sesi ini disetel ke {{{project_0.project_id | "PROJECT_ID"}}}

gcloud adalah alat command line untuk Google Cloud. Alat ini sudah terinstal di Cloud Shell dan mendukung pelengkapan command line.

3. (Opsional) Anda dapat menampilkan daftar nama akun yang aktif dengan perintah ini:

gcloud auth list

4. Klik Authorize.

Output:

ACTIVE: * ACCOUNT: {{{user_0.username | "ACCOUNT"}}} Untuk menetapkan akun aktif, jalankan: $ gcloud config set account `ACCOUNT`

5. (Opsional) Anda dapat menampilkan daftar ID project dengan perintah ini:

gcloud config list project

Output:

[core] project = {{{project_0.project_id | "PROJECT_ID"}}} Catatan: Untuk mendapatkan dokumentasi gcloud yang lengkap di Google Cloud, baca panduan ringkasan gcloud CLI.

Tugas 1. Membuat sebuah fungsi

Pertama, Anda akan membuat fungsi sederhana bernama helloWorld. Fungsi ini menulis pesan ke log Cloud Run functions. Hal ini dipicu oleh peristiwa fungsi Cloud Run dan menerima fungsi callback yang digunakan untuk menandakan penyelesaian fungsi tersebut.

Untuk lab ini, peristiwa fungsi Cloud Run adalah peristiwa topik pub/sub. Pub/sub adalah layanan pesan yang memisahkan pengirim pesan dari penerima pesan. Saat pesan dikirim atau diposting, langganan diperlukan agar penerima pesan dapat memperoleh pemberitahuan dan menerima pesan tersebut. Untuk mempelajari pub/sub lebih lanjut, lihat Pub/Sub: Layanan Pesan Berskala Google di dalam Panduan Pub/Sub.

Untuk mempelajari parameter peristiwa dan parameter callback lebih lanjut, lihat Fungsi Latar Belakang di dalam Dokumentasi Cloud Run functions.

Untuk membuat fungsi Cloud Run:

1. Di Cloud Shell, jalankan perintah berikut untuk menetapkan region default:

   gcloud config set run/region {{{project_0.default_region |REGION}}}

2. Buat direktori untuk kode fungsi:

   mkdir gcf_hello_world && cd $_

3. Buat dan buka index.js untuk mengedit:

   nano index.js

4. Salin kode berikut ke file index.js:

   const functions = require('@google-cloud/functions-framework'); // Register a CloudEvent callback with the Functions Framework that will // be executed when the Pub/Sub trigger topic receives a message. functions.cloudEvent('helloPubSub', cloudEvent => { // The Pub/Sub message is passed as the CloudEvent's data payload. const base64name = cloudEvent.data.message.data; const name = base64name ? Buffer.from(base64name, 'base64').toString() : 'World'; console.log(`Hello, ${name}!`); });

5. Keluar dari nano (Ctrl+x) dan simpan (Y) file tersebut.

6. Buat dan buka package.json untuk mengedit:

7. Salin kode berikut ke file package.json:

   { "name": "gcf_hello_world", "version": "1.0.0", "main": "index.js", "scripts": { "start": "node index.js", "test": "echo \"Error: no test specified\" && exit 1" }, "dependencies": { "@google-cloud/functions-framework": "^3.0.0" } }

8. Keluar dari nano (Ctrl+x) dan simpan (Y) file tersebut.

9. Instal dependensi paket

   npm install

   Output yang Diharapkan:

   added 140 packages, and audited 141 packages in 9s 27 packages are looking for funding run `npm fund` for details found 0 vulnerabilities

Tugas 2. Men-deploy fungsi

Untuk lab ini, Anda akan menetapkan --trigger-topic sebagai cf_demo.

Catatan:
Cloud Run functions didasarkan pada peristiwa, yang berarti jenis pemicu harus ditentukan. Saat men-deploy fungsi baru, `--trigger-topic`, `--trigger-bucket`, atau `--trigger-http` adalah peristiwa pemicu yang umum. Saat men-deploy perubahan ke fungsi yang ada, fungsi tersebut akan mempertahankan pemicu yang ada kecuali jika ditentukan lain.

1. Deploy fungsi nodejs-pubsub-function ke topik pub/sub yang bernama cf-demo

   gcloud functions deploy nodejs-pubsub-function \ --gen2 \ --runtime=nodejs20 \ --region={{{ project_0.default_region | REGION }}} \ --source=. \ --entry-point=helloPubSub \ --trigger-topic cf-demo \ --stage-bucket {{{ project_0.project_id | PROJECT_ID }}}-bucket \ --service-account cloudfunctionsa@{{{ project_0.project_id | PROJECT_ID }}}.iam.gserviceaccount.com \ --allow-unauthenticated Catatan:
   Jika Anda mendapatkan notifikasi serviceAccountTokenCreator akun layanan, pilih "n".

2. Verifikasi status fungsi tersebut:

   gcloud functions describe nodejs-pubsub-function \ --region={{{ project_0.default_region | REGION }}}

   Status ACTIVE menunjukkan bahwa fungsi telah di-deploy.

   Output yang Diharapkan:

   BuildConfig: automaticUpdatePolicy: {} build: projects/630521560493/locations/{{{ project_0.default_region | REGION }}}/builds/7ff9d415-50d9-4557-9bcd-5afad42a6390 dockerRegistry: ARTIFACT_REGISTRY dockerRepository: projects/{{{ project_0.project_id | PROJECT_ID }}}/locations/{{{ project_0.default_region | REGION }}}/repositories/gcf-artifacts entryPoint: helloPubSub ... State: ACTIVE ... UpdateTime: '2024-08-05T13:51:05.317298824Z' Url: https://{{{ project_0.default_region | REGION }}}-{{{ project_0.project_id | PROJECT_ID }}}.cloudfunctions.net/nodejs-pubsub-function

Tiap pesan yang dipublikasikan dalam topik akan memicu eksekusi fungsi. Isi pesan tersebut kemudian diteruskan sebagai data input.

Menguji Tugas yang Telah Diselesaikan

Klik Check my progress untuk memverifikasi tugas yang telah dijalankan. Jika berhasil menyelesaikan tugas, Anda akan menerima skor penilaian.

Men-deploy fungsi.

Tugas 3. Menguji fungsi

Setelah Anda men-deploy fungsi dan sudah aktif, uji apakah fungsi tersebut menulis pesan ke log cloud setelah mendeteksi suatu peristiwa.

1. Memanggil PubSub dengan beberapa data.

   gcloud pubsub topics publish cf-demo --message="Cloud Function Gen2"

   Contoh output:

   messageIds: - '11927162971409664'

Lihat log untuk mengonfirmasi bahwa ada pesan log dengan ID eksekusi tersebut.

Tugas 4. Melihat log

1. Periksa log untuk melihat pesan Anda dalam histori log:

   gcloud functions logs read nodejs-pubsub-function \ --region={{{ project_0.default_region | REGION }}} Catatan:
   Perlu waktu sekitar 10 menit hingga log muncul. Cara alternatif untuk melihat log adalah dengan membuka Logging > Logs Explorer.

   Fungsi Cloud Run akan menampilkan informasi yang mirip seperti di bawah ini:

   LEVEL: NAME: nodejs-pubsub-function EXECUTION_ID: h4v6akxf4sxt TIME_UTC: 2024-08-05 15:15:25.723 LOG: Hello, Cloud Function Gen2! LEVEL: I NAME: nodejs-pubsub-function EXECUTION_ID: TIME_UTC: 2024-08-05 15:15:25.711 LOG: LEVEL: NAME: nodejs-pubsub-function EXECUTION_ID: h4oxfjn7zlyu TIME_UTC: 2024-08-05 15:10:34.303 LOG: Hello, Friend! LEVEL: I NAME: nodejs-pubsub-function EXECUTION_ID: TIME_UTC: 2024-08-05 15:10:34.291 LOG: LEVEL: NAME: nodejs-pubsub-function EXECUTION_ID: h4fjhyfxua3k TIME_UTC: 2024-08-05 15:03:16.342 LOG: Hello, "SGVsbG8gZnJvbSB0aGUgY29tbWFuZCBsaW5l"!

Aplikasi Anda telah di-deploy, diuji, dan Anda dapat melihat log-nya.

Tugas 5. Menguji pemahaman Anda

1. Di bawah ini terdapat beberapa pertanyaan pilihan ganda untuk memperkuat pemahaman Anda tentang konsep-konsep dalam lab ini. Jawab pertanyaan tersebut sebaik mungkin.

Selamat!

Anda menggunakan Konsol Google Cloud untuk membuat, men-deploy, dan menguji fungsi Cloud Run menggunakan command line.

Ikuti lab berikutnya

Lab ini merupakan bagian dari rangkaian lab yang disebut Qwik Start. Lab ini dirancang agar Anda dapat mencoba berbagai fitur yang tersedia dengan Google Cloud. Telusuri "Qwik Start" di katalog lab untuk menemukan lab berikutnya yang ingin Anda ikuti.

Langkah berikutnya/Pelajari lebih lanjut

• Anda telah menggunakan command line untuk memulai fungsi Cloud Run. Sekarang, coba lab Cloud Run functions: Qwik Start - Konsol untuk memulai fungsi Cloud Run menggunakan Konsol Cloud.
• Untuk mengetahui informasi selengkapnya tentang cara membuat pemicu dan mengaitkannya dengan fungsi Anda, baca bagian Peristiwa dan Pemicu di Panduan Cloud Run functions.

Sertifikasi dan pelatihan Google Cloud

...membantu Anda mengoptimalkan teknologi Google Cloud. Kelas kami mencakup keterampilan teknis dan praktik terbaik untuk membantu Anda memahami dengan cepat dan melanjutkan proses pembelajaran. Kami menawarkan pelatihan tingkat dasar hingga lanjutan dengan opsi on demand, live, dan virtual untuk menyesuaikan dengan jadwal Anda yang sibuk. Sertifikasi membantu Anda memvalidasi dan membuktikan keterampilan serta keahlian Anda dalam teknologi Google Cloud.

Manual Terakhir Diperbarui pada 20 Januari 2025

Lab Terakhir Diuji pada 20 Januari 2025

Hak cipta 2025 Google LLC. Semua hak dilindungi undang-undang. Google dan logo Google adalah merek dagang dari Google LLC. Semua nama perusahaan dan produk lain mungkin adalah merek dagang masing-masing perusahaan yang bersangkutan.