Build a matrice per più ambienti

Benvenuto a una potente funzionalità di GitHub Actions: le build con matrice! Immagini di dover testare il codice in molti ambienti diversi, ad esempio con vari sistemi operativi o versioni dei linguaggi di programmazione.

Anziché creare un workflow separato per ogni combinazione, le build con matrice consentono di definire un insieme di variabili, quindi GitHub Actions eseguirà automaticamente i job per ogni possibile combinazione di tali variabili.

Le build con matrice sono estremamente utili per:

• Test multipiattaforma: garantire che l'applicazione funzioni su Windows, macOS e Linux.
• Compatibilità con più versioni: eseguire test con diverse versioni di Node.js, Python o del database.
• Esecuzione parallela: eseguire contemporaneamente tutti questi test, risparmiando molto tempo.

Consentono di ottenere una copertura dei test più ampia in modo efficiente.

Si definisce una matrice nella sezione strategy di un job. All'interno di strategy.matrix, si elencano una o più variabili, ciascuna con un array di valori.

GitHub Actions crea quindi un job per ogni combinazione. Vediamo come appare:

Nel frammento precedente abbiamo definito una variabile node-version con tre valori: 14, 16 e 18.

Questa singola definizione di job attiverà tre job separati, ciascuno eseguito su ubuntu-latest ma con una versione diversa di Node.js. In questo modo si garantisce che il progetto funzioni con tutte queste versioni.

Non si è limitati a una sola variabile! È possibile combinare più variabili nella matrice. Ad esempio, potrebbe essere necessario testare diversi sistemi operativi con versioni diverse di Node.js.

È sufficiente aggiungere altre coppie chiave-valore in strategy.matrix. Il numero totale di job sarà il prodotto del numero di valori di ciascuna variabile.

Ecco come configurare una matrice per eseguire test sia su Ubuntu sia su Windows, con le versioni 16 e 18 di Node.js.

Verranno creati 2 (sistemi operativi) * 2 (versioni di Node.js) = 4 job separati.

A volte sono necessarie combinazioni specifiche che non rientrano nel prodotto cartesiano predefinito, oppure si desidera aggiungere variabili extra per alcune build. Utilizzare include per aggiungere nuove voci alla matrice.

Ad esempio, potrebbe essere necessario eseguire un test aggiuntivo solo su Ubuntu con Node.js 14 oppure passare una variabile d'ambiente specifica a una determinata combinazione di sistema operativo e versione.

Che cosa succede se una combinazione è notoriamente soggetta a errori o non è rilevante per il progetto? La parola chiave exclude consente di rimuovere configurazioni specifiche dalla matrice.

In questo modo si evitano esecuzioni di job non necessarie e ci si concentra sui casi di test rilevanti.

All'interno degli step del job, è possibile accedere ai valori correnti delle variabili della matrice usando la sintassi ${{ matrix.variable_name }}. Questo è fondamentale per configurare gli strumenti o eseguire comandi specifici per ogni combinazione della matrice.

Ad esempio, ${{ matrix.os }} imposta dinamicamente il sistema operativo del runner, mentre ${{ matrix.node-version }} configura l'action di setup di Node.js.

Le build con matrice sono potenti per:

• Sviluppo di librerie: eseguire test con più versioni di una dipendenza.
• Progetti multilinguaggio: compilare ed eseguire test su componenti scritti con linguaggi o compilatori diversi.
• Compatibilità con i browser: se lo strumento utilizzato lo supporta, testare le applicazioni web su browser diversi.

Rendono più semplici gli scenari di test complessi, trasformandoli in workflow concisi e facili da mantenere.

Si consideri un workflow di GitHub Actions che utilizza una strategia a matrice. La matrice è definita come:

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

Quanti job verranno creati da questa configurazione della matrice?

Ottimo lavoro! Ha imparato a conoscere le build con matrice di GitHub Actions.

• Consentono di eseguire job per più combinazioni di variabili, come sistemi operativi e versioni dei linguaggi.
• Si definiscono usando strategy.matrix all'interno di un job.
• include aggiunge combinazioni specifiche, mentre exclude le rimuove.
• È possibile accedere alle variabili tramite ${{ matrix.variable_name }}.

Le build con matrice sono essenziali per eseguire test efficienti e completi in ambienti diversi. Continui a esercitarsi per padroneggiarle!