Go to file
panticmilos fd1b409bc3 unit tests 2022-05-19 17:33:13 +02:00
.github Expand current syntax to support aliases for latest version (current/latest/node) (#483) 2022-05-12 17:26:02 +02:00
.licenses/npm Updated @actions/cache (#460) 2022-04-11 19:06:18 +05:30
.vscode download from node-versions and fallback to node dist (#147) 2020-05-19 09:25:54 -04:00
__tests__ unit tests 2022-05-19 17:33:13 +02:00
dist unit tests 2022-05-19 17:33:13 +02:00
docs Use CI friendly commands in documentation (#326) 2022-05-05 16:16:51 +02:00
externals Initial Import 2019-08-03 21:49:54 -04:00
src unit tests 2022-05-19 17:33:13 +02:00
.gitattributes remove eol in gitattributes 2021-06-17 17:20:16 +03:00
.gitignore download from node-versions and fallback to node dist (#147) 2020-05-19 09:25:54 -04:00
.licensed.yml regenerate license (#7) 2021-06-29 13:34:35 +03:00
.prettierrc.json Initial Import 2019-08-03 21:49:54 -04:00
CODEOWNERS Update CODEOWNERS to actions-service 2022-03-10 13:27:02 -05:00
CODE_OF_CONDUCT.md Convert CONDUCT to CODE_OF_CONDUCT.md (#391) 2022-04-05 11:16:57 -04:00
LICENSE Initial Import 2019-08-03 21:49:54 -04:00
README.md improve version syntax presentation (#493) 2022-05-18 09:50:55 +02:00
action.yml extend documentation on `scope` parameter (#470) 2022-04-19 13:43:19 -04:00
jest.config.js Initial Import 2019-08-03 21:49:54 -04:00
package-lock.json improve latest version syntax 2022-05-19 16:48:16 +02:00
package.json improve latest version syntax 2022-05-19 16:48:16 +02:00
tsconfig.json fix tsc build error for @actions/http-client (#402) 2022-01-11 13:06:36 +03:00

README.md

setup-node

build-test versions proxy

This action provides the following functionality for GitHub Actions users:

  • Optionally downloading and caching distribution of the requested Node.js version, and adding it to the PATH
  • Optionally caching npm/yarn/pnpm dependencies
  • Registering problem matchers for error output
  • Configuring authentication for GPR or npm

Usage

See action.yml

Basic:

steps:
- uses: actions/checkout@v3
- uses: actions/setup-node@v3
  with:
    node-version: 14
- run: npm ci
- run: npm test

The node-version input is optional. If not supplied, the node version from PATH will be used. However, it is recommended to always specify Node.js version and don't rely on the system one.

The action will first check the local cache for a semver match. If unable to find a specific version in the cache, the action will attempt to download a version of Node.js. It will pull LTS versions from node-versions releases and on miss or failure will fall back to the previous behavior of downloading directly from node dist.

For information regarding locally cached versions of Node.js on GitHub hosted runners, check out GitHub Actions Virtual Environments.

Supported version syntax

The node-version input supports the following values:

  • Major versions: 12, 14, 16
  • More specific versions: 10.15, 14.2.0, 16.3.0
  • NVM LTS syntax: lts/erbium, lts/fermium, lts/*
  • Latest release: latest/current/node

Note: Since the latest release will not be cached always, there is possibility of hitting rate limit when downloading from dist

Checking in lockfiles

It's always recommended to commit the lockfile of your package manager for security and performance reasons. For more information consult the "Working with lockfiles" section of the Advanced usage guide.

Caching global packages data

The action has a built-in functionality for caching and restoring dependencies. It uses actions/cache under the hood for caching global packages data but requires less configuration settings. Supported package managers are npm, yarn, pnpm (v6.10+). The cache input is optional, and caching is turned off by default.

The action defaults to search for the dependency file (package-lock.json or yarn.lock) in the repository root, and uses its hash as a part of the cache key. Use cache-dependency-path for cases when multiple dependency files are used, or they are located in different subdirectories.

Note: The action does not cache node_modules

See the examples of using cache for yarn/pnpm and cache-dependency-path input in the Advanced usage guide.

Caching npm dependencies:

steps:
- uses: actions/checkout@v3
- uses: actions/setup-node@v3
  with:
    node-version: 14
    cache: 'npm'
- run: npm ci
- run: npm test

Caching npm dependencies in monorepos:

steps:
- uses: actions/checkout@v3
- uses: actions/setup-node@v3
  with:
    node-version: 14
    cache: 'npm'
    cache-dependency-path: subdir/package-lock.json
- run: npm ci
- run: npm test

Matrix Testing

jobs:
  build:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        node: [ 12, 14, 16 ]
    name: Node ${{ matrix.node }} sample
    steps:
      - uses: actions/checkout@v3
      - name: Setup node
        uses: actions/setup-node@v3
        with:
          node-version: ${{ matrix.node }}
      - run: npm ci
      - run: npm test

Advanced usage

  1. Check latest version
  2. Using a node version file
  3. Using different architectures
  4. Caching packages data
  5. Using multiple operating systems and architectures
  6. Publishing to npmjs and GPR with npm
  7. Publishing to npmjs and GPR with yarn
  8. Using private packages

License

The scripts and documentation in this project are released under the MIT License

Contributions

Contributions are welcome! See Contributor's Guide

Code of Conduct

👋 Be nice. See our code of conduct