renovate-config

These are Shareable Config Presets for SpotOn. It contains wide-use Renovatebot configs, based on our toolset and mindset.

• Usage
• Development notes
  • New Releases
• Useful links
  • Renovate App and presets configuration
  • Repos configuration
• Troubleshooting

Usage

If Renovate has already been activated for repo

1. Check to see if you have a renovate.json already. It can be in any of these possible locations.

2. Change renovate config to:

   {
     "$schema": "https://docs.renovatebot.com/renovate-schema.json",
     "extends": [
       "local>SpotOnInc/renovate-config"
     ]
   }

After that, skip to step 3 below.

---

Otherwise:

0. Manually update as much as you can before moving forward. You will have the best experience with Renovate if you start with a fully-updated repo.

1. Activate Renovatebot Github App for your repo or ask your GitHub org administrators to enable it.

2. Renovate will create an init PR for the new repo - open it and check that it has:

   {
     "$schema": "https://docs.renovatebot.com/renovate-schema.json",
     "extends": [
       "local>SpotOnInc/renovate-config"
     ]
   }

3. (Optional) We recommend moving the config to .github/renovate.json5.

4. (Optional) If you use pre-commit we recommend adding next check to repo .pre-commit-config.yaml:

   - repo: https://github.com/pre-commit/mirrors-prettier
     rev: v3.0.0-alpha.4
     hooks:
     - id: prettier
       # https://prettier.io/docs/en/options.html#parser
       files: '.json5$'

5. Be sure that the Dependency graph and Dependabot alerts are enabled for the repo. Details.

6. Merge PR and relax. Renovate will create PRs based on provided schedules. By default, you will see Renovate PRs on Mondays.

Development notes

To change the default config, edit default.template.json5 and create a PR. The matching default.json will be automatically generated and added after your PR is merged.

Note: If your new default.json config does not apply for more than 6 hours, create test repo and copy-paste the whole default.json over and rename it to renovate.json. Renovatebot will test the configuration and create issues if it found problems with the configuration. Or you can ask ChatGPT :)

New Releases

To create a new release, go here.

If there are no releases for more than 30 days and in main present something that is ready to be released - the release will be automatically triggered.

Useful links

• How Renovate find/create/update PRs
  TL;DR: Renovatebot checks branch names and PR titles. If PR is not found to match the branch - Renovatebot will create a new PR.
  To recreate a closed PR, rename the closed PR.

Renovate App and presets configuration

• Managing config for many repositories

• Shareable Config Presets

  • Organization level presets - myorg/renovate-config/default.json magic name
  • GitHub-hosted Presets
  • Contributing to presets
  • Preset Versioning

• Managers: Supported, configuration, disabling, etc.

• Renovate App on GitHub Secrets Encryption

• Known limitations
  Example: GitHub hosted app Mend checks each active repository roughly every three hours, if no activity has been seen before then (merged PRs, etc).

  • No rebasing if you have made edits (conflicting with pre-commit auto-fixes)

• onboardingConfigFileName (self-hosted only).
  Useful to change onboarding Renovate config file location.

• Docker Registries authentication

Repos configuration

• Configuration location

• Overriding global configs

• Scheduling syntax

  • Schedule Presets

• Changing the Semantic Commit type

• How to edit branch names, commit messages, PR titles, and PR content

• Docker Digest pinning and Updating

• Separate patch and minor releases of dependencies into separate PRs.
  More details here

• Group all packages starting with abc together in one PR

• :pinVersions - maintain a single version only and not SemVer ranges

• :rebaseStalePrs - Rebase existing PRs any time the base branch has been updated.

• Update package/GHA references in Markdown files

Troubleshooting

• Troubleshooting docs
• Renovate dashboard