Guides
How to use matrix builds well
The matrix has grown and nobody remembers why each combination exists.
5 min read
The matrix has grown and nobody remembers why each combination exists.
Why it happens
Matrices multiply, so three dimensions quietly become dozens of jobs.
How to fix it
- Use include to add specific meaningful combinations rather than a full product
- Use exclude to remove combinations that cannot occur in production
- Review the matrix quarterly against what you actually support
- Turn off fail-fast only while debugging
Your next build could be twice as fast, at half the price
Start free. Migrating away is the same one line, and we publish that diff too.
Related
How to scale self-hosted runnersSelf-hosted runners either queue at peak or sit idle and expensive.How to use runner groupsAny repository can schedule jobs on any runner.How to design a runner label strategyLabels grew organically and nobody knows which to use.Hosted or BYOC: how to chooseYou are unsure whether to use hosted runners or deploy into your own cloud.