Menerima peristiwa langsung dari Cloud Storage (Google Cloud konsol)

Menerima peristiwa langsung dari Cloud Storage (Google Cloud konsol)

Standard

Panduan memulai ini menunjukkan cara menerima peristiwa langsung dari Cloud Storage di layanan Cloud Run yang tidak diautentikasi.

Catatan: Semua layanan Cloud Run di-deploy secara pribadi secara default, sehingga layanan tersebut tidak dapat diakses tanpa memberikan kredensial autentikasi dalam permintaan. Untuk project dengan kebijakan organisasi berbagi yang dibatasi domain, gunakan layanan target Cloud Run yang diautentikasi, bukan layanan yang memungkinkan akses publik (tidak diautentikasi).

Anda dapat mengonfigurasi pemicuan notifikasi sebagai respons terhadap berbagai peristiwa di dalam bucket Cloud Storage—pembuatan, penghapusan, pengarsipan, dan pembaruan metadata objek. Untuk mengetahui informasi selengkapnya, lihat Membuat pemicu untuk merutekan peristiwa Cloud Storage ke Cloud Run.

Anda dapat menyelesaikan panduan memulai ini menggunakan konsol Google Cloud . Untuk mengetahui petunjuk menggunakan Google Cloud CLI, lihat Menerima peristiwa langsung dari Cloud Storage (gcloud CLI).

Dalam panduan memulai ini, Anda akan:

1. Buat bucket Cloud Storage untuk menjadi sumber peristiwa.

2. Deploy layanan contoh ke Cloud Run untuk menerima peristiwa.

3. Buat pemicu Eventarc untuk memfilter dan merutekan peristiwa.

4. Buat peristiwa dengan mengupload file ke bucket Cloud Storage, dan lihat peristiwa tersebut di log Cloud Run.

---

Untuk mengikuti panduan langkah demi langkah untuk tugas ini langsung di Google Cloud konsol, klik Pandu saya:

Pandu saya

---

Sebelum memulai

Batasan keamanan yang ditentukan oleh organisasi mungkin mencegah Anda menyelesaikan langkah-langkah berikut. Untuk mengetahui informasi pemecahan masalah, lihat Mengembangkan aplikasi di lingkungan yang terbatas Google Cloud .

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.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Jika Anda menggunakan project yang sudah ada untuk panduan ini, pastikan Anda memiliki izin yang diperlukan untuk menyelesaikan panduan ini. Jika berhasil membuat project baru, berarti Anda sudah memiliki izin yang diperlukan.

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Build and Eventarc APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Jika Anda menggunakan project yang sudah ada untuk panduan ini, pastikan Anda memiliki izin yang diperlukan untuk menyelesaikan panduan ini. Jika berhasil membuat project baru, berarti Anda sudah memiliki izin yang diperlukan.

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Build and Eventarc APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk menyelesaikan panduan memulai ini, minta administrator Anda untuk memberi Anda peran IAM berikut di project Anda:

• Admin Cloud Run (roles/run.admin)
• Eventarc Admin (roles/eventarc.admin)
• Logs Viewer (roles/logging.viewer)
• Project IAM Admin (roles/resourcemanager.projectIamAdmin)
• Service Account User (roles/iam.serviceAccountUser)
• Storage Admin (roles/storage.admin)

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Membuat bucket Cloud Storage

Panduan memulai ini menggunakan Cloud Storage sebagai sumber peristiwa.

1. Di konsol Google Cloud , buka halaman Cloud Storage > Overview.

   Buka Ringkasan

2. Klik Buat bucket.

3. Masukkan Nama unik untuk bucket Anda.

   Misalnya, hello-bucket.

4. Klik Lanjutkan.

5. Untuk Location type, pilih Region, lalu pilih us-central1 (Iowa).

6. Terima setelan default lainnya.

7. Klik Buat.

Setelah sumber peristiwa dibuat, Anda dapat men-deploy layanan penerima peristiwa ke Cloud Run.

Men-deploy layanan penerima peristiwa ke Cloud Run

Deploy layanan Cloud Run contoh yang menerima dan mencatat peristiwa ke dalam log.

1. Di konsol Google Cloud , buka halaman Services Cloud Run.

   Buka Layanan

2. Klik Deploy container > Service.

3. Di formulir Create service:

   1. Pilih Men-deploy satu revisi dari image container yang sudah ada.

   2. Klik Uji dengan container contoh.

   3. Di daftar Region, untuk lokasi layanan Anda, pilih us-central1 (Iowa).

   4. Untuk Authentication, pilih Allow public access.

   5. Terima setelan default lainnya.

   6. Untuk men-deploy contoh image container, klik Buat.

Deployment layanan hello dapat memerlukan waktu hingga dua menit untuk diselesaikan.

Membuat pemicu Eventarc

Pemicu Eventarc akan mengirimkan peristiwa dari bucket Cloud Storage ke layanan Cloud Run contoh.

1. Di konsol Google Cloud , buka halaman Eventarc > Triggers.

   Buka Pemicu

