actions-yarn/README.md
2018-11-30 21:29:55 +01:00

59 lines
1.6 KiB
Markdown

# GitHub Actions for Yarn
> Look https://github.com/actions/npm for more details.
This Action for [yarn](https://yarnpkg.com) enables arbitrary actions with the `yarn` command-line client, including testing packages and publishing to a registry.
## Usage
An example workflow to build, test, and publish an npm package to the default public registry follows:
```hcl
workflow "Build, Test, and Publish" {
on = "push"
resolves = ["Publish"]
}
action "Build" {
uses = "borales/actions-yarn@master"
args = "install"
}
action "Test" {
needs = "Build"
uses = "borales/actions-yarn@master"
args = "test"
}
action "Publish" {
needs = "Test"
uses = "borales/actions-yarn@master"
args = "publish --access public"
secrets = ["NPM_AUTH_TOKEN"]
}
```
### Secrets
* `NPM_AUTH_TOKEN` - **Optional**. The token to use for authentication with the npm registry. Required for `yarn publish` ([more info](https://docs.npmjs.com/getting-started/working_with_tokens))
### Environment variables
* `NPM_REGISTRY_URL` - **Optional**. To specify a registry to authenticate with. Defaults to `registry.npmjs.org`
* `NPM_CONFIG_USERCONFIG` - **Optional**. To specify a non-default per-user configuration file. Defaults to `$HOME/.npmrc` ([more info](https://docs.npmjs.com/misc/config#npmrc-files))
#### Example
To authenticate with, and publish to, a registry other than `registry.npmjs.org`:
```hcl
action "Publish" {
uses = "borales/actions-yarn@master"
args = "publish --access public"
env = {
NPM_REGISTRY_URL = "someOtherRegistry.someDomain.net"
}
secrets = ["NPM_AUTH_TOKEN"]
}
```