Memulai dengan EventBridge Scheduler - EventBridge Penjadwal
PrasyaratMenggunakan konsolMenggunakan AWS CLIMenggunakan SDKsApa selanjutnya?

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

Memulai dengan EventBridge Scheduler

Topik ini menjelaskan pembuatan EventBridge jadwal Scheduler baru. Anda menggunakan konsol EventBridge Scheduler, AWS Command Line Interface (AWS CLI), atau AWS SDKs untuk membuat jadwal dengan target Amazon SQS template. Kemudian, Anda akan mengatur logging, mengonfigurasi percobaan ulang, dan menetapkan waktu retensi maksimum untuk tugas yang gagal. Setelah membuat jadwal, Anda akan memverifikasi bahwa jadwal Anda berhasil memanggil target dan mengirim pesan ke antrean target.

catatan

Untuk mengikuti panduan ini, kami sarankan Anda mengatur IAM pengguna dengan izin minimum yang diperlukan yang dijelaskan dalamMenggunakan kebijakan berbasis identitas di Scheduler EventBridge . Setelah Anda membuat dan mengkonfigurasi pengguna, jalankan perintah berikut untuk mengatur kredensi akses Anda. Anda akan memerlukan ID kunci akses dan kunci akses rahasia untuk mengonfigurasi file AWS CLI. 

$ aws configure
AWS Access Key ID [None]: AKIAIOSFODNN7EXAMPLE
AWS Secret Access Key [None]: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
Default region name [None]: us-west-2
Default output format [None]: json

Untuk informasi selengkapnya tentang berbagai cara mengatur kredensialnya, lihat Pengaturan dan prioritas konfigurasi di Panduan AWS Command Line Interface Pengguna untuk Versi 2.

Prasyarat

Sebelum mencoba langkah-langkah di bagian ini, Anda harus melakukan hal berikut:

Buat jadwal menggunakan konsol EventBridge Scheduler

