

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Menggunakan EventBridge aturan dengan pipeline Image Builder
<a name="ev-rules-for-pipeline"></a>

Acara dari berbagai layanan AWS dan mitra dialirkan ke bus EventBridge acara Amazon dalam waktu dekat. Anda juga dapat membuat acara khusus, dan mengirim acara dari aplikasi Anda sendiri ke EventBridge. Bus acara menggunakan aturan untuk menentukan ke mana harus merutekan data acara.

Pipeline Image Builder tersedia sebagai target EventBridge aturan, yang berarti Anda dapat menjalankan pipeline Image Builder berdasarkan aturan yang Anda buat untuk merespons peristiwa di bus, atau sesuai jadwal.

Untuk ringkasan peristiwa yang dihasilkan sistem yang dikirimkan Image Builder EventBridge, lihat[Pesan peristiwa yang dikirim Image Builder](integ-eventbridge.md#integ-eb-event-summary).

**catatan**  
Bus acara khusus untuk suatu Wilayah. Aturan dan target harus berada di Wilayah yang sama.

**Topics**
+ [EventBridge istilah](#ev-terms)
+ [Lihat EventBridge aturan untuk pipeline Image Builder](#ev-rules-pipeline-tab)
+ [Gunakan EventBridge aturan untuk menjadwalkan pembuatan pipeline](#ev-rules-schedule-pipeline)

## EventBridge istilah
<a name="ev-terms"></a>

Bagian ini berisi ringkasan istilah untuk membantu Anda memahami cara EventBridge terintegrasi dengan pipeline Image Builder Anda.

Peristiwa  
Menjelaskan perubahan dalam lingkungan yang mungkin memengaruhi satu atau lebih sumber daya aplikasi. Lingkungan dapat berupa AWS lingkungan, layanan atau aplikasi mitra SaaS, atau salah satu aplikasi atau layanan Anda. Anda juga dapat mengatur acara terjadwal pada timeline.

Bus peristiwa  
Pipeline yang menerima data peristiwa dari aplikasi dan layanan.

Sumber  
Layanan atau aplikasi yang mengirimkan acara ke bus acara.

Target  
Sumber daya atau titik akhir yang EventBridge dipanggil saat cocok dengan aturan, mengirimkan data dari acara ke target.

Aturan  
Aturan mencocokkan peristiwa yang masuk dan mengirimkannya ke target untuk pemrosesan. Aturan tunggal dapat mengirim acara ke beberapa target, yang kemudian dapat berjalan secara paralel. Aturan didasarkan baik pada pola peristiwa atau jadwal.

Pola  
Pola peristiwa mendefinisikan struktur acara dan bidang yang cocok dengan aturan untuk memulai tindakan target.

Jadwal  
Aturan jadwal melakukan tindakan sesuai jadwal, seperti menjalankan pipeline Image Builder untuk menyegarkan gambar setiap tiga bulan. Ada dua jenis ekspresi jadwal:   
+ **Ekspresi cron** — Cocokkan kriteria penjadwalan tertentu menggunakan sintaks cron yang dapat menguraikan kriteria sederhana; misalnya, berjalan mingguan pada hari tertentu. Anda juga dapat menetapkan kriteria yang lebih kompleks, seperti berjalan setiap triwulanan pada hari kelima setiap bulan, antara jam 2 pagi dan 4 pagi.
+ **Ekspresi nilai** - Tentukan interval reguler saat target dipanggil, seperti setiap 12 jam.

## Lihat EventBridge aturan untuk pipeline Image Builder
<a name="ev-rules-pipeline-tab"></a>

Tab **EventBridge aturan** di halaman detail **saluran pipa Image Builder Image** menampilkan bus EventBridge acara yang dapat diakses akun Anda, dan aturan untuk bus acara yang dipilih yang berlaku untuk pipeline saat ini. Tab ini juga menautkan langsung ke EventBridge konsol untuk membuat sumber daya baru.

**Tindakan yang menautkan ke EventBridge konsol**
+ **Buat bus acara**
+ **Buat aturan**

Untuk mempelajari selengkapnya EventBridge, lihat topik berikut di *Panduan EventBridge Pengguna Amazon*.
+ [Apa itu Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html)
+ [Bus EventBridge acara Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-bus.html)
+ [ EventBridge Acara Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html)
+ [ EventBridge Aturan Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)

## Gunakan EventBridge aturan untuk menjadwalkan pembuatan pipeline
<a name="ev-rules-schedule-pipeline"></a>

Untuk contoh ini, kita membuat aturan jadwal baru untuk bus acara default, menggunakan ekspresi tingkat. Aturan dalam contoh ini menghasilkan acara di bus acara setiap 90 hari. Acara memulai pembuatan pipeline untuk menyegarkan gambar.

1. Buka konsol EC2 Image Builder di [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/).

1. Untuk melihat daftar pipeline gambar yang dibuat di bawah akun Anda, pilih **Pipeline gambar** dari panel navigasi.
**catatan**  
Daftar pipeline gambar mencakup indikator untuk jenis gambar keluaran yang dibuat oleh pipeline — AMI atau Docker.

1. Untuk melihat detail atau mengedit pipeline, pilih tautan **Nama saluran pipa**. Ini membuka tampilan detail untuk pipa.
**catatan**  
Anda juga dapat memilih kotak centang di sebelah **nama Pipeline**, lalu pilih **Lihat detail**.

1. Buka tab **EventBridge aturan**.

1. Simpan bus acara default yang telah dipilih sebelumnya di panel **Event Bus**.

1. Pilih **Buat aturan**. Ini akan membawa Anda ke halaman **aturan Buat** di EventBridge konsol Amazon.

1. Masukkan nama dan deskripsi aturan. Nama aturan harus unik di dalam bus acara untuk Wilayah yang dipilih.

1. Di panel **Tentukan pola**, pilih opsi **Jadwal**. Ini memperluas panel, dengan **tarif Tetap setiap** opsi dipilih.

1. Masukkan `90` di kotak pertama, dan pilih **Hari** dari daftar drop-down.

1. Lakukan tindakan berikut di panel **Pilih target**:

   1. Pilih `EC2 Image Builder` dari **Target** daftar drop-down.

   1. Untuk menerapkan aturan ke pipeline Image Builder, pilih pipeline target dari daftar drop-down **Image Pipeline**.

   1. EventBridge memerlukan izin untuk memulai build untuk pipeline yang dipilih. Untuk contoh ini, pertahankan opsi default untuk **Membuat peran baru untuk sumber daya khusus ini**.

   1. Pilih **Tambahkan target**.

1. Pilih **Buat**

**catatan**  
Untuk mempelajari setelan aturan ekspresi laju yang tidak tercakup dalam contoh ini, lihat [Nilai ekspresi](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html#eb-rate-expressions) di *Panduan EventBridge Pengguna Amazon*.