Skip to content

docs: add warning about 27-axis matrix limit#5700

Merged
qwerty287 merged 3 commits into
woodpecker-ci:mainfrom
1001Josias:docs/add-matrix-limits-warning
Nov 3, 2025
Merged

docs: add warning about 27-axis matrix limit#5700
qwerty287 merged 3 commits into
woodpecker-ci:mainfrom
1001Josias:docs/add-matrix-limits-warning

Conversation

@1001Josias

Copy link
Copy Markdown
Contributor

This PR adds a documentation warning about the current matrix axis limit in Woodpecker.

Although the source code defines a limit of axes per workflow, this limitation is not mentioned in the docs.

This update clarifies why some entries in large matrix configurations may not trigger executions once the limit is reached, helping users avoid spending unnecessary time debugging their pipelines.

1001Josias and others added 3 commits October 31, 2025 09:56
Added warning about maximum matrix axes limit.
Increased the maximum supported matrix axes from 25 to 27 in the documentation for matrix workflows.
…ntation

Included a warning in the matrix workflows documentation across multiple versions, stating that Woodpecker supports a maximum of 27 matrix axes per workflow, and any additional axes will be silently ignored.
@6543

6543 commented Nov 3, 2025

Copy link
Copy Markdown
Member

the limit is a drone relict ... we should increase it to a bigger number :)

-> 1000 ? (that should not limit most usecases anymore but prevent infinite loop stufff)

@6543

6543 commented Nov 3, 2025

Copy link
Copy Markdown
Member

and i dont like that it's silently droped we should have an error then

@6543 6543 added bug Something isn't working engine change how the pipeline engine works labels Nov 3, 2025
@woodpecker-bot

woodpecker-bot commented Nov 3, 2025

Copy link
Copy Markdown
Contributor

Surge PR preview deployment succeeded. View it at https://woodpecker-ci-woodpecker-pr-5700.surge.sh

@qwerty287 qwerty287 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@6543 let's merge this PR for now and fix the actual issue in a separate PR. So we have some docs at least.

@qwerty287 qwerty287 merged commit c9b1d41 into woodpecker-ci:main Nov 3, 2025
7 checks passed
@woodpecker-bot woodpecker-bot mentioned this pull request Nov 3, 2025
1 task
@qwerty287 qwerty287 added documentation docu & docs and removed bug Something isn't working engine change how the pipeline engine works labels Nov 3, 2025
@6543

6543 commented Nov 4, 2025

Copy link
Copy Markdown
Member

I created an issue so it does not get lost

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation docu & docs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants