

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

# AWS Batch pekerjaan sebagai EventBridge target
<a name="batch-cwe-target"></a>

Amazon EventBridge memberikan aliran peristiwa sistem yang mendekati real-time yang menjelaskan perubahan dalam sumber daya Amazon Web Services. Biasanya, AWS Batch di Amazon Elastic Container Service, Amazon Elastic Kubernetes Service, AWS dan pekerjaan Fargate tersedia sebagai target. EventBridge Dengan menggunakan aturan sederhana, Anda dapat mencocokkan acara dan mengirimkan AWS Batch pekerjaan sebagai tanggapan terhadapnya. Untuk informasi lebih lanjut, lihat [Apa itu EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html) di *Panduan EventBridge Pengguna Amazon*.

Anda juga dapat menggunakan EventBridge untuk menjadwalkan tindakan otomatis yang dipanggil pada waktu-waktu tertentu menggunakan **cron** atau menilai ekspresi. Untuk informasi selengkapnya, lihat [Membuat EventBridge aturan Amazon yang berjalan sesuai jadwal](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html) di *Panduan EventBridge Pengguna Amazon*. 

Untuk informasi tentang cara membuat aturan yang berjalan saat peristiwa cocok dengan pola peristiwa, lihat [Membuat EventBridge aturan Amazon yang bereaksi terhadap peristiwa](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) di *Panduan EventBridge Pengguna Amazon*.

Kasus penggunaan umum untuk AWS Batch pekerjaan sebagai EventBridge target meliputi kasus penggunaan berikut:
+ Pekerjaan terjadwal terjadi pada interval waktu yang teratur. Misalnya, **cron** pekerjaan hanya terjadi selama jam penggunaan rendah ketika Instans EC2 Spot Amazon lebih murah.
+  AWS Batch Pekerjaan berjalan sebagai respons terhadap operasi API yang masuk CloudTrail. Misalnya, pekerjaan dikirimkan setiap kali objek diunggah ke bucket Amazon S3 yang ditentukan. Setiap kali ini terjadi, transformator EventBridge input melewati ember dan nama kunci objek ke AWS Batch parameter.
**catatan**  
Dalam skenario ini, semua sumber AWS daya terkait harus berada di Wilayah yang sama. Ini termasuk sumber daya seperti bucket Amazon S3, EventBridge aturan, dan CloudTrail log.

Sebelum Anda dapat mengirimkan AWS Batch pekerjaan dengan EventBridge aturan dan target, EventBridge layanan memerlukan beberapa izin untuk menjalankan AWS Batch pekerjaan. Saat membuat aturan di EventBridge konsol yang menentukan AWS Batch pekerjaan sebagai target, Anda juga dapat membuat peran ini. Untuk informasi lebih lanjut tentang pelaku utama layanan dan izin IAM yang diperlukan untuk peran ini, lihat [EventBridge Peran IAM](CWE_IAM_role.md).

**Topics**
+ [Tutorial: Buat AWS Batch pekerjaan terjadwal](scheduled-batch-job.md)
+ [Tutorial: Buat aturan dengan pola acara](event-pattern-batch-job.md)
+ [Tutorial: Berikan informasi acara ke AWS Batch target sesuai jadwal menggunakan transformator EventBridge input](cwe-input-transformer.md)

# Tutorial: Buat AWS Batch pekerjaan terjadwal
<a name="scheduled-batch-job"></a>

Prosedur berikut mencakup cara membuat AWS Batch pekerjaan terjadwal dan peran EventBridge IAM yang diperlukan.

**Untuk membuat AWS Batch pekerjaan terjadwal dengan EventBridge**
**catatan**  
Prosedur ini berfungsi untuk semua AWS Batch di Amazon ECS, Amazon EKS, dan pekerjaan AWS Fargate.