Untuk membuat jadwal baru menggunakan konsol

  1. Masuk ke AWS Management Console, lalu pilih tautan berikut untuk membuka bagian EventBridge Penjadwal EventBridge konsol: https://us-west-2.console.aws.amazon.com/scheduler/rumah? wilayah=us-barat-2 #home

    catatan

    Anda dapat beralih Wilayah AWS dengan menggunakan pemilih Wilayah. AWS Management Console

  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. Sebagai contoh, MyTestSchedule.

    2. Untuk Deskripsi - opsional, masukkan deskripsi untuk jadwal Anda. Misalnya, My first schedule.

    3. Untuk grup Jadwal, pilih grup jadwal dari opsi drop-down. Jika sebelumnya Anda belum membuat grup jadwal, Anda dapat memilih default grup untuk jadwal Anda. Untuk membuat grup jadwal baru, pilih tautan buat jadwal Anda sendiri di deskripsi konsol. Anda menggunakan grup jadwal untuk menambahkan tag ke grup jadwal.

  4. Di bagian Pola Jadwal, lakukan hal berikut:

    1. Untuk Kejadian, pilih salah satu opsi pola berikut. Opsi konfigurasi berubah tergantung pada pola mana yang Anda pilih.

      • Jadwal satu kali — Jadwal satu kali memanggil target hanya sekali pada tanggal dan waktu yang Anda tentukan.

        Untuk Tanggal dan waktu, masukkan tanggal yang valid dalam YYYY/MM/DD format. Kemudian, tentukan stempel waktu dalam format 24 jamhh:mm. Terakhir, pilih zona waktu dari opsi drop-down.

      • Jadwal berulang — Jadwal berulang memanggil target pada tingkat yang Anda tentukan menggunakan cron ekspresi atau ekspresi tingkat.

        Pilih jadwal berbasis Cron untuk mengonfigurasi jadwal dengan menggunakan ekspresi. cron Untuk menggunakan ekspresi tingkat, pilih Jadwal berbasis tarif dan masukkan angka positif untuk Nilai, lalu pilih Unit dari opsi drop-down.

      Untuk informasi selengkapnya tentang penggunaan ekspresi cron dan rate, lihatJenis jadwal di EventBridge Scheduler.

    2. Untuk jendela waktu Fleksibel, pilih Nonaktif untuk mematikan opsi, atau pilih salah satu jendela waktu yang telah ditentukan sebelumnya dari daftar drop-down. 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. Jika Anda memilih Jadwal berulang pada langkah sebelumnya, di bagian Jangka waktu, tentukan zona waktu, dan secara opsional tetapkan tanggal dan waktu mulai, serta tanggal dan waktu akhir untuk jadwal tersebut. Jadwal berulang tanpa tanggal mulai akan dimulai segera setelah dibuat dan tersedia. Jadwal berulang tanpa tanggal akhir akan terus memanggil targetnya tanpa batas waktu.

  6. Pilih Berikutnya.

  7. Pada halaman Pilih target, lakukan hal berikut:

    1. Pilih target Templated dan pilih targetAPI. Untuk contoh ini, kita akan memilih target SQS SendMessage template Amazon.

    2. Pada SendMessagebagian, untuk SQSantrian, pilih SQS antrian Amazon yang ada ARN seperti arn:aws:sqs:us-west-2:123456789012:TestQueue dari daftar drop-down. Untuk membuat antrean baru, pilih Buat SQS antrean baru untuk menavigasi ke konsol AmazonSQS. Setelah selesai membuat antrian, kembali ke konsol EventBridge Scheduler dan segarkan drop-down. Antrian baru Anda ARN muncul dan dapat dipilih.

    3. Untuk Target, masukkan payload yang ingin Anda kirimkan EventBridge Scheduler ke target. Untuk contoh ini, kami akan mengirim pesan berikut ke antrian target: Hello, it's EventBridge Scheduler.

  8. Pilih Berikutnya, lalu pada halaman Pengaturan - opsional, lakukan hal berikut:

    1. Di bagian Status jadwal, untuk Aktifkan jadwal, aktifkan atau nonaktifkan fitur menggunakan sakelar. Secara default, EventBridge Scheduler memungkinkan jadwal Anda.

    2. Di bagian Tindakan setelah jadwal selesai, konfigurasikan tindakan yang dilakukan EventBridge Penjadwal setelah jadwal selesai:

      • Pilih DELETEapakah Anda ingin jadwal dihapus secara otomatis. Untuk jadwal satu kali, ini terjadi setelah jadwal memanggil target sekali. Untuk jadwal berulang, ini terjadi setelah pemanggilan terakhir jadwal yang direncanakan. Untuk informasi selengkapnya tentang penghapusan otomatis, lihat. Penghapusan setelah jadwal selesai

      • Pilih NONE, atau jangan pilih nilai, jika Anda tidak ingin EventBridge Scheduler mengambil tindakan apa pun setelah jadwal selesai.

    3. Di bagian Coba lagi kebijakan dan antrean huruf mati (DLQ), untuk kebijakan Coba lagi, aktifkan Coba lagi untuk mengonfigurasi kebijakan coba lagi untuk jadwal Anda. 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.

    4. Untuk Usia maksimum acara - opsional, masukkan jam maksimum dan min yang harus disimpan oleh EventBridge Scheduler untuk menyimpan acara yang belum diproses.

      catatan

      Nilai maksimum adalah 24 jam.

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

      catatan

      Nilai maksimum adalah 185 percobaan ulang.

    6. Untuk antrian Dead-letter (DLQ), pilih dari opsi berikut:

      • Tidak ada — Pilih opsi ini jika Anda tidak ingin mengkonfigurasi fileDLQ.

      • Pilih SQS antrian Amazon di AWS akun saya sebagai DLQ — Pilih opsi ini, lalu pilih antrian ARN dari daftar drop-down, DLQ konfigurasikan Akun AWS sama dengan yang Anda buat jadwal.

      • Tentukan SQS antrian Amazon di AWS akun lain sebagai DLQ — Pilih opsi ini, lalu masukkan antrean konfigurasi sebagaiDLQ, jika antrean ada di lain. ARN Akun AWS Anda harus memasukkan persis ARN antrian untuk menggunakan opsi ini.

    7. Di bagian Enkripsi, pilih Sesuaikan pengaturan enkripsi (lanjutan) untuk menggunakan KMS kunci yang dikelola pelanggan untuk mengenkripsi input target Anda. Jika Anda memilih opsi ini, masukkan KMS kunci yang ada ARN atau pilih Buat AWS KMS kunci untuk menavigasi ke AWS KMS konsol. Untuk informasi selengkapnya tentang cara EventBridge Scheduler mengenkripsi data Anda saat istirahat, lihat. Enkripsi saat istirahat di EventBridge Scheduler

    8. Untuk Izin, pilih Gunakan peran yang ada, lalu pilih peran yang Anda buat selama prosedur penyiapan dari daftar drop-down. Anda juga dapat memilih Pergi ke IAM konsol untuk membuat peran baru.

      Jika Anda ingin 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 menambahkan 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 untuk menyelesaikan pembuatan jadwal baru Anda. Anda dapat melihat daftar jadwal baru dan yang sudah ada di halaman Jadwal. Di bawah kolom Status, verifikasi bahwa jadwal baru Anda Diaktifkan.

  13. Untuk memverifikasi bahwa jadwal Anda memanggil SQS target Amazon, buka SQS konsol Amazon dan lakukan hal berikut:

    1. Pilih antrian target dari daftar Antrian.

    2. Pilih Kirim dan terima pesan.

    3. Pada halaman Kirim dan terima pesan, di bawah Menerima pesan, pilih Poll untuk pesan untuk mengambil pesan uji yang dikirim oleh jadwal Anda ke antrean target.

