Membuat pemicu dengan Eventarc

Konsol

1. Deploy layanan Cloud Run Anda menggunakan container atau dari sumber.

2. Di konsol Google Cloud , buka Cloud Run:

   Buka Cloud Run

3. Dari daftar layanan, klik layanan yang ada.

4. Di halaman Service details, buka tab Triggers.

5. Klik Tambahkan pemicu, lalu pilih salah satu opsi.

6. Di panel Eventarc trigger, ubah detail pemicu sebagai berikut:

   1. Di kolom Nama pemicu, masukkan nama pemicu, atau gunakan nama default.

   2. Pilih Jenis pemicu dari daftar untuk menentukan salah satu jenis pemicu berikut:

      • Sumber Google untuk menentukan pemicu bagi Pub/Sub, Cloud Storage, Firestore, dan penyedia peristiwa Google lainnya.

      • Pihak ketiga untuk berintegrasi dengan penyedia non-Google yang menawarkan sumber Eventarc. Untuk mengetahui informasi selengkapnya, lihat Peristiwa pihak ketiga di Eventarc.

   3. Pilih penyedia peristiwa dari daftar Event provider, untuk memilih produk yang menyediakan jenis peristiwa untuk memicu layanan Anda. Untuk daftar penyedia peristiwa, lihat Penyedia dan tujuan peristiwa.

   4. Pilih jenis acara dari daftar Jenis acara. Konfigurasi pemicu Anda bervariasi, bergantung pada jenis peristiwa yang didukung. Untuk mengetahui informasi selengkapnya, lihat Jenis peristiwa.

   5. Jika kolom Region diaktifkan, pilih lokasi untuk pemicu Eventarc. Secara umum, lokasi pemicu Eventarc harus cocok dengan lokasi resource Google Cloud yang ingin Anda pantau peristiwanya. Dalam sebagian besar skenario, Anda juga harus men-deploy layanan di region yang sama. Lihat Memahami lokasi Eventarc untuk mengetahui detail selengkapnya tentang lokasi pemicu Eventarc.

   6. Di kolom Service account, pilih akun layanan. Pemicu Eventarc ditautkan ke akun layanan untuk digunakan sebagai identitas saat memanggil layanan Anda. Akun layanan pemicu Eventarc Anda harus memiliki izin untuk memanggil layanan Anda. Secara default, Cloud Run menggunakan akun layanan default Compute Engine.

   7. Jika perlu, tentukan Jalur URL layanan untuk mengirim permintaan masuk ke. Ini adalah jalur relatif pada layanan tujuan yang akan menjadi tempat pengiriman peristiwa untuk pemicu. Misalnya: /, /route, route, dan route/subroute.

   8. Setelah Anda mengisi kolom yang wajib diisi, klik Simpan pemicu.

7. Setelah membuat pemicu, verifikasi kondisinya dengan memastikan bahwa ada tanda centang check_circle di tab Pemicu.

gcloud

1. Deploy layanan Cloud Run Anda menggunakan container atau dari sumber.

2. Jalankan perintah berikut untuk membuat pemicu yang memfilter peristiwa:

   gcloud eventarc triggers create TRIGGER_NAME  \
       --location=REGION \
       --destination-run-service=SERVICE  \
       --destination-run-region=REGION \
       --event-filters="EVENT_FILTER" \
       --service-account=PROJECT_NUMBER-compute@developer.gserviceaccount.com
   

   Ganti:

   • TRIGGER_NAME dengan nama pemicu Anda.

   • EVENTARC_TRIGGER_LOCATION dengan lokasi untuk pemicu Eventarc. Secara umum, lokasi pemicu Eventarc harus cocok dengan lokasi resource Google Cloud yang ingin Anda pantau peristiwanya. Dalam sebagian besar skenario, Anda juga harus men-deploy layanan di region yang sama. Untuk mengetahui informasi selengkapnya, lihat Lokasi Eventarc.

   • SERVICE dengan nama layanan yang Anda deploy.

   • REGION dengan region Cloud Run layanan.

   • PROJECT_NUMBER dengan Google Cloud nomor project Anda. Pemicu Eventarc ditautkan ke akun layanan untuk digunakan sebagai identitas saat memanggil layanan Anda. Akun layanan pemicu Eventarc Anda harus memiliki izin untuk memanggil layanan Anda. Secara default, Cloud Run menggunakan Akun layanan komputasi default.

   • Flag event-filters menentukan filter peristiwa yang dipantau pemicu. Peristiwa yang cocok dengan semua event-filters, filter memicu panggilan ke layanan Anda. Setiap pemicu harus memiliki jenis peristiwa yang didukung. Anda tidak dapat mengubah jenis filter peristiwa setelah dibuat. Untuk mengubah jenis filter peristiwa, Anda harus membuat pemicu baru dan menghapus pemicu lama. Secara opsional, Anda dapat mengulangi tanda --event-filters dengan filter yang didukung dalam bentuk ATTRIBUTE=VALUE untuk menambahkan lebih banyak filter.

