Matrix-Builds für mehrere Umgebungen

Willkommen bei einem leistungsstarken Feature von GitHub Actions: den Matrix-Builds! Stellen Sie sich vor, Sie müssten Ihren Code in vielen verschiedenen Umgebungen testen, etwa unter verschiedenen Betriebssystemen oder mit unterschiedlichen Versionen einer Programmiersprache.

Statt für jede Kombination einen separaten Workflow zu erstellen, können Sie mit Matrix-Builds eine Reihe von Variablen definieren. GitHub Actions führt Ihre Jobs dann automatisch für jede mögliche Kombination dieser Variablen aus.

Matrix-Builds sind besonders nützlich für:

• Plattformübergreifende Tests: Sie stellen sicher, dass Ihre Anwendung unter Windows, macOS und Linux funktioniert.
• Kompatibilität mit mehreren Versionen: Sie testen Ihre Anwendung mit verschiedenen Versionen von Node.js, Python oder Ihrer Datenbank.
• Parallele Ausführung: Sie führen all diese Tests gleichzeitig aus und sparen dadurch viel Zeit.

So erreichen Sie effizient eine umfassendere Testabdeckung.

Sie definieren eine Matrix im Abschnitt strategy eines Jobs. Unter strategy.matrix listen Sie eine oder mehrere Variablen auf, jeweils mit einem Array von Werten.

GitHub Actions erstellt anschließend für jede Kombination einen Job. Sehen wir uns an, wie das aussieht:

Im vorherigen Ausschnitt haben wir eine Variable node-version mit drei Werten definiert: 14, 16 und 18.

Diese einzelne Job-Definition löst drei separate Jobs aus. Jeder davon läuft auf ubuntu-latest, verwendet aber eine andere Node.js-Version. So stellen Sie sicher, dass Ihr Projekt mit diesen Versionen funktioniert.

Sie sind nicht auf eine einzige Variable beschränkt! Sie können mehrere Variablen in Ihrer Matrix kombinieren. Beispielsweise können Sie verschiedene Betriebssysteme mit unterschiedlichen Node.js-Versionen testen.

Fügen Sie unter strategy.matrix einfach weitere Schlüssel-Wert-Paare hinzu. Die Gesamtzahl der Jobs ergibt sich aus dem Produkt der Anzahl der Werte jeder Variable.

So richten Sie eine Matrix ein, um sowohl unter Ubuntu als auch unter Windows mit den Node.js-Versionen 16 und 18 zu testen.

Dadurch werden 2 (Betriebssysteme) * 2 (Node.js-Versionen) = 4 separate Jobs erstellt.

Manchmal benötigen Sie bestimmte Kombinationen, die nicht durch das standardmäßige kartesische Produkt abgedeckt werden, oder Sie möchten für bestimmte Builds zusätzliche Variablen hinzufügen. Verwenden Sie include, um neue Matrix-Einträge hinzuzufügen.

Vielleicht möchten Sie beispielsweise einen zusätzlichen Test nur unter Ubuntu mit Node.js 14 ausführen oder eine bestimmte Umgebungsvariable an eine bestimmte Kombination aus Betriebssystem und Version übergeben.

Was ist, wenn eine Kombination bekanntermaßen fehlschlägt oder für Ihr Projekt nicht relevant ist? Mit dem Schlüsselwort exclude können Sie bestimmte Konfigurationen aus Ihrer Matrix entfernen.

So vermeiden Sie unnötige Job-Ausführungen und konzentrieren sich auf relevante Testfälle.

Innerhalb Ihrer Job-Schritte können Sie über die Syntax ${{ matrix.variable_name }} auf die aktuellen Werte der Matrix-Variablen zugreifen. Das ist entscheidend, um Tools zu konfigurieren oder Befehle auszuführen, die für die jeweilige Matrix-Kombination spezifisch sind.

Beispielsweise legt ${{ matrix.os }} das Betriebssystem des Runners dynamisch fest, während ${{ matrix.node-version }} die Node.js-Setup-Action konfiguriert.

Matrix-Builds sind besonders leistungsstark für:

• Bibliotheksentwicklung: Sie testen mit mehreren Versionen einer Abhängigkeit.
• Projekte mit mehreren Programmiersprachen: Sie erstellen und testen Komponenten, die in verschiedenen Sprachen oder mit verschiedenen Compilern geschrieben wurden.
• Browser-Kompatibilität: Wenn das verwendete Tool dies unterstützt, testen Sie Webanwendungen in verschiedenen Browsern.

So verwandeln Sie komplexe Testszenarien in kompakte, wartbare Workflows.

Sehr gut! Sie haben die Matrix-Builds von GitHub Actions kennengelernt.

• Sie ermöglichen es Ihnen, Jobs für mehrere Kombinationen von Variablen auszuführen, etwa Betriebssysteme und Sprachversionen.
• Sie werden innerhalb eines Jobs mit strategy.matrix definiert.
• include fügt bestimmte Kombinationen hinzu, während exclude sie entfernt.
• Auf Variablen wird über ${{ matrix.variable_name }} zugegriffen.

Matrix-Builds sind unverzichtbar für effiziente und umfassende Tests in unterschiedlichen Umgebungen. Üben Sie weiter, um sie sicher zu beherrschen!