Birden Çok Ortam için Matris Derlemeleri

GitHub Eylemleri'ndeki güçlü bir özellik olan matris derlemelerine hoş geldiniz! Kodunuzu çeşitli işletim sistemleri veya programlama dili sürümleri gibi birçok farklı ortamda sınamanız gerektiğini düşünün.

Her kombinasyon için ayrı bir iş akışı oluşturmak yerine, matris derlemeleri bir değişken kümesi tanımlamanıza olanak tanır ve GitHub Eylemleri, işlerinizin bu değişkenlerin olası her kombinasyonu için otomatik olarak çalıştırılmasını sağlar.

Matris derlemeleri şu amaçlarla son derece kullanışlıdır:

• Platformlar Arası Sınama: Uygulamanızın Windows, macOS ve Linux üzerinde çalıştığından emin olmanızı sağlar.
• Çoklu Sürüm Uyumluluğu: Farklı Node.js, Python veya veritabanı sürümleriyle sınama yapmanızı sağlar.
• Paralel Yürütme: Tüm bu sınamaları aynı anda çalıştırarak büyük ölçüde zaman kazandırır.

Daha geniş bir sınama kapsamına verimli bir şekilde ulaşmanıza yardımcı olurlar.

Bir matrisi bir işin strategy bölümünde tanımlarsınız. strategy.matrix içinde, her biri bir değer dizisi içeren bir veya daha fazla değişken listelersiniz.

GitHub Eylemleri daha sonra her kombinasyon için bir iş oluşturur. Nasıl göründüğüne bakalım:

Önceki kod parçasında, 14, 16 ve 18 olmak üzere üç değer içeren bir node-version değişkeni tanımladık.

Bu tek iş tanımı, her biri ubuntu-latest üzerinde çalışan ancak farklı bir Node.js sürümü kullanan üç ayrı işi tetikler. Böylece projenizin bu sürümlerin tümünde çalıştığından emin olabilirsiniz.

Yalnızca bir değişkenle sınırlı değilsiniz! Matrisinizde birden çok değişkeni birleştirebilirsiniz. Örneğin, farklı Node.js sürümleriyle farklı işletim sistemlerinde sınama yapmak isteyebilirsiniz.

strategy.matrix altında daha fazla anahtar-değer çifti eklemeniz yeterlidir. Toplam iş sayısı, her değişken için bulunan değer sayılarının çarpımı olur.

Ubuntu ve Windows üzerinde, 16 ve 18 Node.js sürümleriyle sınama yapmak üzere bir matris şu şekilde ayarlanabilir.

Bu işlem 2 (OS) * 2 (Node.js sürümü) = 4 ayrı iş oluşturur.

Bazen varsayılan Kartezyen çarpımın kapsamadığı belirli kombinasyonlara ihtiyaç duyarsınız veya belirli derlemelere ek değişkenler eklemek istersiniz. Yeni matris girdileri eklemek için include kullanın.

Örneğin, yalnızca Ubuntu ve Node.js 14 üzerinde ek bir sınama çalıştırmak veya belirli bir işletim sistemi ve sürüm kombinasyonuna özel bir ortam değişkeni aktarmak isteyebilirsiniz.

Başarısız olacağı bilinen veya projenizle ilgisi olmayan bir kombinasyonunuz varsa ne olur? exclude anahtar sözcüğü, belirli yapılandırmaları matrisinizden kaldırmanıza olanak tanır.

Bu sayede gereksiz iş çalıştırmalarından kaçınabilir ve ilgili sınama durumlarına odaklanabilirsiniz.

İş adımlarınız içinde, geçerli matris değişkeni değerlerine ${{ matrix.variable_name }} sözdizimini kullanarak erişebilirsiniz. Bu, her matris kombinasyonuna özgü araçları yapılandırmak veya komutları çalıştırmak için çok önemlidir.

Örneğin, ${{ matrix.os }} çalıştırıcının işletim sistemini dinamik olarak ayarlar ve ${{ matrix.node-version }} Node.js kurulum eylemini yapılandırır.

Matris derlemeleri şu amaçlarla güçlü bir çözümdür:

• Kitaplık Geliştirme: Bir bağımlılığın birden çok sürümüyle sınama yapma.
• Çok Dilli Projeler: Farklı dillerle veya derleyicilerle yazılmış bileşenleri derleme ve sınama.
• Tarayıcı Uyumluluğu: Kullanılan araç bunu destekliyorsa web uygulamalarını farklı tarayıcılarda sınama.

Karmaşık sınama senaryolarını kısa ve bakımı kolay iş akışlarına dönüştürürler.

Matris stratejisi kullanan bir GitHub Eylemleri iş akışını ele alın. Matris şu şekilde tanımlanmıştır:

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

Bu matris yapılandırması kaç iş oluşturur?

Harika iş çıkardınız! GitHub Eylemleri matris derlemelerini öğrendiniz.

• İşleri birden çok değişken kombinasyonu (OS, dil sürümleri vb.) için çalıştırmanıza olanak tanırlar.
• Bir iş içinde strategy.matrix kullanılarak tanımlanırlar.
• include belirli kombinasyonlar eklerken exclude bunları kaldırır.
• Değişkenlere ${{ matrix.variable_name }} aracılığıyla erişilir.

Matris derlemeleri, farklı ortamlarda verimli ve kapsamlı sınama yapmak için çok önemlidir. Onlarda uzmanlaşmak için pratik yapmaya devam edin!