Skip to content
You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?
zap

GitHub Action

@volta-cli/action

v4.0.0-beta.4 Pre-release

@volta-cli/action

zap

@volta-cli/action

Setup a Node.js environment with Volta

Installation

Copy and paste the following snippet into your .yml file.

 
              
- name: @volta-cli/action

              
  uses: volta-cli/[email protected]
Learn more about this action in volta-cli/action

Choose a version

GitHub Action to Setup Volta

GitHub Actions status

This action installs volta by:

  • downloading and caching volta (adding it to your $PATH)
  • optionally downloading and caching a version of node - npm by version spec and add to PATH

Inputs

parameter description required default
volta-version Version of volta to fetch and setup. Examples: 0.6.0, 10.15.1, >=10.15.0 false
node-version Version Spec of the node version to use. Examples: 10.6.x, 10.15.1, >=10.15.0 false
npm-version Version Spec of the npm version to use. Examples: 7.5.x, 7.5.3, >=7.5.3 false
yarn-version Version Spec of the yarn version to use. Examples: 1.6.x, 10.15.1, >=10.15.0 false
package-json-path The path to the package.json to update when using an explicit node-version yarn-version npm-version override. By default, we will use package.json in the checkout root.
variant Specific variant to install. Example: providing the variant "linux-openssl-rhel", which will target installing the volta-${version}-linux-openssl-rhel.tar.gz tarball false
registry-url Optional registry to set up for auth. Will set the registry in a project level .npmrc file, and set up auth to read in from env.NODE_AUTH_TOKEN false
scope Optional scope for authenticating against scoped registries. Will fall back to the repository owner when using the GitHub Packages registry (https://npm.pkg.github.com/). false
token Used to avoid low rate limiting for cached tool downloads. Since there's a default, this is typically not supplied by the user. false ${{ github.token }}
always-auth Set always-auth in npmrc false false

Usage

See action.yml

Basic (when the project's package.json has a volta property with node and/or yarn versions pinned):

steps:
- uses: actions/checkout@v3
- uses: volta-cli/action@v3
- run: npm install
- run: npm test

Manually specifying node and/or yarn versions (e.g. to test a project without volta in package.json):

steps:
- uses: actions/checkout@v3
- uses: volta-cli/action@v3
  with:
    node-version: 18.x
    yarn-version: 1.19.1

- run: yarn install
- run: yarn test

Setting up a matrix of node versions:

strategy:
  matrix:
    node-version: ['^14.10', '16', '18']

steps:
- uses: actions/checkout@v3
- uses: volta-cli/action@v3
  with:
    node-version: ${{ matrix.node-version }}

- run: npm install
- run: npm test

You can also specify the version of npm:

strategy:
  matrix:
    node-version: ['^8.12', '10', '12']

steps:
- uses: actions/checkout@v3
- uses: volta-cli/action@v3
  with:
    node-version: ${{ matrix.node-version }}
    npm-version: '7'

- run: npm install
- run: npm test

In some cases, you may know the particular variant of the installer that you want to use for Volta. You can specify the variant input to the action to use a specific installer:

steps:
- uses: actions/checkout@v3
- uses: volta-cli/action@v3
  with:
    variant: 'linux-openssl-rhel'

- run: yarn install
- run: yarn test

The variant fragment corresponds to a portion of the installer filename, and can be found in the Volta Releases page.

License

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