Menggunakan Amazon EventBridge Scheduler untuk memulai eksekusi mesin status Step Functions

Amazon EventBridge Scheduler adalah penjadwal tanpa server yang memungkinkan Anda membuat, menjalankan, dan mengelola tugas dari satu layanan terpusat dan terkelola. Dengan EventBridge Scheduler, Anda dapat membuat jadwal menggunakan ekspresi cron dan rate untuk pola berulang, atau mengonfigurasi pemanggilan satu kali. Anda dapat mengatur jendela waktu fleksibel untuk pengiriman, menentukan batas coba lagi, dan mengatur waktu retensi maksimum untuk pemanggilan API yang gagal.

Misalnya, dengan EventBridge Scheduler, Anda dapat memulai eksekusi mesin status pada jadwal ketika peristiwa terkait keamanan terjadi atau untuk mengotomatiskan pekerjaan pemrosesan data.

Halaman ini menjelaskan cara menggunakan EventBridge Scheduler untuk memulai eksekusi mesin status Step Functions sesuai jadwal.

Siapkan peran eksekusi

Saat Anda membuat jadwal baru, EventBridge Scheduler harus memiliki izin untuk menjalankan operasi API targetnya atas nama Anda. Anda memberikan izin ini ke EventBridge Scheduler menggunakan peran eksekusi. Kebijakan izin yang Anda lampirkan ke peran eksekusi jadwal menentukan izin yang diperlukan. Izin ini bergantung pada API target yang ingin Anda panggil EventBridge Scheduler.

Bila Anda menggunakan konsol EventBridge Scheduler untuk membuat jadwal, seperti dalam prosedur berikut, EventBridge Scheduler secara otomatis mengatur peran eksekusi berdasarkan target yang Anda pilih. Jika Anda ingin membuat jadwal menggunakan salah satu EventBridge Scheduler SDKs, atau AWS CLI AWS CloudFormation, Anda harus memiliki peran eksekusi yang ada yang memberikan izin EventBridge Scheduler memerlukan untuk memanggil target. Untuk informasi selengkapnya tentang mengatur peran eksekusi secara manual untuk jadwal Anda, lihat Menyiapkan peran eksekusi di Panduan Pengguna EventBridge Penjadwal.

Buat jadwal

Untuk membuat jadwal dengan menggunakan konsol

1. Buka konsol Amazon EventBridge Scheduler di https://console.aws.amazon.com/scheduler/rumah.

2. Pada halaman Jadwal, pilih Buat jadwal.

3. Pada halaman Tentukan detail jadwal, di bagian Nama jadwal dan deskripsi, lakukan hal berikut:

   1. Untuk nama Jadwal, masukkan nama untuk jadwal Anda. Misalnya, MyTestSchedule.

   2. (Opsional) Untuk Deskripsi, masukkan deskripsi untuk jadwal Anda. Misalnya, My first schedule.

   3. Untuk grup Jadwal, pilih grup jadwal dari daftar dropdown. Jika Anda tidak memiliki grup, pilih default. Untuk membuat grup jadwal, pilih buat jadwal Anda sendiri.

      Anda menggunakan grup jadwal untuk menambahkan tag ke grup jadwal.

4. 1. Pilih opsi jadwal Anda.

      Kejadian	Lakukan ini...
      Jadwal satu kali Jadwal satu kali memanggil target hanya sekali pada tanggal dan waktu yang Anda tentukan.	Untuk tanggal dan waktu, lakukan hal berikut: Masukkan tanggal yang valid dalam YYYY/MM/DD format. Masukkan stempel waktu dalam format 24 jamhh:mm. Untuk Timezone, pilih zona waktu.
      Jadwal berulang Jadwal berulang memanggil target pada tingkat yang Anda tentukan menggunakan cron ekspresi atau ekspresi tingkat.	Untuk jenis Jadwal, lakukan salah satu hal berikut: Untuk menggunakan ekspresi cron untuk menentukan jadwal, pilih Jadwal berbasis Cron dan masukkan ekspresi cron. Untuk menggunakan ekspresi tingkat untuk menentukan jadwal, pilih Jadwal berbasis tingkat dan masukkan ekspresi laju. Untuk informasi selengkapnya tentang ekspresi cron dan rate, lihat Menjadwalkan jenis pada EventBridge Scheduler di Panduan Pengguna EventBridge Penjadwal Amazon. Untuk jendela waktu Fleksibel, pilih Nonaktif untuk mematikan opsi, atau pilih salah satu jendela waktu yang telah ditentukan sebelumnya. Misalnya, jika Anda memilih 15 menit dan Anda menetapkan jadwal berulang untuk memanggil targetnya setiap jam sekali, jadwal berjalan dalam 15 menit setelah dimulainya setiap jam.

