Eksekusi Kondisional dan Dependensi Tugas

Tidak setiap langkah harus berjalan setiap kali. Anda mungkin ingin langkah penerapan berjalan hanya pada cabang main, atau langkah pemberitahuan berjalan hanya ketika terjadi kegagalan.

GitHub Actions memungkinkan Anda melampirkan kondisi bersyarat ke langkah atau tugas apa pun untuk mengatur apakah langkah atau tugas tersebut dijalankan.

Tambahkan kunci if: ke suatu langkah. Langkah tersebut hanya berjalan ketika ekspresinya menghasilkan nilai benar.

Ekspresi di dalam if tidak memerlukan pembungkus ${{ }}, meskipun pembungkus tersebut tetap diperbolehkan.

Kondisi dibaca dari objek konteks yang menjelaskan eksekusi:

• github — peristiwa, ref, aktor, sha
• env — variabel lingkungan
• job dan steps — status pekerjaan sebelumnya
• runner — OS dan arsitektur

Misalnya, github.event_name memberi tahu Anda apakah pengiriman perubahan atau pull_request memicu eksekusi tersebut.

Secara bawaan, suatu langkah dilewati jika langkah sebelumnya gagal. Untuk mengganti perilaku ini, gunakan fungsi status:

• success() — bernilai benar jika tidak ada langkah sebelumnya yang gagal (bawaan)
• failure() — bernilai benar jika ada langkah sebelumnya yang gagal
• always() — dijalankan apa pun kondisinya
• cancelled() — bernilai benar jika eksekusi dibatalkan

Pola yang umum adalah langkah pembersihan yang harus dijalankan meskipun langkah sebelumnya gagal. Gunakan if: always().

Dengan demikian, sumber daya sementara, kontainer, atau laporan pengujian akan ditangani apa pun hasilnya.

Kata kunci needs membuat satu tugas menunggu tugas lainnya. Tanpanya, tugas berjalan secara paralel.

Tugas yang tercantum dalam needs harus selesai dengan sukses sebelum tugas yang bergantung padanya dimulai.

Satu tugas dapat bergantung pada beberapa tugas dengan memberikan daftar ke needs. Tugas tersebut menunggu semuanya selesai.

Dengan cara ini, Anda dapat membangun pola penggabungan, yaitu tugas akhir hanya berjalan setelah semua tugas paralel berhasil.

Kunci if juga berlaku untuk tugas, bukan hanya langkah. Kondisi pada tingkat tugas menentukan apakah seluruh tugas dijalankan.

Di sini, tugas penerapan hanya berjalan untuk pengiriman perubahan ke main, tetapi tetap bergantung pada pengujian.

Tugas dapat meneruskan data ke tugas berikutnya melalui outputs. Tugas yang bergantung padanya membaca data tersebut melalui konteks needs.

Dengan demikian, kondisi dapat bergantung pada nilai yang dihitung sebelumnya, misalnya apakah suatu versi berubah.

Anda dapat menggabungkan ekspresi dengan && (dan), || (atau), serta ! (bukan).

Contoh ini hanya berjalan pada pengiriman perubahan yang berhasil ke main dan bukan berasal dari repositori bercabang.

Hati-hati: tugas dengan needs akan dilewati jika dependensinya gagal. Untuk selalu menjalankan tugas pelaporan akhir, gabungkan needs dengan if: always().

Di dalamnya, Anda dapat memeriksa needs.<job>.result untuk menentukan hal yang akan dilaporkan.

Anda telah mempelajari cara mengendalikan alur kerja dengan kondisi dan dependensi.

• if mengatur langkah dan tugas berdasarkan ekspresi
• Fungsi status seperti failure() dan always() mengganti perilaku dilewati saat gagal
• needs membuat pola pengurutan dan penggabungan
• outputs tugas memasukkan nilai ke dalam kondisi berikutnya

Primitif ini memungkinkan Anda membangun alur kerja yang tepat dan efisien.