2. Klik Create trigger.

3. Ketik Trigger name.

   Misalnya, hello-trigger.

4. Dalam daftar Jenis pemicu, pilih Sumber Google.

   Filter ini memfilter peristiwa yang dikirim dari Google Cloud penyedia (secara langsung atau melalui entri Cloud Audit Logs), atau penyedia yang menggunakan pesan Pub/Sub.

5. Dalam daftar Event provider, pilih Cloud Storage.

6. Dalam daftar Event type, pilih Direct > google.cloud.storage.object.v1.finalized.

7. Untuk Bucket, pilih bucket Cloud Storage hello-bucket yang Anda buat sebelumnya.

8. Jika diminta, berikan peran berikut:

   • Service Account Token Creator (roles/iam.serviceAccountTokenCreator) ke akun layanan Pub/Sub
   • Eventarc Event Receiver (roles/eventarc.eventReceiver) ke akun layanan Compute Engine default
   • Pub/Sub Publisher (roles/pubsub.publisher) ke akun layanan Cloud Storage

9. Gunakan Akun layanan komputasi default sebagai akun layanan yang memanggil layanan Anda.

10. Dalam daftar Tujuan peristiwa, pilih Cloud Run.

11. Untuk layanan Cloud Run, pilih layanan hello contoh yang Anda buat sebelumnya.

12. Terima setelan default lainnya.

13. Klik Buat.

Mungkin perlu waktu beberapa menit sebelum semua izin yang diperlukan disebarkan ke agen layanan Eventarc. Jika Anda menerima error Permission denied while using the Eventarc Service Agent, tunggu beberapa menit, lalu coba lagi. Setelah pemicu dibuat, diperlukan waktu hingga dua menit agar pemicu berfungsi sepenuhnya.

Membuat dan melihat peristiwa

Buat peristiwa dan konfirmasi bahwa pemicu Eventarc berfungsi seperti yang diharapkan.

1. Untuk membuat peristiwa:

   1. Buat file teks dengan nama file random.txt dan teks "Hello World".

   2. Di konsol Google Cloud , buka halaman Cloud Storage > Buckets.

      Buka Buckets

   3. Klik nama bucket penyimpanan yang Anda buat.

   4. Di tab Objects, klik Upload files, lalu upload file random.txt.

   Hasil upload ini akan membuat peristiwa dan layanan Cloud Run akan mencatat pesan peristiwa tersebut ke dalam log.

2. Untuk melihat entri log:

   1. Di konsol Google Cloud , buka halaman Services Cloud Run.

      Buka Layanan

   2. Klik nama layanan yang Anda buat.

   3. Untuk mengambil entri log untuk semua revisi layanan ini, di halaman Service details, klik tab Logs. Anda dapat memfilter berdasarkan tingkat keparahan log.

   4. Cari entri log yang mirip dengan:

      Received event of type google.cloud.storage.object.v1.finalized. Event data: [...]

Selamat! Anda telah berhasil men-deploy layanan penerima peristiwa ke Cloud Run, membuat pemicu Eventarc, membuat peristiwa dari Cloud Storage, dan menampilkannya di log Cloud Run.

Pembersihan

Agar akun Google Cloud Anda tidak dikenai biaya untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut.

Meskipun Cloud Run tidak mengenakan biaya saat layanannya tidak digunakan, Anda mungkin tetap dikenai biaya untuk menyimpan image container di Container Registry, resource Cloud Run, dan menyimpan file di bucket Cloud Storage.

Anda dapat menghapus image, menghapus bucket penyimpanan, dan menghapus layanan Cloud Run.

Untuk menghapus pemicu Eventarc:

1. Di konsol Google Cloud , buka halaman Pemicu Eventarc.

   Buka Pemicu

2. Klik nama pemicu yang Anda buat.

3. Di halaman Detail pemicu, klik Hapus.

Atau, Anda dapat menghapus Google Cloud project untuk menghindari tagihan. Menghapus project Google Cloud akan menghentikan penagihan untuk semua resource yang digunakan dalam project tersebut.

Perhatian: Penghapusan project memiliki efek berikut:
• Semua hal dalam project akan dihapus. Jika Anda menggunakan project Anda sendiri untuk mengerjakan tugas dalam dokumen ini, saat Anda menghapusnya, pekerjaan lain dalam project tersebut juga akan dihapus.
• Project ID kustom akan hilang. Saat membuat project ini, Anda mungkin juga membuat project ID kustom yang masih ingin Anda gunakan pada masa mendatang. Agar tidak kehilangan URL yang menggunakan project ID tersebut, seperti URL appspot.com, hapus resource yang dipilih di dalam project, bukan menghapus seluruh project.
1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

Langkah berikutnya

• Menerima peristiwa Cloud Audit Logs untuk beban kerja produksi.
• Menjalankan tugas Cloud Run dalam alur kerja menggunakan pemicu Eventarc.
• Mengembangkan layanan Anda.