Menerima peristiwa langsung dari Cloud Storage (konsol Google Cloud)

Menerima peristiwa langsung dari Cloud Storage (konsol Google Cloud)

Standard

Panduan memulai ini menunjukkan cara menerima peristiwa langsung dari Cloud Storage dalam 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 petunjuk menggunakan Google Cloud CLI, lihat Menerima peristiwa langsung dari Cloud Storage (gcloud CLI).

Dalam panduan memulai ini, Anda akan:

1. Membuat bucket Cloud Storage untuk menjadi sumber peristiwa.

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

---

Jika ingin mengikuti panduan langkah demi langkah untuk tugas ini langsung di Konsol Google Cloud, 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 Google Cloud yang terbatas.

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. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   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

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

4. Enable the Cloud Build and Eventarc APIs.

   Enable the APIs

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

   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

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

7. Enable the Cloud Build and Eventarc APIs.

   Enable the APIs

Membuat bucket Cloud Storage

Panduan memulai ini menggunakan Cloud Storage sebagai sumber peristiwa.

1. Di konsol Google Cloud, buka halaman Bucket Cloud Storage.

   Buka Buckets

2. Klik Buat.

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

Men-deploy contoh layanan Cloud Run yang menerima dan mencatat peristiwa ke dalam log.

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

   Buka Layanan

2. Klik Buat layanan.

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 unauthenticated invocations.

   5. Untuk men-deploy contoh image container, klik Create.

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

Membuat pemicu Eventarc

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

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

   Buka Pemicu

2. Klik Create trigger.

3. Ketik Nama pemicu.

   Misalnya, hello-trigger.

4. Dalam daftar Jenis pemicu, pilih Sumber Google.

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

5. Di daftar Penyedia peristiwa, pilih Cloud Storage.

6. Di daftar Jenis peristiwa, pilih Langsung > google.cloud.storage.object.v1.finalized.

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

8. Jika diminta, berikan izin berikut:

   • Peran iam.serviceAccountTokenCreator ke akun layanan Pub/Sub
   • Peran 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. 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 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 Bucket Cloud Storage.

      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 Layanan Cloud Run.

      Buka Layanan

   2. Klik nama layanan yang Anda buat.

   3. Untuk mengambil entri log untuk semua revisi layanan ini, di halaman Detail layanan, 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 di halaman ini, ikuti langkah-langkah berikut.

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

Anda dapat menghapus gambar, menghapus bucket penyimpanan, dan menghapus layanan.

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 project Google Cloud untuk menghindari tagihan. Menghapus project Google Cloud Anda akan menghentikan penagihan untuk semua resource yang digunakan dalam project tersebut.

Perhatian: Menghapus project memiliki efek berikut:
• Semua hal dalam project akan dihapus. Jika menggunakan project yang sudah ada untuk tugas dalam dokumen ini, saat Anda menghapusnya, pekerjaan lain yang telah Anda lakukan dalam project tersebut juga akan terhapus.
• Project ID kustom hilang. Saat membuat project ini, Anda mungkin telah membuat project ID kustom yang ingin digunakan di masa mendatang. Untuk mempertahankan URL yang menggunakan project ID, 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 Cloud Run.