Gunakan ekspresi cron di EC2 Image Builder - EC2 Image Builder

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

Gunakan ekspresi cron di EC2 Image Builder

Gunakan ekspresi cron untuk EC2 Image Builder untuk menyiapkan jendela waktu untuk menyegarkan gambar Anda dengan pembaruan yang berlaku untuk gambar dasar dan komponen pipeline Anda. Jendela waktu untuk penyegaran pipeline dimulai dengan waktu yang Anda atur dalam ekspresi cron. Anda dapat mengatur waktu dalam ekspresi cron Anda ke menit. Pembuatan pipeline Anda dapat berjalan pada atau setelah waktu mulai.

Terkadang butuh beberapa detik, atau hingga satu menit agar build Anda mulai berjalan.

catatan

Ekspresi cron menggunakan Universal Coordinated Time (UTC). Untuk informasi selengkapnya tentang waktu UTC, dan untuk menemukan offset untuk zona waktu Anda, lihat Singkatan Zona Waktu — Daftar Seluruh Dunia.

Nilai yang didukung untuk ekspresi cron di Image Builder

EC2 Image Builder menggunakan format cron yang terdiri dari enam bidang wajib. Masing-masing dipisahkan dari yang lain oleh ruang di antaranya, tanpa ruang depan atau belakang:

<Minute> <Hour> <Day> <Month> <Day of the week> <Year>

Tabel berikut menunjukkan nilai support untuk entri cron diperlukan.

Nilai support untuk ekspresi cron
Bidang Nilai Wildcard
Menit 0-59 , - * /
Jam 0-23 , - * /
Hari 1-31 , - * ? / L W
Bulan 1-12 atau jan-dec , - * /
Hari dalam seminggu 1-7 atau sun-sat , - * ? L #
Tahun 1970-2199 , - * /
Wildcard

Tabel berikut menjelaskan bagaimana Image Builder menggunakan wildcard untuk ekspresi cron. Ingatlah bahwa ini dapat memakan waktu hingga satu menit setelah waktu yang Anda tentukan untuk memulai build.

Wildcard support untuk ekspresi cron
Wildcard Deskripsi
, Wildcard , (koma) mencakup nilai tambahan. Di bidang Bulan, jan,feb,mar termasuk Januari, Februari, dan Maret.
- Wildcard - (tanda hubung) menentukan rentang. Di bidang hari bulan, 1-15 termasuk hari 1 hingga 15 dari bulan yang ditentukan.
* Wildcard * (asterisk) mencakup semua nilai yang valid untuk bidang tersebut.
? Wildcard ? (tanda tanya) menentukan bahwa nilai bidang tergantung pada pengaturan lain. Dalam kasus ay-of-week bidang Hari dan D, ketika satu ditentukan atau mencakup semua nilai yang mungkin (*), yang lain harus berupa a?. Anda tidak dapat menentukan keduanya. Misalnya, jika Anda memasukkan kolom 7 in the Day (jalankan build pada hari ketujuh dalam sebulan), ay-of-week posisi D harus berisi a?.
/ Wildcard / (garis miring) menentukan tambahan. Misalnya, jika Anda ingin build Anda berjalan setiap hari, masukkan */2 di kolom hari.
L Wildcard L di salah satu bidang hari, menentukan hari terakhir: 28-31 untuk hari dalam sebulan, tergantung pada bulan apa, atau Minggu, untuk hari dalam seminggu.
W Wildcard W di ay-of-month bidang D menentukan hari kerja. Di ay-of-month bidang D, jika Anda memasukkan nomor sebelumW, itu berarti Anda ingin menargetkan hari kerja yang paling dekat dengan hari itu. Misalnya, jika Anda menentukan3W, Anda ingin build Anda berjalan pada hari kerja yang paling dekat dengan hari ketiga setiap bulan.
# # (hash) hanya diperbolehkan untuk bidang hari dalam seminggu, dan harus diikuti oleh angka antara 1 dan 5. Angka tersebut menentukan minggu mana di bulan tertentu yang berlaku untuk menjalankan build. Misalnya, jika Anda ingin build Anda berjalan pada hari Jumat kedua setiap bulan, gunakan fri#2 untuk bidang hari dalam seminggu.
Pembatasan
  • Anda tidak dapat menentukan ay-of-week bidang D ay-of-month dan D dalam ekspresi cron yang sama. Jika Anda menentukan nilai atau * di salah satu bidang ini, Anda harus menggunakan ? di bidang lainnya.

  • Ekspresi cron yang mengarah ke tingkat lebih cepat dari satu menit tidak didukung.

