Menambahkan pemicu ke alur kerja - Amazon CodeCatalyst

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

Menambahkan pemicu ke alur kerja

Gunakan petunjuk berikut untuk menambahkan pemicu push, pull, atau schedule ke CodeCatalyst alur kerja Amazon Anda.

Untuk informasi lebih lanjut tentang menggunakan pemicu, lihat Memulai alur kerja berjalan secara otomatis menggunakan pemicu.

Visual
Untuk menambahkan pemicu (editor visual)

  1. Buka CodeCatalyst konsol di https://codecatalyst.aws/.

  2. Pilih proyek Anda.

  3. Di panel navigasi, pilih CI/CD, lalu pilih Alur kerja.

  4. Pilih nama alur kerja Anda. Anda dapat memfilter berdasarkan repositori sumber atau nama cabang tempat alur kerja ditentukan, atau memfilter berdasarkan nama atau status alur kerja.

  5. Pilih Edit.

  6. Pilih Visual.

  7. Dalam diagram alur kerja, pilih kotak Sumber dan Pemicu.

  8. Di panel konfigurasi, Pilih Tambah pemicu.

  9. Dalam Tambahkan pemicu kotak dialog, berikan informasi di bidang, sebagai berikut.

    Jenis pemicu

    Tentukan jenis pemicu. Anda dapat menggunakan salah satu nilai berikut:

    • Dorong (editor visual) atau PUSH (YAMLeditor)

      Pemicu push memulai alur kerja saat perubahan didorong ke repositori sumber Anda. Jalankan alur kerja akan menggunakan file di cabang yang Anda dorong (yaitu, cabang tujuan).

    • Permintaan tarik (editor visual) atau PULLREQUEST (YAMLeditor)

      Pemicu permintaan tarik memulai alur kerja saat permintaan tarik dibuka, diperbarui, atau ditutup di repositori sumber Anda. Workflow run akan menggunakan file di cabang yang Anda tarik dari (yaitu, cabang sumber).

    • Jadwal (editor visual) atau SCHEDULE (YAMLeditor)

      Pemicu jadwal memulai alur kerja berjalan pada jadwal yang ditentukan oleh ekspresi cron yang Anda tentukan. Jalankan alur kerja terpisah akan dimulai untuk setiap cabang di repositori sumber Anda menggunakan file cabang. (Untuk membatasi cabang tempat pemicu diaktifkan, gunakan bidang Cabang (editor visual) atau Branches properti (YAMLeditor).)

      Saat mengonfigurasi pemicu jadwal, ikuti panduan ini:

      • Hanya gunakan satu pemicu jadwal per alur kerja.

      • Jika Anda telah menentukan beberapa alur kerja di CodeCatalyst ruang Anda, sebaiknya Anda menjadwalkan tidak lebih dari 10 alur kerja untuk memulai secara bersamaan.

      • Pastikan Anda mengonfigurasi ekspresi cron pemicu dengan waktu yang cukup di antara proses. Untuk informasi selengkapnya, lihat Expression.

    Sebagai contoh, silakan lihat Contoh: Pemicu dalam alur kerja.

    Acara untuk permintaan tarik

    Bidang ini hanya muncul jika Anda memilih jenis pemicu permintaan Tarik.

    Tentukan jenis peristiwa permintaan tarik yang akan memulai alur kerja. Berikut ini adalah nilai yang valid:

    • Permintaan tarik dibuat (editor visual) atau OPEN (YAMLeditor)

      Proses alur kerja dimulai saat permintaan tarik dibuat.

    • Permintaan tarik ditutup (editor visual) atau CLOSED (YAMLeditor)

      Proses alur kerja dimulai saat permintaan tarik ditutup. Perilaku CLOSED acara itu rumit, dan paling baik dipahami melalui sebuah contoh. Untuk informasi selengkapnya, lihat Contoh: Pemicu dengan tarikan, cabang, dan peristiwa CLOSED ''.

    • Revisi baru dibuat untuk menarik permintaan (editor visual) atau REVISION (YAMLeditor)

      Alur kerja dijalankan ketika revisi ke permintaan tarik dibuat. Revisi pertama dibuat saat permintaan tarik dibuat. Setelah itu, revisi baru dibuat setiap kali seseorang mendorong komit baru ke cabang sumber yang ditentukan dalam permintaan tarik. Jika Anda menyertakan REVISION peristiwa dalam pemicu permintaan tarik Anda, Anda dapat menghilangkan OPEN acara tersebut, karena REVISION merupakan superset dari. OPEN

    Anda dapat menentukan beberapa peristiwa dalam pemicu permintaan tarik yang sama.

    Sebagai contoh, lihat Contoh: Pemicu dalam alur kerja.

    Jadwal

    Bidang ini hanya muncul jika Anda memilih jenis pemicu Jadwal.

    Tentukan ekspresi cron yang menjelaskan kapan Anda ingin alur kerja terjadwal Anda berjalan terjadi.

    Ekspresi cron CodeCatalyst menggunakan sintaks enam bidang berikut, di mana setiap bidang dipisahkan oleh spasi:

    minutes hours days-of-month month days-of-week year

    Contoh ekspresi cron

    Menit Jam Hari dalam sebulan Bulan Hari dalam seminggu Tahun Arti

    0

    0

    ?

    *

    MON-FRI

    *

    Menjalankan alur kerja pada tengah malam (UTC+0) setiap Senin sampai Jumat.

    0

    2

    *

    *

    ?

    *

    Menjalankan alur kerja pada pukul 2:00 pagi (UTC+0) setiap hari.

    15

    22

    *

    *

    ?

    *

    Menjalankan alur kerja pada pukul 10:15 malam (UTC+0) setiap hari.

    0/30

    22-2

    ?

    *

    SAT-SUN

    *

    Menjalankan alur kerja setiap 30 menit Sabtu hingga Minggu antara pukul 10:00 malam pada hari mulai dan 2:00 pagi pada hari berikutnya (UTC+0).

    45

    13

    L

    *

    ?

    2023-2027

    Menjalankan alur kerja pada pukul 1:45 siang (UTC+0) pada hari terakhir bulan antara tahun 2023 dan 2027 inklusif.

    Saat menentukan ekspresi cron di CodeCatalyst, pastikan Anda mengikuti panduan ini:

    • Tentukan ekspresi cron tunggal per SCHEDULE pemicu.

    • Lampirkan ekspresi cron dalam tanda kutip ganda (") di editor. YAML

    • Tentukan waktu di Coordinated Universal Time (UTC). Zona waktu lain tidak didukung.

    • Konfigurasikan setidaknya 30 menit di antara proses. Irama yang lebih cepat tidak didukung.

    • Tentukan days-of-month atau days-of-week lapangan, tapi tidak keduanya. Jika Anda menentukan nilai atau tanda bintang (*) di salah satu bidang, Anda harus menggunakan tanda tanya (?) di bidang lainnya. Tanda bintang berarti 'semua' dan tanda tanya berarti 'apa saja'.

    Untuk lebih banyak contoh ekspresi cron dan informasi tentang wildcard seperti?,*, danL, lihat referensi ekspresi Cron di Panduan Pengguna Amazon EventBridge . Ekspresi cron masuk EventBridge dan CodeCatalyst bekerja dengan cara yang persis sama.

    Untuk contoh pemicu jadwal, lihatContoh: Pemicu dalam alur kerja.

    Cabang dan pola Cabang

    (Opsional)

    Tentukan cabang di repositori sumber Anda yang dipantau pemicu untuk mengetahui kapan harus memulai alur kerja. Anda dapat menggunakan pola regex untuk menentukan nama cabang Anda. Misalnya, gunakan main.* untuk mencocokkan semua cabang yang dimulai denganmain.

    Cabang yang akan ditentukan berbeda tergantung pada jenis pemicu:

    • Untuk pemicu dorong, tentukan cabang yang Anda dorong, yaitu cabang tujuan. Satu alur kerja akan dimulai per cabang yang cocok, menggunakan file di cabang yang cocok.

      Contoh:main.*, mainline

    • Untuk pemicu permintaan tarik, tentukan cabang yang Anda dorong, yaitu cabang tujuan. Satu alur kerja akan dimulai per cabang yang cocok, menggunakan file definisi alur kerja dan file sumber di cabang sumber (bukan cabang yang cocok).

      Contoh:main.*,mainline, v1\-.* (cocok dengan cabang yang dimulai denganv1-)

    • Untuk pemicu jadwal, tentukan cabang yang berisi file yang ingin Anda jalankan terjadwal untuk digunakan. Satu alur kerja akan dimulai per cabang yang cocok, menggunakan file definisi alur kerja dan file sumber di cabang yang cocok.

      Contoh:main.*, version\-1\.0

    catatan

    Jika Anda tidak menentukan cabang, pemicu memantau semua cabang di repositori sumber Anda, dan akan memulai alur kerja menggunakan file definisi alur kerja dan file sumber di:

    Untuk informasi lebih lanjut tentang cabang dan pemicu, lihatPedoman penggunaan untuk pemicu dan cabang.

    Untuk contoh lainnya, lihat Contoh: Pemicu dalam alur kerja.

    File diubah

    Bidang ini hanya muncul jika Anda memilih jenis pemicu permintaan Push atau Pull.

    Tentukan file atau folder di repositori sumber Anda yang dipantau pemicu untuk mengetahui kapan harus memulai alur kerja. Anda dapat menggunakan ekspresi reguler untuk mencocokkan nama file atau jalur.

    Sebagai contoh, lihat Contoh: Pemicu dalam alur kerja.

  10. (Opsional) Pilih Validasi untuk memvalidasi YAML kode alur kerja sebelum melakukan.

  11. Pilih Komit, masukkan pesan komit, dan pilih Komit lagi.

YAML
Untuk menambahkan pemicu (YAMLeditor)

  1. Buka CodeCatalyst konsol di https://codecatalyst.aws/.

  2. Pilih proyek Anda.

  3. Di panel navigasi, pilih CI/CD, lalu pilih Alur kerja.

  4. Pilih nama alur kerja Anda. Anda dapat memfilter berdasarkan repositori sumber atau nama cabang tempat alur kerja ditentukan, atau memfilter berdasarkan nama atau status alur kerja.

  5. Pilih Edit.

  6. Pilih YAML.

  7. Tambahkan Triggers bagian dan properti yang mendasari menggunakan contoh berikut sebagai panduan. Untuk informasi lebih lanjut, lihat Triggers diDefinisi alur kerja YAML.

    Pemicu push kode mungkin terlihat seperti ini:

    Triggers:
  - Type: PUSH
    Branches:
      - main

    Pemicu permintaan tarik mungkin terlihat seperti ini:

    Triggers:
  - Type: PULLREQUEST
    Branches:
      - main.*
    Events: 
      - OPEN
      - REVISION
      - CLOSED

    Pemicu jadwal mungkin terlihat seperti ini:

    Triggers:
  - Type: SCHEDULE
    Branches:
      - main.*
    # Run the workflow at 1:15 am (UTC+0) every Friday until the end of 2023
    Expression: "15 1 ? * FRI 2022-2023"

    Untuk lebih banyak contoh ekspresi cron yang dapat Anda gunakan di Expression properti, lihatExpression.

    Untuk lebih banyak contoh push, pull request, dan schedule trigger, lihatContoh: Pemicu dalam alur kerja.

  8. (Opsional) Pilih Validasi untuk memvalidasi YAML kode alur kerja sebelum melakukan.

  9. Pilih Komit, masukkan pesan komit, dan pilih Komit lagi.