5. (Opsional) Jika Anda memilih Jadwal berulang pada langkah sebelumnya, di bagian Jangka Waktu, lakukan hal berikut:

   1. Untuk Timezone, pilih zona waktu.

   2. Untuk Tanggal dan waktu mulai, masukkan tanggal yang valid dalam YYYY/MM/DD format, lalu tentukan stempel waktu dalam format 24 jamhh:mm.

   3. Untuk Tanggal dan waktu berakhir, masukkan tanggal yang valid dalam YYYY/MM/DD format, lalu tentukan stempel waktu dalam format 24 jamhh:mm.

6. Pilih Berikutnya.

7. Pada halaman Select target, pilih operasi AWS API yang dipanggil EventBridge Scheduler:

   1. Pilih AWS Step Functions StartExecution.

   2. Di StartExecutionbagian ini, pilih mesin negara atau pilih Buat mesin negara baru.

      Saat ini, Anda tidak dapat menjalankan alur kerja Synchronous Express sesuai jadwal.

   3. Masukkan payload JSON untuk eksekusi. Bahkan jika mesin status Anda tidak memerlukan payload JSON, Anda masih harus menyertakan input dalam format JSON seperti yang ditunjukkan pada contoh berikut.

      {
          "Comment": "sampleJSONData"
      }

8. Pilih Berikutnya.

9. Pada halaman Pengaturan, lakukan hal berikut:

   1. Untuk mengaktifkan jadwal, di bawah Status jadwal, alihkan Aktifkan jadwal.

   2. Untuk mengonfigurasi kebijakan coba lagi untuk jadwal Anda, di bawah Kebijakan Coba ulang dan antrian surat mati (DLQ), lakukan hal berikut:

      • Beralih Coba Lagi.

      • Untuk usia maksimum acara, masukkan jam maksimum dan min yang harus disimpan oleh EventBridge Scheduler untuk menyimpan acara yang belum diproses.

      • Waktu maksimum adalah 24 jam.

      • Untuk percobaan ulang Maksimum, masukkan jumlah maksimum kali EventBridge Scheduler mencoba ulang jadwal jika target mengembalikan kesalahan.

        Nilai maksimum adalah 185 percobaan ulang.

      Dengan kebijakan coba lagi, jika jadwal gagal memanggil targetnya, EventBridge Scheduler menjalankan kembali jadwal. Jika dikonfigurasi, Anda harus mengatur waktu retensi maksimum dan mencoba ulang untuk jadwal.

   3. Pilih tempat EventBridge Scheduler menyimpan acara yang tidak terkirim.

      Opsi antrian surat mati (DLQ)	Lakukan ini...
      Jangan simpan	Pilih Tidak Ada.
      Simpan acara di tempat yang sama Akun AWS di mana Anda membuat jadwal	Pilih Pilih antrian Amazon SQS di saya Akun AWS sebagai DLQ. Pilih Nama Sumber Daya Amazon (ARN) dari antrian Amazon SQS.
      Simpan acara di tempat yang berbeda Akun AWS dari tempat Anda membuat jadwal	Pilih Tentukan antrean Amazon SQS di lain Akun AWS sebagai DLQ. Masukkan Nama Sumber Daya Amazon (ARN) dari antrian Amazon SQS.

   4. Untuk menggunakan kunci yang dikelola pelanggan untuk mengenkripsi input target Anda, di bawah Enkripsi, pilih Sesuaikan pengaturan enkripsi (lanjutan).

      Jika Anda memilih opsi ini, masukkan ARN kunci KMS yang ada atau pilih AWS KMS key Buat untuk menavigasi ke AWS KMS konsol. Untuk informasi selengkapnya tentang cara EventBridge Scheduler mengenkripsi data Anda saat istirahat, lihat Enkripsi saat istirahat di Panduan Pengguna EventBridge Penjadwal Amazon.

   5. Agar EventBridge Scheduler membuat peran eksekusi baru untuk Anda, pilih Buat peran baru untuk jadwal ini. Kemudian, masukkan nama untuk nama Peran. Jika Anda memilih opsi ini, EventBridge Scheduler melampirkan izin yang diperlukan untuk target template Anda ke peran.

10. Pilih Berikutnya.

11. Di halaman Tinjau dan buat jadwal, tinjau detail jadwal Anda. Di setiap bagian, pilih Edit untuk kembali ke langkah itu dan mengedit detailnya.

12. Pilih Buat jadwal.

    Anda dapat melihat daftar jadwal baru dan yang sudah ada di halaman Jadwal. Di bawah kolom Status, verifikasi bahwa jadwal baru Anda Diaktifkan.

Untuk mengonfirmasi bahwa EventBridge Scheduler memanggil mesin status, periksa log Amazon CloudWatch mesin status.

Sumber daya terkait

Untuk informasi selengkapnya tentang EventBridge Scheduler, lihat berikut ini:

• EventBridge Panduan Pengguna Penjadwal

• EventBridge Referensi API Scheduler

• EventBridge Harga Penjadwal