AWS Batch pekerjaan sebagai EventBridge target

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? 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 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 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. Contohnya, tugas cron terjadi hanya selama jam penggunaan rendah ketika Instans Spot Amazon EC2 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.

Membuat AWS Batch pekerjaan terjadwal

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/.

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

3. Di panel navigasi, pilih Aturan.

4. Pilih Buat aturan.

5. 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 (_).

   catatan

   Aturan tidak boleh memiliki nama yang sama dengan aturan lain di Wilayah yang sama dan di bus peristiwa yang sama.

6. (Opsional) Untuk Deskripsi, masukkan deskripsi untuk aturan.

7. 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 AWS layanan di akun Anda memancarkan acara, itu selalu masuk ke bus acara default akun Anda.

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

9. Untuk jenis Aturan, pilih Jadwal.

10. Pilih Lanjutkan untuk membuat aturan atau Berikutnya.

11. 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 Panduan EventBridge Pengguna Amazon.

    • Pilih jadwal yang berjalan dengan tarif reguler, seperti setiap 10 menit. dan kemudian masukkan ekspresi tingkat.

12. Pilih Berikutnya.

13. Untuk Tipe target, pilih AWS layanan.

14. 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.

    • Job attempts (Upaya tugas): (Opsional) Masukkan jumlah untuk mencoba kembali tugas Anda jika gagal. Untuk informasi selengkapnya, lihat Percobaan kembali tugas secara otomatis.

15. 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.

16. (Opsional) Perluas Pengaturan tambahan.

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

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

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

    4. 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.

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

18. Pilih Berikutnya.

19. (Opsional) Untuk Tag, pilih Tambahkan tag baru untuk menambahkan label sumber daya untuk aturan. Untuk informasi selengkapnya, lihat EventBridge Tag Amazon.

20. Pilih Berikutnya.

21. 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 di Panduan EventBridge Pengguna Amazon.

Membuat aturan dengan pola acara

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/.

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

3. Di panel navigasi, pilih Aturan.

4. Pilih Buat aturan.

5. 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 (_).

   catatan

   Aturan tidak boleh memiliki nama yang sama dengan aturan lain di Wilayah yang sama dan di bus peristiwa yang sama.

6. (Opsional) Untuk Deskripsi, masukkan deskripsi untuk aturan.

7. 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 AWS layanan di akun Anda memancarkan acara, itu selalu masuk ke bus acara default akun Anda.

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

9. Untuk Tipe aturan, pilih Aturan dengan pola peristiwa.

10. Pilih Selanjutnya.

11. Untuk Sumber Acara, pilih AWS acara atau acara EventBridge mitra.

12. (Opsional) Untuk acara Sampel:

    1. Untuk jenis acara Contoh, pilih AWS acara.

    2. Untuk contoh peristiwa, pilih Batch Job State Change.

13. Untuk metode Creation, pilih Gunakan formulir pola.

14. Untuk pola Acara:

    1. Untuk Sumber peristiwa, pilih AWS layanan.

    2. Untuk AWS layanan, pilih Batch.

    3. Untuk jenis Event, pilih Batch Job State Change.

15. Pilih Berikutnya.

16. Untuk Tipe target, pilih AWS layanan.

17. 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.

    • Job attempts (Upaya tugas): (Opsional) Masukkan jumlah untuk mencoba kembali tugas Anda jika gagal. Untuk informasi selengkapnya, lihat Percobaan kembali tugas secara otomatis.

18. 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.

19. (Opsional) Perluas Pengaturan tambahan.

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

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

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

    4. 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.

20. (Opsional) Pilih Tambahkan target lain untuk menambahkan target tambahan.

21. Pilih Berikutnya.

22. (Opsional) Untuk Tag, pilih Tambahkan tag baru untuk menambahkan label sumber daya. Untuk informasi selengkapnya, lihat EventBridge tag Amazon di Panduan EventBridge Pengguna Amazon.

23. Pilih Berikutnya.

24. 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 di Panduan EventBridge Pengguna Amazon.

Meneruskan informasi acara ke AWS Batch Target sesuai jadwal menggunakan transformator EventBridge input

Anda dapat menggunakan transformator EventBridge input untuk meneruskan informasi acara ke AWS Batch dalam pengiriman 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/.

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

3. Di panel navigasi, pilih Aturan.

4. Pilih Buat aturan.

5. 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 (_).

   catatan

   Aturan tidak dapat memiliki nama yang sama dengan aturan lain di bus acara yang sama Wilayah AWS dan di bus acara yang sama.

6. (Opsional) Untuk Deskripsi, masukkan deskripsi untuk aturan.

7. 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 AWS layanan di akun Anda memancarkan acara, itu selalu masuk ke bus acara default akun Anda.

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

9. Untuk jenis Aturan, pilih Jadwal.

10. Pilih Lanjutkan untuk membuat aturan atau Berikutnya.

11. 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 Panduan EventBridge Pengguna Amazon.

    • Pilih jadwal yang berjalan dengan tarif reguler, seperti setiap 10 menit. dan kemudian masukkan ekspresi tingkat.

12. Pilih Berikutnya.

13. Untuk Tipe target, pilih AWS layanan.

14. 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.

    • Job attempts (Upaya tugas): (Opsional) Masukkan jumlah untuk mencoba kembali tugas Anda jika gagal. Untuk informasi selengkapnya, lihat Percobaan kembali tugas secara otomatis.

15. 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.

16. (Opsional) Perluas Pengaturan tambahan.

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

18. Pilih Konfigurasikan transformator input.

19. (Opsional) Untuk acara Sampel:

    1. Untuk jenis acara Contoh, pilih AWS acara.

    2. Untuk contoh peristiwa, pilih Batch Job State Change.

20. 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"
    }

21. Untuk Template, masukkan yang berikut ini.

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

22. Pilih Konfirmasi.

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

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

25. 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.

26. (Opsional) Pilih Tambahkan target lain untuk menambahkan target tambahan.

27. Pilih Berikutnya.

28. (Opsional) Untuk Tag, pilih Tambahkan tag baru untuk menambahkan label sumber daya. Untuk informasi selengkapnya, lihat EventBridge tag Amazon di Panduan EventBridge Pengguna Amazon.

29. Pilih Berikutnya.

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