Terraform

Untuk membuat pemicu Eventarc untuk layanan Cloud Run, lihat Membuat pemicu menggunakan Terraform.

Konsol

Saat menggunakan konsol Google Cloud untuk membuat fungsi, Anda juga dapat menambahkan pemicu ke fungsi. Ikuti langkah-langkah berikut untuk membuat pemicu bagi fungsi Anda:

1. Di konsol Google Cloud , buka Cloud Run:

   Buka Cloud Run

2. Klik Write a function, lalu masukkan detail fungsi. Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi fungsi selama deployment, lihat Men-deploy fungsi.

3. Di bagian Pemicu, klik Tambahkan pemicu.

4. Pilih salah satu opsi.

5. Di panel Eventarc trigger, ubah detail pemicu sebagai berikut:

   1. Masukkan nama pemicu di kolom Nama pemicu, atau gunakan nama default.

   2. Pilih Jenis pemicu dari daftar untuk menentukan salah satu jenis pemicu berikut:

      • Sumber Google untuk menentukan pemicu bagi Pub/Sub, Cloud Storage, Firestore, dan penyedia peristiwa Google lainnya.

      • Pihak ketiga untuk berintegrasi dengan penyedia non-Google yang menawarkan sumber Eventarc. Untuk mengetahui informasi selengkapnya, lihat Peristiwa pihak ketiga di Eventarc.

   3. Pilih penyedia peristiwa dari daftar Penyedia peristiwa, untuk memilih produk yang menyediakan jenis peristiwa untuk memicu fungsi Anda. Untuk daftar penyedia peristiwa, lihat Penyedia dan tujuan peristiwa.

   4. Pilih jenis acara dari daftar Jenis acara. Konfigurasi pemicu Anda bervariasi, bergantung pada jenis peristiwa yang didukung. Untuk mengetahui informasi selengkapnya, lihat Jenis peristiwa.

   5. Jika kolom Region diaktifkan, pilih lokasi untuk pemicu Eventarc. Secara umum, lokasi pemicu Eventarc harus cocok dengan lokasi resource Google Cloud yang ingin Anda pantau peristiwanya. Dalam sebagian besar skenario, Anda juga harus men-deploy fungsi di region yang sama. Lihat Memahami lokasi Eventarc untuk mengetahui detail selengkapnya tentang lokasi pemicu Eventarc.

   6. Di kolom Service account, pilih akun layanan. Pemicu Eventarc ditautkan ke akun layanan untuk digunakan sebagai identitas saat memanggil fungsi Anda. Akun layanan pemicu Eventarc Anda harus memiliki izin untuk memanggil fungsi Anda. Secara default, Cloud Run menggunakan akun layanan default Compute Engine.

   7. Jika perlu, tentukan Jalur URL layanan untuk mengirim permintaan masuk ke. Ini adalah jalur relatif pada layanan tujuan yang akan menjadi tempat pengiriman peristiwa untuk pemicu. Misalnya: /, /route, route, dan route/subroute.

6. Setelah Anda mengisi kolom yang wajib diisi, klik Simpan pemicu.

gcloud

Saat membuat fungsi menggunakan gcloud CLI, Anda harus men-deploy fungsi terlebih dahulu, lalu membuat pemicu. Ikuti langkah-langkah berikut untuk membuat pemicu bagi fungsi Anda:

1. Jalankan perintah berikut di direktori yang berisi kode contoh untuk men-deploy fungsi Anda:

   gcloud run deploy FUNCTION \
           --source . \
           --function FUNCTION_ENTRYPOINT \
           --base-image BASE_IMAGE_ID \
           --region REGION
   

   Ganti:

   • FUNCTION dengan nama fungsi yang Anda deploy. Anda dapat menghilangkan parameter ini sepenuhnya, tetapi Anda akan diminta untuk memasukkan nama jika menghilangkannya.

   • FUNCTION_ENTRYPOINT dengan titik entri ke fungsi Anda dalam kode sumber. Ini adalah kode yang dieksekusi Cloud Run saat fungsi Anda berjalan. Nilai flag ini harus berupa nama fungsi atau nama class yang sepenuhnya memenuhi syarat yang ada dalam kode sumber Anda.

   • BASE_IMAGE_ID dengan lingkungan image dasar untuk fungsi Anda. Untuk mengetahui detail selengkapnya tentang image dasar dan paket yang disertakan dalam setiap image, lihat Image dasar runtime.

   • REGION dengan Google Cloud region tempat Anda ingin men-deploy fungsi Anda. Contohnya, us-central1