Buat jadwal menggunakan AWS CLI

Contoh berikut menunjukkan cara menggunakan AWS CLI perintah create-scheduleuntuk membuat jadwal EventBridge Scheduler dengan target Amazon SQS template. Ganti nilai placeholder untuk parameter berikut dengan informasi Anda:

  • --name — Masukkan nama untuk jadwal.

  • RoleArn— Masukkan ARN peran eksekusi yang ingin Anda kaitkan dengan jadwal.

  • Arn — Masukkan ARN target. Dalam hal ini, targetnya adalah SQS antrian Amazon.

  • Input — Masukkan pesan yang EventBridge Scheduler kirimkan ke antrian target.

$ aws scheduler create-schedule --name sqs-templated-schedule --schedule-expression 'rate(5 minutes)' \
--target '{"RoleArn": "ROLE_ARN", "Arn": "QUEUE_ARN", "Input": "TEST_PAYLOAD" }' \
--flexible-time-window '{ "Mode": "OFF"}'

Buat jadwal menggunakan EventBridge Scheduler SDKs

Dalam contoh berikut, Anda menggunakan EventBridge Scheduler SDKs untuk membuat jadwal EventBridge Scheduler dengan target Amazon SQS template.

contoh Python SDK
import boto3
scheduler = boto3.client('scheduler')

flex_window = { "Mode": "OFF" }

sqs_templated = {
    "RoleArn": "<ROLE_ARN>",
    "Arn": "<QUEUE_ARN>",
    "Input": "Message for scheduleArn: '<aws.scheduler.schedule-arn>', scheduledTime: '<aws.scheduler.scheduled-time>'"
}

scheduler.create_schedule(
    Name="sqs-python-templated",
    ScheduleExpression="rate(5 minutes)",
    Target=sqs_templated,
    FlexibleTimeWindow=flex_window)
contoh Jawa SDK
package com.example;

import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.scheduler.SchedulerClient;
import software.amazon.awssdk.services.scheduler.model.*;


public class MySchedulerApp {

    public static void main(String[] args) {
        
        final SchedulerClient client = SchedulerClient.builder()
                .region(Region.US_WEST_2)
                .build();
        
        Target sqsTarget = Target.builder()
                .roleArn("<ROLE_ARN>")
                .arn("<QUEUE_ARN>")
                .input("Message for scheduleArn: '<aws.scheduler.schedule-arn>', scheduledTime: '<aws.scheduler.scheduled-time>'")
                .build();
        
        CreateScheduleRequest createScheduleRequest = CreateScheduleRequest.builder()
                .name("<SCHEDULE NAME>")
                .scheduleExpression("rate(10 minutes)")
                .target(sqsTarget)
                .flexibleTimeWindow(FlexibleTimeWindow.builder()
                        .mode(FlexibleTimeWindowMode.OFF)
                        .build())
                .build();
                
        client.createSchedule(createScheduleRequest);
        System.out.println("Created schedule with rate expression and an Amazon SQS templated target");
    }
}

Apa selanjutnya?