semantic-release

Appearance

On this page

Troubleshooting ​

Summary of known problems and their solutions.

Release fails with "A minimum of 1 and a maximum of 3 release branches are required in the branches configuration" ​

You may get an error message in the pipeline like this:

[7:29:42 AM] [semantic-release] › ℹ  Start step "fail" of plugin "@semantic-release/exec"
[7:29:42 AM] [semantic-release] › ✔  Completed step "fail" of plugin "@semantic-release/exec"
[7:29:42 AM] [semantic-release] › ✖  ERELEASEBRANCHES The release branches are invalid in the `branches` configuration.
A minimum of 1 and a maximum of 3 release branches are required in the branches configuration (https://github.com/semantic-release/semantic-release/blob/master/docs/usage/configuration.md#branches).
This may occur if your repository does not have a release branch, such as master.
Your configuration for the problematic branches is [].
AggregateError:
SemanticReleaseError: The release branches are invalid in the `branches` configuration.
at module.exports (/builds/mbernhardt/semantic-release/node_modules/semantic-release/lib/get-error.js:6:10)
at /builds/mbernhardt/semantic-release/node_modules/semantic-release/lib/branches/index.js:44:19
at Array.reduce (<anonymous>)
at module.exports (/builds/mbernhardt/semantic-release/node_modules/semantic-release/lib/branches/index.js:34:46)
at processTicksAndRejections (node:internal/process/task_queues:96:5)
at async run (/builds/mbernhardt/semantic-release/node_modules/semantic-release/index.js:65:22)
at async module.exports (/builds/mbernhardt/semantic-release/node_modules/semantic-release/index.js:268:22)
at async module.exports (/builds/mbernhardt/semantic-release/node_modules/semantic-release/cli.js:55:5)
at module.exports (/builds/mbernhardt/semantic-release/node_modules/semantic-release/lib/branches/index.js:66:11)
at processTicksAndRejections (node:internal/process/task_queues:96:5)
at async run (/builds/mbernhardt/semantic-release/node_modules/semantic-release/index.js:65:22)
at async module.exports (/builds/mbernhardt/semantic-release/node_modules/semantic-release/index.js:268:22)
at async module.exports (/builds/mbernhardt/semantic-release/node_modules/semantic-release/cli.js:55:5)
ERROR: Job failed: exit code 1

In this case, it is possible that you have at least not created the branch release. Depending on how you plan to work, you may not have created the staging branch.