TopicTrick Logo
Topictrick
DevOpsGitHub

GitHub Actions: Matrix Builds and Parallelism

TT
TopicTrick Team
•
GitHub Actions: Matrix Builds and Parallelism
← Back to GitHub Mastery

GitHub Actions: Matrix Builds and Parallelism

1. The Matrix Strategy: Multiplying Work

In your YAML:

yaml


    

  • The Math: $3$ (OS) x $3$ (Node) = $9$ Jobs.
    • 

  • GitHub will start 9 different virtual machines.
    • 

  • You get total coverage of every environment your user might have, all within the time it takes to run one single test.
    • 





2. Including and Excluding: Precision Control


Sometimes, you don't need all the combinations.


    

  • "I want to test Node 22 on all OSes, but I only want to test Node 18 on Linux."
    • 

  • You use the exclude key to tell the matrix to skip those specific boring combinations.
    • 

  • Use the include key to add a "Special" job, like a Linux server with an attached GPU.
    • 





3. Fast-Fail vs. Continue-on-Error


    

  • Fast-Fail (Default): If the Windows test fails, GitHub cancels all the other tests (Linux/Mac) to save you money.
    • 

  • The Problem: You WANT to see if it's broken on Mac too!
    • 

  • The Fix: Set fail-fast: false. This ensures that even if one OS fails, you get the full report for everyone. This is mandatory for "Research and Development" projects.
    • 





4. Scaling with Matrix: More than just OS


In 2026, we use Matrix for more than just Linux vs Windows.


    

  • Data Scaling: Run your tests against $5$ different databases (Postgres, MySQL, MariaDB, SQLite).
    • 

  • Shard Testing: If you have $1,000$ slow tests, split them into $10$ shards. Use the matrix to run 100 tests per machine. This turns a 1-hour test-suite into a 6-minute one.
    • 





Frequently Asked Questions


Is it expensive?
For Public repos? No, it's free. For Private repos? You pay for every minute. If you run 20 matrix jobs, you will eat through your free minutes 20x faster. Matrix is a "Time-for-Money" trade-off.


Can I use a matrix for deployment?
YES. You can use a matrix to "Deploy to 5 different regions" at once (US, UK, HK, JP, etc.). This ensures that your global infrastructure is updated in perfect sync.




Key Takeaway


Matrix Builds are the "Speed Factor" of your career. By mastering multi-dimensional strategy and the discipline of shard testing, you gain the ability to move with the speed of light regardless of how complex your project becomes. You graduate from "Sequential testing" to "Massive Parallel Orchestration."


Read next: GitHub Actions: Self-Hosted Runners for High Power →




Part of the GitHub Mastery Course — engineering the speed.