2019-08-04 02:49:54 +01:00
# setup-node
2019-08-12 20:10:38 +01:00
< p align = "left" >
2020-05-19 14:57:20 +01:00
< a href = "https://github.com/actions/setup-node/actions?query=workflow%3Abuild-test" > < img alt = "build-test status" src = "https://github.com/actions/setup-node/workflows/build-test/badge.svg" > < / a > < a href = "https://github.com/actions/setup-node/actions?query=workflow%3Aversions" > < img alt = "versions status" src = "https://github.com/actions/setup-node/workflows/versions/badge.svg" > < / a > < a href = "https://github.com/actions/setup-node/actions?query=workflow%3Aproxy" > < img alt = "proxy status" src = "https://github.com/actions/setup-node/workflows/proxy/badge.svg" > < / a >
2019-08-12 20:10:38 +01:00
< / p >
2019-08-04 02:49:54 +01:00
This action sets by node environment for use in actions by:
- optionally downloading and caching a version of node - npm by version spec and add to PATH
2020-05-06 14:58:52 +01:00
- registering problem matchers for error output
- configuring authentication for GPR or npm
2019-08-04 02:49:54 +01:00
2020-12-15 10:36:18 +00:00
# v2
2020-05-19 14:57:20 +01:00
2020-12-15 10:36:18 +00:00
This release adds reliability for pulling node distributions from a cache of node releases.
2020-05-19 14:57:20 +01:00
```yaml
steps:
- uses: actions/checkout@v2
2020-12-15 10:36:18 +00:00
- uses: actions/setup-node@v2
2020-05-19 14:57:20 +01:00
with:
node-version: '12'
```
2020-07-20 17:50:59 +01:00
It will first check the local cache for a semver match. The hosted images have been updated with the latest of each LTS from v8, v10, v12, and v14. `self-hosted` machines will benefit from the cache as well only downloading once. It will pull LTS versions from `main` branch of [node-versions ](https://github.com/actions/node-versions/blob/main/versions-manifest.json ) repository and on miss or failure, it will fall back to the previous behavior of download directly from [node dist ](https://nodejs.org/dist/ ).
2020-05-19 14:57:20 +01:00
The `node-version` input is optional. If not supplied, node which is in your PATH will be used. However, this action will still register problem matchers and support auth features. So setting up the node environment is still a valid scenario without downloading and caching versions.
2019-08-04 02:49:54 +01:00
# Usage
See [action.yml ](action.yml )
Basic:
```yaml
steps:
2020-02-06 19:52:33 +00:00
- uses: actions/checkout@v2
2020-12-15 10:36:18 +00:00
- uses: actions/setup-node@v2
2019-08-04 02:49:54 +01:00
with:
2020-05-06 14:58:52 +01:00
node-version: '12'
2019-08-04 02:49:54 +01:00
- run: npm install
- run: npm test
```
2020-06-29 19:56:37 +01:00
Check latest version:
> In basic example, without `check-latest` flag, the action tries to resolve version from local cache firstly and download only if it is not found. Local cache on image is updated with a couple of weeks latency.
`check-latest` flag forces the action to check if the cached version is the latest one. It reduces latency significantly but it is much more likely to incur version downloading.
```yaml
steps:
- uses: actions/checkout@v2
2020-12-15 10:36:18 +00:00
- uses: actions/setup-node@v2
2020-06-29 19:56:37 +01:00
with:
node-version: '12'
check-latest: true
- run: npm install
- run: npm test
```
2019-08-04 02:49:54 +01:00
Matrix Testing:
```yaml
jobs:
build:
runs-on: ubuntu-16.04
strategy:
matrix:
2020-01-31 07:12:22 +00:00
node: [ '10', '12' ]
2019-08-04 02:49:54 +01:00
name: Node ${{ matrix.node }} sample
steps:
2020-02-06 19:52:33 +00:00
- uses: actions/checkout@v2
2019-08-04 02:49:54 +01:00
- name: Setup node
2020-12-15 10:36:18 +00:00
uses: actions/setup-node@v2
2019-08-04 02:49:54 +01:00
with:
2019-08-13 21:32:09 +01:00
node-version: ${{ matrix.node }}
2019-08-04 02:49:54 +01:00
- run: npm install
- run: npm test
```
2020-12-08 22:47:34 +00:00
Architecture:
You can use any of the [supported operating systems ](https://docs.github.com/en/actions/reference/virtual-environments-for-github-hosted-runners ), and the compatible `architecture` can be selected using `architecture` . Values are `x86` , `x64` , `arm64` , `armv6l` , `armv7l` , `ppc64le` , `s390x` (not all of the architectures are available on all platforms).
When using `architecture` , `node-version` must be provided as well.
```yaml
jobs:
build:
runs-on: windows-latest
name: Node sample
steps:
- uses: actions/checkout@v2
2020-12-15 10:36:18 +00:00
- uses: actions/setup-node@v2
2020-12-08 22:47:34 +00:00
with:
node-version: '12'
architecture: 'x64' # optional, x64 or x86. If not specified, x64 will be used by default
- run: npm install
- run: npm test
```
Multiple Operating Systems and Architectures:
2020-09-06 17:32:03 +01:00
2020-09-03 13:14:10 +01:00
```yaml
jobs:
build:
2020-09-06 17:32:03 +01:00
runs-on: ${{ matrix.os }}
2020-09-03 13:14:10 +01:00
strategy:
matrix:
2020-09-06 17:32:03 +01:00
os:
- ubuntu-latest
- macos-latest
- windows-latest
node_version:
- 10
- 12
- 14
2020-12-08 22:15:38 +00:00
architecture:
2020-09-06 17:32:03 +01:00
- x64
# an extra windows-x86 run:
include:
- os: windows-2016
node_version: 12
2020-12-08 22:15:38 +00:00
architecture: x86
name: Node ${{ matrix.node_version }} - ${{ matrix.architecture }} on ${{ matrix.os }}
2020-09-03 13:14:10 +01:00
steps:
- uses: actions/checkout@v2
- name: Setup node
2020-12-15 10:36:18 +00:00
uses: actions/setup-node@v2
2020-09-03 13:14:10 +01:00
with:
2020-09-06 17:32:03 +01:00
node-version: ${{ matrix.node_version }}
2020-12-08 22:15:38 +00:00
architecture: ${{ matrix.architecture }}
2020-09-03 13:14:10 +01:00
- run: npm install
- run: npm test
```
2019-08-06 23:26:04 +01:00
Publish to npmjs and GPR with npm:
```yaml
steps:
2020-02-06 19:52:33 +00:00
- uses: actions/checkout@v2
2020-12-15 10:36:18 +00:00
- uses: actions/setup-node@v2
2019-08-06 23:26:04 +01:00
with:
2019-08-13 21:32:09 +01:00
node-version: '10.x'
2019-08-06 23:26:04 +01:00
registry-url: 'https://registry.npmjs.org'
- run: npm install
- run: npm publish
env:
NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
2020-12-15 10:36:18 +00:00
- uses: actions/setup-node@v2
2019-08-06 23:26:04 +01:00
with:
registry-url: 'https://npm.pkg.github.com'
- run: npm publish
env:
NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
```
Publish to npmjs and GPR with yarn:
```yaml
steps:
2020-02-06 19:52:33 +00:00
- uses: actions/checkout@v2
2020-12-15 10:36:18 +00:00
- uses: actions/setup-node@v2
2019-08-06 23:26:04 +01:00
with:
2019-08-13 21:32:09 +01:00
node-version: '10.x'
2019-08-06 23:26:04 +01:00
registry-url: < registry url >
- run: yarn install
- run: yarn publish
env:
NODE_AUTH_TOKEN: ${{ secrets.YARN_TOKEN }}
2020-12-15 10:36:18 +00:00
- uses: actions/setup-node@v2
2019-08-06 23:26:04 +01:00
with:
registry-url: 'https://npm.pkg.github.com'
- run: yarn publish
env:
NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
```
2019-09-10 18:32:30 +01:00
Use private packages:
```yaml
steps:
2020-02-06 19:52:33 +00:00
- uses: actions/checkout@v2
2020-12-15 10:36:18 +00:00
- uses: actions/setup-node@v2
2019-09-10 18:32:30 +01:00
with:
node-version: '10.x'
registry-url: 'https://registry.npmjs.org'
# Skip post-install scripts here, as a malicious
# script could steal NODE_AUTH_TOKEN.
- run: npm install --ignore-scripts
env:
2019-09-10 20:39:39 +01:00
NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
2019-09-27 13:31:22 +01:00
# `npm rebuild` will run all those post-install scripts for us.
2019-09-10 18:32:30 +01:00
- run: npm rebuild && npm run prepare --if-present
```
2019-08-04 02:49:54 +01:00
# License
The scripts and documentation in this project are released under the [MIT License ](LICENSE )
# Contributions
Contributions are welcome! See [Contributor's Guide ](docs/contributors.md )
2020-04-16 23:43:02 +01:00
## Code of Conduct
:wave: Be nice. See [our code of conduct ](CONDUCT )