Contoh ekspresi cron di EC2 Image Builder

Ekspresi cron dimasukkan secara berbeda untuk konsol Image Builder, dibandingkan untuk API atau CLI. Untuk melihat contoh, pilih tab yang berlaku untuk Anda.

Image Builder console

Contoh berikut menunjukkan ekspresi cron yang dapat Anda masukkan ke konsol untuk jadwal build Anda. Waktu UTC ditentukan menggunakan jam 24 jam.

Jalankan setiap hari pada pukul 10:00 (UTC)

0 10 * * ? *

Jalankan setiap hari pukul 12:15 (UTC)

15 12 * * ? *

Jalankan setiap hari pada tengah malam (UTC)

0 0 * * ? *

Jalankan pukul 10:00 pagi (UTC) setiap pagi hari kerja

0 10 ? * 2-6 *

Jalankan pukul 6 sore (UTC) setiap malam hari kerja

0 18 ? * mon-fri *

Jalankan pukul 8:00 pagi (UTC) pada hari pertama setiap bulan

0 8 1 * ? *

Jalankan pada hari Selasa kedua setiap bulan pukul 22:30 (UTC)

30 22 ? * tue#2 *

Tip

Jika Anda tidak ingin pekerjaan pipeline Anda diperpanjang ke hari berikutnya saat sedang berjalan, pastikan Anda memperhitungkan waktu untuk build saat menentukan waktu mulai.

API/CLI

Contoh berikut menunjukkan ekspresi cron yang dapat Anda masukkan untuk jadwal build menggunakan perintah CLI atau permintaan API. Hanya ekspresi cron yang ditampilkan.

Jalankan setiap hari pada pukul 10:00 (UTC)

cron(0 10 * * ? *)

Jalankan setiap hari pukul 12:15 (UTC)

cron(15 12 * * ? *)

Jalankan setiap hari pada tengah malam (UTC)

cron(0 0 * * ? *)

Jalankan pukul 10:00 pagi (UTC) setiap pagi hari kerja

cron(0 10 ? * 2-6 *)

Jalankan pukul 18:00 (UTC) setiap malam hari kerja

cron(0 18 ? * mon-fri *)

Jalankan pukul 8:00 pagi (UTC) pada hari pertama setiap bulan

cron(0 8 1 * ? *)

Jalankan pada hari Selasa kedua setiap bulan pukul 22:30 (UTC)

cron(30 22 ? * tue#2 *)

Tip

Jika Anda tidak ingin pekerjaan pipeline Anda diperpanjang ke hari berikutnya saat sedang berjalan, pastikan Anda memperhitungkan waktu untuk build saat menentukan waktu mulai.

Nilai ekspresi di EC2 Image Builder

Ekspresi rate dimulai ketika Anda membuat aturan peristiwa terjadwal, dan kemudian aturan berjalan pada jadwal yang ditetapkan.

Ekspresi rate memiliki dua field wajib berikut. Field dipisahkan oleh white space.

Sintaks

rate(value unit)
nilai

Bilangan positif

unit

Unit waktu. Unit yang berbeda diperlukan untuk nilai 1, seperti minute, dan nilai lebih dari 1, seperti minutes.

Nilai yang valid: menit | menit-menit | jam | jam-jam | hari | hari-hari

Pembatasan

Jika nilai sama dengan 1, maka unit harus tunggal. Demikian pula, untuk nilai lebih besar dari 1, unit harus jamak. Misalnya, rate(1 hours) dan rate(5 hour) tidak valid, tetapi rate(1 hour) dan rate(5 hours) valid.