39 lines
1.8 KiB
Markdown
39 lines
1.8 KiB
Markdown
# Node version requirement
|
|
|
|
**semantic-release** is written using the latest [ECMAScript 2017](https://www.ecma-international.org/publications/standards/Ecma-262.htm) features, without transpilation which **requires Node version 14.17 or higher**.
|
|
|
|
**semantic-release** is meant to be used in a CI environment as a development support tool, not as a production dependency.
|
|
Therefore, the only constraint is to run the `semantic-release` in a CI environment providing version of Node that meets our version requirement.
|
|
|
|
See our [Node Support Policy](node-support-policy.md) for our long-term promise regarding Node version support.
|
|
|
|
## Recommended solution
|
|
|
|
### Run at least one CI job with a version of Node that meets our version requirement
|
|
|
|
The recommended approach is to run the `semantic-release` command from a CI job running on the latest available LTS version of node.
|
|
This can either be a job used by your project to test on the latest Node LTS version or a dedicated job for the release steps.
|
|
|
|
See [CI configuration](../usage/ci-configuration.md) and [CI configuration recipes](../recipes/release-workflow/README.md#ci-configurations) for more details.
|
|
|
|
## Alternative solutions
|
|
|
|
### Use `npx` to execute in the latest LTS version of Node
|
|
|
|
`npx` is included with npm >= 5.2 and can be used to download the latest [Node LTS package published on npm](https://www.npmjs.com/package/node).
|
|
Use it to execute the `semantic-release` command.
|
|
|
|
```bash
|
|
$ npx -p node@lts -c "npx semantic-release"
|
|
```
|
|
|
|
**Note**: See [What is npx](./FAQ.md#what-is-npx) for more details.
|
|
|
|
### Use `nvm`
|
|
|
|
If your CI environment provides [nvm](https://github.com/creationix/nvm) you can use it to switch to the latest LTS version of Node before running the `semantic-release` command.
|
|
|
|
```bash
|
|
$ nvm install 'lts/*' && npx semantic-release
|
|
```
|