Build Matriks untuk Berbagai Lingkungan

Selamat datang di fitur canggih GitHub Actions: Pembuatan dengan Matriks! Bayangkan Anda perlu menguji kode di berbagai lingkungan, seperti beragam sistem operasi atau versi bahasa pemrograman.

Alih-alih membuat alur kerja terpisah untuk setiap kombinasi, pembuatan dengan matriks memungkinkan Anda menentukan sekumpulan variabel, lalu GitHub Actions akan secara otomatis menjalankan pekerjaan Anda untuk setiap kemungkinan kombinasi variabel tersebut.

Pembuatan dengan matriks sangat berguna untuk:

• Pengujian Lintas Platform: Memastikan aplikasi Anda berfungsi di Windows, macOS, dan Linux.
• Kompatibilitas Multi Versi: Menguji dengan berbagai versi Node.js, Python, atau basis data Anda.
• Eksekusi Paralel: Menjalankan semua pengujian ini secara bersamaan sehingga menghemat banyak waktu.

Fitur ini membantu Anda memperoleh cakupan pengujian yang lebih luas secara efisien.

Anda menentukan matriks di bagian strategy suatu pekerjaan. Di dalam strategy.matrix, Anda mencantumkan satu atau beberapa variabel, masing-masing dengan larik nilai.

GitHub Actions kemudian membuat satu pekerjaan untuk setiap kombinasi. Mari lihat tampilannya:

Pada potongan kode sebelumnya, kita menentukan variabel node-version dengan tiga nilai: 14, 16, dan 18.

Definisi pekerjaan tunggal ini akan memicu tiga pekerjaan terpisah, masing-masing berjalan di ubuntu-latest tetapi menggunakan versi Node.js yang berbeda. Dengan demikian, proyek Anda dipastikan berfungsi pada semua versi tersebut.

Anda tidak terbatas pada satu variabel saja! Anda dapat menggabungkan beberapa variabel dalam matriks. Misalnya, Anda mungkin ingin menguji berbagai sistem operasi dengan berbagai versi Node.js.

Tambahkan lebih banyak pasangan kunci-nilai di bawah strategy.matrix. Jumlah total pekerjaan adalah hasil kali jumlah nilai untuk setiap variabel.

Berikut cara menyiapkan matriks untuk menguji di Ubuntu dan Windows, menggunakan Node.js versi 16 dan 18.

Konfigurasi ini akan membuat 2 (OS) * 2 (versi Node.js) = 4 pekerjaan terpisah.

Terkadang Anda memerlukan kombinasi tertentu yang tidak tercakup oleh hasil kali Kartesius bawaan, atau ingin menambahkan variabel tambahan untuk pembuatan tertentu. Gunakan include untuk menambahkan entri matriks baru.

Misalnya, Anda mungkin ingin menjalankan pengujian tambahan hanya di Ubuntu dengan Node.js 14, atau meneruskan variabel lingkungan tertentu ke kombinasi OS/versi tertentu.

Bagaimana jika Anda memiliki kombinasi yang diketahui akan gagal atau tidak relevan bagi proyek Anda? Kata kunci exclude memungkinkan Anda menghapus konfigurasi tertentu dari matriks.

Hal ini membantu Anda menghindari eksekusi pekerjaan yang tidak perlu dan berfokus pada kasus pengujian yang relevan.

Dalam langkah pekerjaan Anda, Anda dapat mengakses nilai variabel matriks saat ini menggunakan sintaks ${{ matrix.variable_name }}. Hal ini penting untuk mengonfigurasi alat atau menjalankan perintah yang khusus untuk setiap kombinasi matriks.

Misalnya, ${{ matrix.os }} secara dinamis menetapkan sistem operasi pelaksana, sedangkan ${{ matrix.node-version }} mengonfigurasi aksi penyiapan Node.js.

Pembuatan dengan matriks sangat berguna untuk:

• Pengembangan Pustaka: Menguji dengan beberapa versi dependensi.
• Proyek Multi Bahasa: Membuat dan menguji komponen yang ditulis dalam berbagai bahasa atau menggunakan berbagai kompilator.
• Kompatibilitas Peramban: Jika menggunakan alat yang mendukungnya, menguji aplikasi web di berbagai peramban.

Fitur ini menyederhanakan skenario pengujian yang kompleks menjadi alur kerja yang ringkas dan mudah dipelihara.

Pertimbangkan alur kerja GitHub Actions yang menggunakan strategi matriks. Matriks tersebut ditentukan sebagai berikut:

strategy:
  matrix:
    os: [ubuntu-latest, macos-latest]
    python-version: [3.8, 3.9]
    exclude:
      - os: macos-latest
        python-version: 3.8

Berapa banyak pekerjaan yang akan dibuat oleh konfigurasi matriks ini?

Kerja bagus! Anda telah mempelajari Pembuatan dengan Matriks GitHub Actions.

• Fitur ini memungkinkan Anda menjalankan pekerjaan untuk berbagai kombinasi variabel (OS, versi bahasa, dan sebagainya).
• Ditentukan menggunakan strategy.matrix dalam suatu pekerjaan.
• include menambahkan kombinasi tertentu, sedangkan exclude menghapusnya.
• Variabel diakses melalui ${{ matrix.variable_name }}.

Pembuatan dengan matriks sangat penting untuk pengujian yang efisien dan menyeluruh di berbagai lingkungan. Teruslah berlatih untuk menguasainya!