

Amazon CodeCatalyst tidak lagi terbuka untuk pelanggan baru. Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Lihat informasi yang lebih lengkap di [Cara bermigrasi dari CodeCatalyst](migration.md).

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
<a name="workflows-add-trigger-add"></a>

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](workflows-add-trigger.md).

------
#### [ Visual ]<a name="workflows-add-trigger-add-console"></a>

**Untuk menambahkan pemicu (editor visual)**

1. Buka CodeCatalyst konsol di [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Pilih proyek Anda.

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

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

1. Pilih **Edit**.

1. Pilih **Visual**.

1. Dalam diagram alur kerja, pilih kotak **Sumber** dan **Pemicu.**

1. Di panel konfigurasi, Pilih **Tambah pemicu**.

1. 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` (editor YAMAL)

     Pemicu push memulai alur kerja saat perubahan didorong ke repositori sumber Anda. *Workflow run akan menggunakan file di cabang yang Anda dorong (yaitu, cabang tujuan).*
   + **Permintaan tarik** (editor visual) atau `PULLREQUEST` (editor YAMG)

     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` (editor YAMG)

     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 (editor YAMG).)

     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](workflow-reference.md#workflow.triggers.expression).

   Sebagai contoh, silakan lihat [Contoh: Pemicu dalam alur kerja](workflows-add-trigger-examples.md).

    **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` (editor YAMG)

     Proses alur kerja dimulai saat permintaan tarik dibuat.
   + **Permintaan tarik ditutup** (editor visual) atau `CLOSED` (editor YAMG)

     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 acara 'CLOSED'](workflows-add-trigger-examples.md#workflows-add-trigger-examples-push-pull-close).
   + **Revisi baru dibuat untuk menarik permintaan** (editor visual) atau `REVISION` (editor YAMG)

     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](workflows-add-trigger-examples.md).

    **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**    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/codecatalyst/latest/userguide/workflows-add-trigger-add.html)

   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 YAMG.
   + 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-week* bidang *days-of-month* atau, tetapi 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`?`,`*`, dan`L`, lihat [referensi ekspresi Cron di Panduan](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-cron-expressions.html) Pengguna *Amazon EventBridge *. Ekspresi cron masuk EventBridge dan CodeCatalyst bekerja dengan cara yang persis sama.

   Untuk contoh pemicu jadwal, lihat[Contoh: Pemicu dalam alur kerja](workflows-add-trigger-examples.md).

    **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 dengan`main`.

   Cabang yang akan ditentukan berbeda tergantung pada jenis pemicu:
   + *Untuk pemicu push, 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 dengan`v1-`)
   + 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:  
Cabang yang Anda dorong (*untuk* pemicu push). Untuk informasi selengkapnya, lihat [Contoh: Pemicu push kode sederhana](workflows-add-trigger-examples.md#workflows-add-trigger-examples-push-simple).
*Cabang yang Anda tarik (untuk pemicu permintaan tarik).* Untuk informasi selengkapnya, lihat [Contoh: Pemicu permintaan tarik sederhana](workflows-add-trigger-examples.md#workflows-add-trigger-examples-pull-simple).
Semua cabang (untuk pemicu jadwal). Satu alur kerja akan dimulai per cabang di repositori sumber Anda. Untuk informasi selengkapnya, lihat [Contoh: Pemicu jadwal sederhana](workflows-add-trigger-examples.md#workflows-add-trigger-examples-schedule-simple).

   Untuk informasi lebih lanjut tentang cabang dan pemicu, lihat[Pedoman penggunaan untuk pemicu dan cabang](workflows-add-trigger-considerations.md).

   Untuk contoh lainnya, lihat [Contoh: Pemicu dalam alur kerja](workflows-add-trigger-examples.md).

    **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](workflows-add-trigger-examples.md).

1. (Opsional) Pilih **Validasi** untuk memvalidasi kode YAMAL alur kerja sebelum melakukan.

1. Pilih **Komit**, masukkan pesan komit, dan pilih **Komit** lagi.

------
#### [ YAML ]

**Untuk menambahkan pemicu (editor YAMAL)**

1. Buka CodeCatalyst konsol di [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Pilih proyek Anda.

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

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

1. Pilih **Edit**.

1. Pilih **YAMAL.**

1. Tambahkan `Triggers` bagian dan properti yang mendasari menggunakan contoh berikut sebagai panduan. Untuk informasi lebih lanjut, lihat [Triggers](workflow-reference.md#triggers-reference) di[Alur kerja definisi YAMAL](workflow-reference.md).

   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, lihat[Expression](workflow-reference.md#workflow.triggers.expression).

   Untuk lebih banyak contoh push, pull request, dan schedule trigger, lihat[Contoh: Pemicu dalam alur kerja](workflows-add-trigger-examples.md).

1. (Opsional) Pilih **Validasi** untuk memvalidasi kode YAMAL alur kerja sebelum melakukan.

1. Pilih **Komit**, masukkan pesan komit, dan pilih **Komit** lagi.

------