mirror of
https://github.com/renovatebot/renovate.git
synced 2025-01-11 06:26:26 +00:00
87a025c2d1
* Add gl-got * Add platform config definition * Refactor for multiple platforms Preparing for #65
69 lines
2.8 KiB
Markdown
69 lines
2.8 KiB
Markdown
# renovate
|
|
|
|
> Keep npm dependencies up-to-date
|
|
|
|
## Why
|
|
|
|
- Creates or updates Pull Requests for each dependency that needs updating
|
|
- Discovers and processes all `package.json` files in repository (supports monorepo architecture)
|
|
- Supports multiple major versions per-dependency at once
|
|
- Configurable via file, environment, CLI, and `package.json`
|
|
- Self-hosted
|
|
|
|
## Install
|
|
|
|
```
|
|
$ npm install -g renovate
|
|
```
|
|
|
|
## Authentication
|
|
|
|
You need to select a GitHub user for `renovate` to assume the identity of. It's recommended that you use a dedicated "bot" account for this to avoid user confusion.
|
|
|
|
The script will need a GitHub Personal Access Token with "repo" permissions. You can find instructions for generating it here: https://help.github.com/articles/creating-an-access-token-for-command-line-use/
|
|
|
|
This token needs to be configured via file, environment variable, or CLI. See [docs/configuration.md](docs/configuration.md) for details.
|
|
The simplest way is to expose it as `GITHUB_TOKEN`.
|
|
|
|
## Usage
|
|
|
|
```
|
|
$ node renovate --help
|
|
|
|
Usage: renovate [options] [repositories...]
|
|
|
|
Options:
|
|
|
|
-h, --help output usage information
|
|
--enabled [boolean] Enable or disable renovate
|
|
--onboarding [boolean] Require a Configuration PR first
|
|
--platform <string> Platform type of repository
|
|
--token <string> Repository Auth Token
|
|
--package-files <list> Package file paths
|
|
--dep-types <list> Dependency types
|
|
--ignore-deps <list> Dependencies to ignore
|
|
--ignore-future [boolean] Ignore versions tagged as "future"
|
|
--ignore-unstable [boolean] Ignore versions with unstable semver
|
|
--respect-latest [boolean] Ignore versions newer than npm "latest" version
|
|
--recreate-closed [boolean] Recreate PRs even if same ones were closed previously
|
|
--labels <list> Labels to add to Pull Request
|
|
--assignees <list> Assignees for Pull Request
|
|
--reviewers <list> Requested reviewers for Pull Requests
|
|
--log-level <string> Logging level
|
|
|
|
Examples:
|
|
|
|
$ renovate --token abc123 singapore/lint-condo
|
|
$ renovate --ignore-unstable=false --log-level verbose singapore/lint-condo
|
|
$ renovate singapore/lint-condo singapore/package-test
|
|
```
|
|
|
|
Note: The first time you run `renovate` on a repository, it will not upgrade any dependencies. Instead, it will create a PR called 'Configure Renovate' and commit a default `renovate.json` file to the repository. This PR can be close unmerged if the default settings are fine for you. Also, this behaviour can be disabled if you first disable the `onboarding` setting before running.
|
|
|
|
## Deployment
|
|
|
|
See [deployment docs](docs/deployment.md) for details.
|
|
|
|
## Design Decisions
|
|
|
|
See [design decisions doc](docs/design-decisions.md) for details.
|