Matrix-builds til flere miljøer

Du definerer en matrix i sektionen strategy for et job. I strategy.matrix angiver du en eller flere variabler, hver med en række værdier.

Derefter opretter GitHub Actions et job for hver kombination. Lad os se, hvordan det ser ud:

I det foregående kodestykke definerede vi variablen node-version med tre værdier: 14, 16 og 18.

Denne ene jobdefinition udløser tre separate jobs, som hver kører på ubuntu-latest, men bruger en forskellig Node.js-version. Det sikrer, at dit projekt fungerer på tværs af disse versioner.

Du er ikke begrænset til kun én variabel! Du kan kombinere flere variabler i din matrix. Du kan f.eks. få brug for at teste forskellige operativsystemer med forskellige Node.js-versioner.

Du skal blot tilføje flere nøgleværdi-par under strategy.matrix. Det samlede antal jobs er produktet af antallet af værdier for hver variabel.

Sådan kan du opsætte en matrix, der tester på både Ubuntu og Windows med Node.js-versionerne 16 og 18.

Det opretter 2 (operativsystemer) * 2 (Node.js-versioner) = 4 separate jobs.

Nogle gange har du brug for specifikke kombinationer, som ikke dækkes af det standardmæssige kartesiske produkt, eller du vil tilføje ekstra variabler til bestemte builds. Brug include til at tilføje nye matrixposter.

Du vil måske f.eks. køre en ekstra test på Ubuntu med Node.js 14 eller videregive en bestemt miljøvariabel til en bestemt kombination af operativsystem og version.

Hvad gør du, hvis du har en kombination, som du ved vil mislykkes, eller som ikke er relevant for dit projekt? Med nøgleordet exclude kan du fjerne bestemte konfigurationer fra din matrix.

Det hjælper dig med at undgå unødvendige jobkørsler og fokusere på relevante testtilfælde.

I dine jobtrin kan du få adgang til de aktuelle værdier for matrix-variablerne ved hjælp af syntaksen ${{ matrix.variable_name }}. Det er afgørende, når du skal konfigurere værktøjer eller køre kommandoer, der er specifikke for hver matrixkombination.

For eksempel indstiller ${{ matrix.os }} dynamisk kørselsmiljøets operativsystem, mens ${{ matrix.node-version }} konfigurerer opsætningshandlingen til Node.js.

Matrix-builds er effektive til:

• Biblioteksudvikling: Test med flere versioner af en afhængighed.
• Projekter med flere sprog: Bygning og test af komponenter, der er skrevet i forskellige sprog eller bruger forskellige kompilatorer.
• Browserkompatibilitet: Test af webapps i forskellige browsere, hvis du bruger et værktøj, der understøtter det.

De forenkler komplekse testscenarier til korte, vedligeholdelsesvenlige workflows.

Godt klaret! Du har lært om matrix-builds i GitHub Actions.

• De giver dig mulighed for at køre jobs for flere kombinationer af variabler (operativsystemer, sprogversioner osv.).
• De defineres ved hjælp af strategy.matrix i et job.
• include tilføjer bestemte kombinationer, mens exclude fjerner dem.
• Du får adgang til variablerne via ${{ matrix.variable_name }}.

Matrix-builds er afgørende for effektiv og omfattende test på tværs af forskellige miljøer. Bliv ved med at øve dig, så du mestrer dem!