Menerima peristiwa langsung dari Cloud Storage (Google Cloud konsol)

Panduan memulai ini menunjukkan cara menerima peristiwa langsung dari Cloud Storage di layanan Cloud Run yang 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 penggunaan 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 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 .

  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.

    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.

    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

    8.

Membuat bucket Cloud Storage

Panduan memulai ini menggunakan Cloud Storage sebagai sumber peristiwa.

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

    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. Dalam daftar Region, untuk lokasi layanan Anda, pilih us-central1 (Iowa).

    4. Untuk Authentication, pilih Allow unauthenticated invocations.

    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. Di daftar Penyedia peristiwa, pilih Cloud Storage.

  6. Di 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 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. 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 Google Cloud konsol, 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 Detail layanan, klik tab Log. 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 ditagih atas penyimpanan image container di Container Registry, resource Cloud Run, dan penyimpanan 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.

  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