2. Jalankan perintah berikut untuk membuat pemicu yang memfilter peristiwa:

   gcloud eventarc triggers create TRIGGER_NAME  \
       --location=REGION \
       --destination-run-service=FUNCTION  \
       --destination-run-region=REGION \
       --event-filters="EVENT_FILTER" \
       --service-account=PROJECT_NUMBER-compute@developer.gserviceaccount.com
   

   Ganti:

   • TRIGGER_NAME dengan nama pemicu Anda.

   • EVENTARC_TRIGGER_LOCATION dengan lokasi untuk pemicu Eventarc. Secara umum, lokasi pemicu Eventarc harus cocok dengan lokasi resource Google Cloud yang ingin Anda pantau peristiwanya. Dalam sebagian besar skenario, Anda juga harus men-deploy fungsi di region yang sama. Untuk mengetahui informasi selengkapnya, lihat Lokasi Eventarc.

   • FUNCTION dengan nama fungsi yang Anda deploy.

   • REGION dengan region Cloud Run fungsi.

   • PROJECT_NUMBER dengan Google Cloud nomor project Anda. Pemicu Eventarc ditautkan ke akun layanan untuk digunakan sebagai identitas saat memanggil fungsi Anda. Akun layanan pemicu Eventarc Anda harus memiliki izin untuk memanggil fungsi Anda. Secara default, Cloud Run menggunakan Akun layanan komputasi default.

   • Flag event-filters menentukan filter peristiwa yang dipantau pemicu. Peristiwa yang cocok dengan semua event-filters, filter memicu panggilan ke fungsi Anda. Setiap pemicu harus memiliki jenis peristiwa yang didukung. Anda tidak dapat mengubah jenis filter peristiwa setelah dibuat. Untuk mengubah jenis filter peristiwa, Anda harus membuat pemicu baru dan menghapus pemicu lama. Secara opsional, Anda dapat mengulangi tanda --event-filters dengan filter yang didukung dalam bentuk ATTRIBUTE=VALUE untuk menambahkan lebih banyak filter.

Terraform

Untuk membuat pemicu Eventarc bagi fungsi Cloud Run, lihat Membuat pemicu menggunakan Terraform.

Konsol

Setelah men-deploy fungsi, ikuti langkah-langkah berikut untuk mengubah batas waktu ack fungsi:

1. Di konsol Google Cloud , buka Cloud Run:

   Buka Cloud Run

2. Temukan fungsi yang ingin Anda update dalam daftar Layanan, lalu klik untuk membuka detail fungsi tersebut.

3. Buka tab Pemicu.

4. Klik nama pemicu untuk membuka Detail pemicu.

5. Klik link Topik untuk membuka panel pengeditan topik.

6. Klik nama ID Langganan untuk membuka panel langganan, lalu klik Edit di bagian atas halaman.

7. Tetapkan nilai untuk Batas Waktu Konfirmasi menjadi 600, lalu klik Perbarui untuk menyimpan perubahan.

gcloud

Perbarui batas waktu ack per pemicu ke nilai maksimum 600 detik. Perhatikan bahwa perintah berikut mereferensikan variabel (TRIGGER_NAME dan REGION) yang nilainya Anda tetapkan pada langkah sebelumnya.

## Per Cloud Run function:

# Update Ack Deadline to max (600s)
SUBSCRIPTION_ID=$(gcloud eventarc triggers describe "$TRIGGER_NAME" --location $REGION --format json | jq -r '.transport.pubsub.subscription')
gcloud pubsub subscriptions update "$SUBSCRIPTION_ID" --ack-deadline=600

Lakukan update massal pada semua pemicu layanan dan fungsi untuk menetapkan batas waktu ack menjadi 600 detik:

### Match all Cloud Run service triggers and update all deadlines to 600s (max timeout)
### This will change ALL Cloud Run Service and Cloud Run function
TRIGGER_NAMES=($(gcloud eventarc triggers list | awk '/Cloud Run service/ {print $1}'))

if [ ${#TRIGGER_NAMES[@]} -eq 0 ]; then
  echo "No matching triggers found"
fi

for trigger in "${TRIGGER_NAMES[@]}"; do
echo "Updating ack deadline for trigger: $trigger"
SUBSCRIPTION_ID=$(gcloud eventarc triggers describe "$trigger" --location $REGION --format json | jq -r '.transport.pubsub.subscription')

if [ -z "$SUBSCRIPTION_ID" ]; then
    echo "Error: Could not retrieve subscription ID for trigger: $trigger"
    continue # Skip to the next trigger
fi
gcloud pubsub subscriptions update "$SUBSCRIPTION_ID" --ack-deadline=600
echo "Ack deadline updated for subscription: $SUBSCRIPTION_ID"
done