1. Buka EventBridge konsol Amazon di [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. Dari bilah navigasi, pilih yang Wilayah AWS akan digunakan.

1. Di panel navigasi, pilih **Aturan**.

1. Pilih **Buat aturan**.

1. Untuk **Nama**, tentukan nama unik untuk lingkungan komputasi Anda. Nama dapat berisi hingga 64 karakter. Nama dapat memuat huruf besar dan huruf kecil, angka, tanda hubung (-), dan garis bawah (\$1).
**catatan**  
Aturan tidak boleh memiliki nama yang sama dengan aturan lain di Wilayah yang sama dan di bus peristiwa yang sama.

1. (Opsional) Untuk **Deskripsi**, masukkan deskripsi untuk aturan.

1. Untuk **bus acara**, pilih bus acara yang ingin Anda kaitkan dengan aturan ini. Jika Anda ingin aturan ini cocok dengan peristiwa yang berasal dari akun Anda, pilih **default**. Ketika Layanan AWS di akun Anda memancarkan acara, itu selalu masuk ke bus acara default akun Anda.

1. (Opsional) Matikan aturan pada bus yang dipilih jika Anda tidak ingin segera menjalankan aturan.

1. Untuk **jenis Aturan**, pilih **Jadwal**.

1. Pilih **Lanjutkan untuk membuat aturan** atau **Berikutnya**.

1. Untuk **pola Jadwal**, lakukan salah satu hal berikut:
   + Pilih **Jadwal berbutir halus yang berjalan pada waktu tertentu, seperti pukul 8:00 pagi PST pada hari Senin pertama setiap bulan** dan kemudian masukkan ekspresi cron. Untuk informasi selengkapnya, lihat [Ekspresi Cron di](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html#eb-cron-expressions) *Panduan EventBridge Pengguna Amazon*.
   + Pilih **jadwal yang berjalan dengan tarif reguler, seperti setiap 10 menit.** dan kemudian masukkan ekspresi tingkat.

1. Pilih **Berikutnya**.

1. Untuk **Tipe target**, pilih **Layanan AWS**.

1. Untuk **Pilih target**, pilih **Antrian pekerjaan Batch**. Kemudian, konfigurasikan yang berikut ini:
   + **Job queue** (Antrean tugas): Masukkan Amazon Resource Name (ARN) dari antrean tugas untuk menjadwalkan tugas Anda.
   + **Job definition** (Ketentuan Tugas): Masukkan nama dan revisi atau ARN lengkap ketentuan tugas yang akan digunakan untuk tugas Anda.
   + **Job name** (Nama tugas): Masukkan nama untuk tugas Anda.
   + **Array size** (Ukuran array): (Opsional) Masukkan ukuran array untuk tugas Anda guna menjalankan lebih dari satu salinan. Untuk informasi selengkapnya, lihat [Tugas array](array_jobs.md).
   + **Job attempts** (Upaya tugas): (Opsional) Masukkan jumlah untuk mencoba kembali tugas Anda jika gagal. Untuk informasi selengkapnya, lihat [Percobaan kembali tugas secara otomatis](job_retries.md).

1. Untuk jenis target **antrian pekerjaan Batch**, EventBridge memerlukan izin untuk mengirim peristiwa ke target. EventBridge dapat membuat peran IAM yang diperlukan agar aturan Anda berjalan. Lakukan salah satu dari langkah berikut ini:
   + Untuk membuat IAM role secara otomatis, pilih **Buat peran baru untuk sumber daya khusus ini**.
   + Untuk menggunakan peran IAM yang telah Anda buat, pilih **Gunakan peran yang ada**.

1. (Opsional) Perluas **Pengaturan tambahan**.

   1. Untuk **Mengonfigurasi input target**, pilih bagaimana teks dari suatu peristiwa diproses sebelum diteruskan ke target.

   1. Untuk **Usia maksimum acara**, tentukan interval waktu untuk berapa lama peristiwa yang belum diproses disimpan.

   1. Untuk **mencoba lagi**, masukkan berapa kali suatu peristiwa dicoba ulang.

   1. Untuk **antrian Dead-letter,** pilih opsi bagaimana peristiwa yang belum diproses ditangani. Jika perlu, tentukan antrian Amazon SQS yang akan digunakan sebagai antrian huruf mati.

1. (Opsional) Pilih **Tambahkan target lain** untuk menambahkan target lain untuk aturan ini.

1. Pilih **Berikutnya**.

1. (Opsional) Untuk **Tag**, pilih **Tambahkan tag baru** untuk menambahkan label sumber daya untuk aturan. Untuk informasi selengkapnya, lihat [ EventBridge Tag Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tagging.html). 

1. Pilih **Berikutnya**.

1. Untuk **Meninjau dan membuat**, tinjau langkah-langkah konfigurasi. Jika Anda perlu melakukan perubahan, pilih **Edit**. Setelah selesai, pilih **Buat aturan**.

Untuk informasi selengkapnya tentang membuat aturan, lihat [Membuat EventBridge aturan Amazon yang berjalan sesuai jadwal](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html) di *Panduan EventBridge Pengguna Amazon*.

# Tutorial: Buat aturan dengan pola acara
<a name="event-pattern-batch-job"></a>

Prosedur berikut mencakup cara membuat aturan dengan pola acara.

**Untuk membuat aturan yang mengirimkan acara ke target saat acara cocok dengan pola yang ditentukan**
**catatan**  
Prosedur ini berfungsi untuk semua AWS Batch di Amazon ECS, Amazon EKS, dan pekerjaan AWS Fargate.

1. Buka EventBridge konsol Amazon di [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. Dari bilah navigasi, pilih yang Wilayah AWS akan digunakan.

1. Di panel navigasi, pilih **Aturan**.

1. Pilih **Buat aturan**.

1. Untuk **Nama**, tentukan nama unik untuk lingkungan komputasi Anda. Nama dapat berisi hingga 64 karakter. Nama dapat memuat huruf besar dan huruf kecil, angka, tanda hubung (-), dan garis bawah (\$1).
**catatan**  
Aturan tidak boleh memiliki nama yang sama dengan aturan lain di Wilayah yang sama dan di bus peristiwa yang sama.

1. (Opsional) Untuk **Deskripsi**, masukkan deskripsi untuk aturan.

1. Untuk **bus acara**, pilih bus acara yang ingin Anda kaitkan dengan aturan ini. Jika Anda ingin aturan ini cocok dengan peristiwa yang berasal dari akun Anda, pilih **default**. Ketika Layanan AWS di akun Anda memancarkan acara, itu selalu masuk ke bus acara default akun Anda.

1. (Opsional) Matikan aturan pada bus yang dipilih jika Anda tidak ingin segera menjalankan aturan.

1. Untuk **Tipe aturan**, pilih **Aturan dengan pola peristiwa**.

1. Pilih **Selanjutnya**.

1. Untuk **Sumber Acara**, pilih **AWS acara atau acara EventBridge mitra**.

1. (Opsional) Untuk **acara Sampel**:

   1. Untuk **jenis acara Contoh**, pilih **AWS acara**.

   1. Untuk **contoh peristiwa**, pilih **Batch Job State Change**.

1. Untuk **metode Creation**, pilih **Gunakan formulir pola**.

1. Untuk **pola Acara**:

   1. Untuk **Sumber peristiwa**, pilih **Layanan AWS**.

   1. Untuk **Layanan AWS**, pilih **Batch**.

   1. Untuk **jenis Event**, pilih **Batch Job State Change**.

1. Pilih **Berikutnya**.

1. Untuk **Tipe target**, pilih **Layanan AWS**.

1. Untuk **Pilih target**, pilih jenis target. Misalnya, pilih **Antrian pekerjaan Batch**. Kemudian tentukan yang berikut ini:
   + **Job queue** (Antrean tugas): Masukkan Amazon Resource Name (ARN) dari antrean tugas untuk menjadwalkan tugas Anda.
   + **Job definition** (Ketentuan Tugas): Masukkan nama dan revisi atau ARN lengkap ketentuan tugas yang akan digunakan untuk tugas Anda.
   + **Job name** (Nama tugas): Masukkan nama untuk tugas Anda.
   + **Array size** (Ukuran array): (Opsional) Masukkan ukuran array untuk tugas Anda guna menjalankan lebih dari satu salinan. Untuk informasi selengkapnya, lihat [Tugas array](array_jobs.md).
   + **Job attempts** (Upaya tugas): (Opsional) Masukkan jumlah untuk mencoba kembali tugas Anda jika gagal. Untuk informasi selengkapnya, lihat [Percobaan kembali tugas secara otomatis](job_retries.md).

1. Untuk jenis target **antrian pekerjaan Batch**, EventBridge memerlukan izin untuk mengirim peristiwa ke target. EventBridge dapat membuat peran IAM yang diperlukan agar aturan Anda berjalan. Lakukan salah satu dari langkah berikut ini:
   + Untuk membuat IAM role secara otomatis, pilih **Buat peran baru untuk sumber daya khusus ini**.
   + Untuk menggunakan peran IAM yang Anda buat sebelumnya, pilih **Gunakan peran yang sudah ada**.

1. (Opsional) Perluas **Pengaturan tambahan**.

   1. Untuk **Mengonfigurasi input target**, pilih bagaimana teks dari suatu peristiwa diproses.

   1. Untuk **Usia maksimum acara**, tentukan interval waktu untuk berapa lama peristiwa yang belum diproses disimpan.

   1. Untuk **mencoba lagi**, masukkan berapa kali suatu peristiwa dicoba ulang.

   1. Untuk **antrian Dead-letter,** pilih opsi bagaimana peristiwa yang belum diproses ditangani. Jika perlu, tentukan antrian Amazon SQS yang akan digunakan sebagai antrian huruf mati.

1. (Opsional) Pilih **Tambahkan target lain** untuk menambahkan target tambahan.

1. Pilih **Berikutnya**.

1. (Opsional) Untuk **Tag**, pilih **Tambahkan tag baru** untuk menambahkan label sumber daya. Untuk informasi selengkapnya, lihat [ EventBridge tag Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tagging.html) *di Panduan EventBridge Pengguna Amazon*.

1. Pilih **Berikutnya**.

1. Untuk **Meninjau dan membuat**, tinjau langkah-langkah konfigurasi. Jika Anda perlu melakukan perubahan, pilih **Edit**. Setelah selesai, pilih **Buat aturan**.

   Untuk informasi selengkapnya tentang membuat aturan, lihat [Membuat EventBridge aturan Amazon yang bereaksi terhadap peristiwa](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html) di *Panduan EventBridge Pengguna Amazon*.

# Tutorial: Berikan informasi acara ke AWS Batch target sesuai jadwal menggunakan transformator EventBridge input
<a name="cwe-input-transformer"></a>

Anda dapat menggunakan transformator EventBridge input untuk meneruskan informasi acara ke AWS Batch dalam pengajuan pekerjaan. Ini bisa sangat berharga jika Anda meminta pekerjaan sebagai hasil dari informasi AWS acara lainnya. Salah satu contohnya adalah upload objek ke bucket Amazon S3. Anda juga dapat menggunakan definisi pekerjaan dengan nilai substitusi parameter dalam perintah container. Transformator EventBridge input dapat memberikan nilai parameter berdasarkan data peristiwa. 

Kemudian, setelah itu, Anda membuat target AWS Batch acara yang mem-parsing informasi dari acara yang memulainya dan mengubahnya menjadi `parameters` objek. Ketika tugas berjalan, parameter dari peristiwa pemicu disampaikan ke perintah kontainer tugas.

**catatan**  
Dalam skenario ini, semua sumber AWS daya (seperti bucket Amazon S3, EventBridge aturan, dan CloudTrail log) harus berada di Wilayah yang sama.

**Untuk membuat AWS Batch target yang menggunakan transformator input**

1. Buka EventBridge konsol Amazon di [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. Dari bilah navigasi, pilih yang Wilayah AWS akan digunakan.

1. Di panel navigasi, pilih **Aturan**.

1. Pilih **Buat aturan**.

1. Untuk **Nama**, tentukan nama unik untuk lingkungan komputasi Anda. Nama dapat berisi hingga 64 karakter. Nama dapat memuat huruf besar dan huruf kecil, angka, tanda hubung (-), dan garis bawah (\$1).
**catatan**  
Aturan tidak dapat memiliki nama yang sama dengan aturan lain di bus acara yang sama Wilayah AWS dan di bus acara yang sama.

1. (Opsional) Untuk **Deskripsi**, masukkan deskripsi untuk aturan.

1. Untuk **bus acara**, pilih bus acara yang ingin Anda kaitkan dengan aturan ini. Jika Anda ingin aturan ini cocok dengan peristiwa yang berasal dari akun Anda, pilih **default**. Ketika Layanan AWS di akun Anda memancarkan acara, itu selalu masuk ke bus acara default akun Anda.

1. (Opsional) Matikan aturan pada bus yang dipilih jika Anda tidak ingin segera menjalankan aturan.

1. Untuk **jenis Aturan**, pilih **Jadwal**.

1. Pilih **Lanjutkan untuk membuat aturan** atau **Berikutnya**.

1. Untuk **pola Jadwal**, lakukan salah satu hal berikut:
   + Pilih **Jadwal berbutir halus yang berjalan pada waktu tertentu, seperti pukul 8:00 pagi PST pada hari Senin pertama setiap bulan** dan kemudian masukkan ekspresi cron. Untuk informasi selengkapnya, lihat [Ekspresi Cron di](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html#eb-cron-expressions) *Panduan EventBridge Pengguna Amazon*.
   + Pilih **jadwal yang berjalan dengan tarif reguler, seperti setiap 10 menit.** dan kemudian masukkan ekspresi tingkat.

1. Pilih **Berikutnya**.

1. Untuk **Tipe target**, pilih **Layanan AWS**.

1. Untuk **Pilih target**, pilih **Antrian pekerjaan Batch**. Kemudian, konfigurasikan yang berikut ini:
   + **Job queue** (Antrean tugas): Masukkan Amazon Resource Name (ARN) dari antrean tugas untuk menjadwalkan tugas Anda.
   + **Job definition** (Ketentuan Tugas): Masukkan nama dan revisi atau ARN lengkap ketentuan tugas yang akan digunakan untuk tugas Anda.
   + **Job name** (Nama tugas): Masukkan nama untuk tugas Anda.
   + **Array size** (Ukuran array): (Opsional) Masukkan ukuran array untuk tugas Anda guna menjalankan lebih dari satu salinan. Untuk informasi selengkapnya, lihat [Tugas array](array_jobs.md).
   + **Job attempts** (Upaya tugas): (Opsional) Masukkan jumlah untuk mencoba kembali tugas Anda jika gagal. Untuk informasi selengkapnya, lihat [Percobaan kembali tugas secara otomatis](job_retries.md).

1. Untuk jenis target **antrian pekerjaan Batch**, EventBridge memerlukan izin untuk mengirim peristiwa ke target. EventBridge dapat membuat peran IAM yang diperlukan agar aturan Anda berjalan. Lakukan salah satu dari langkah berikut ini:
   + Untuk membuat IAM role secara otomatis, pilih **Buat peran baru untuk sumber daya khusus ini**.
   + Untuk menggunakan peran IAM yang telah Anda buat, pilih **Gunakan peran yang ada**.

1. (Opsional) Perluas **Pengaturan tambahan**.

1. Di bagian **Pengaturan tambahan**, untuk **Konfigurasi input target**, pilih **Input Transformer**.

1. Pilih **Konfigurasikan transformator input**.

1. (Opsional) Untuk **acara Sampel**:

   1. Untuk **jenis acara Contoh**, pilih **AWS acara**.

   1. Untuk **contoh peristiwa**, pilih **Batch Job State Change**.

1. Di bagian **Transformator input target**, untuk **Jalur input**, tentukan nilai yang akan diuraikan dari peristiwa pemicu. Misalnya, untuk mengurai peristiwa **Perubahan Status Pekerjaan Batch**, gunakan format JSON berikut.

   ```
   {
       "instance": "$.detail.jobId",
       "state": "$.detail.status"
   }
   ```

1. Untuk **Template**, masukkan yang berikut ini.

   ```
   {
       "instance": <jobId> ,
       "status": <status>
   }
   ```

1. Pilih **Konfirmasi**.

1. Untuk **Usia maksimum acara**, tentukan interval waktu untuk berapa lama peristiwa yang belum diproses disimpan.

1. Untuk **mencoba lagi**, masukkan berapa kali suatu peristiwa dicoba ulang.

1. Untuk **antrian Dead-letter,** pilih opsi bagaimana peristiwa yang belum diproses ditangani. Jika perlu, tentukan antrian Amazon SQS yang akan digunakan sebagai antrian huruf mati.

1. (Opsional) Pilih **Tambahkan target lain** untuk menambahkan target tambahan.

1. Pilih **Berikutnya**.

1. (Opsional) Untuk **Tag**, pilih **Tambahkan tag baru** untuk menambahkan label sumber daya. Untuk informasi selengkapnya, lihat [ EventBridge tag Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tagging.html) *di Panduan EventBridge Pengguna Amazon*.

1. Pilih **Berikutnya**.

1. Untuk **Meninjau dan membuat**, tinjau langkah-langkah konfigurasi. Jika Anda perlu melakukan perubahan, pilih **Edit**. Setelah selesai, pilih **Buat aturan**.