如何通过Renovate让多位置Node版本与Dockerfile版本保持一致？

问题背景 #

项目在三处定义了Node版本：

• Dockerfile中导入的Node基础镜像
• package.json、package-lock.json的engines.node属性
• .nvmrc文件

三者数据源独立，导致.nvmrc版本常领先其他文件。需求是：仅当Dockerfile的Node版本被Renovate更新时，同步更新另外两处的版本；Dockerfile版本不变时，其他文件即使有新版本也不更新。

解决方案 #

通过Renovate的自定义规则配置，实现以Dockerfile版本为核心的同步更新：

1. 禁用其他文件的独立更新 #

先阻止engines.node和.nvmrc单独触发更新请求：

{
  "rules": [
    {
      "matchFiles": ["package.json", "package-lock.json"],
      "matchPaths": ["engines.node"],
      "enabled": false
    },
    {
      "matchFiles": [".nvmrc"],
      "enabled": false
    }
  ]
}

2. 绑定Dockerfile更新与其他文件同步 #

添加规则，当Dockerfile的Node镜像版本更新时，自动替换另外两处的版本值：

{
  "rules": [
    // 上述禁用规则
    {
      "matchFiles": ["Dockerfile"],
      "matchDatasources": ["docker"],
      "matchPackageNames": ["node"],
      "postUpdateOptions": [
        {
          "fileFilter": ["package.json", "package-lock.json"],
          "matchPaths": ["engines.node"],
          "replaceString": "{{newValue}}"
        },
        {
          "fileFilter": [".nvmrc"],
          "replaceString": "{{newValue}}"
        }
      ]
    }
  ]
}

3. 统一分组更新 #

将所有Node版本相关变更合并到同一个PR，避免拆分：

{
  "packageRules": [
    {
      "matchPackageNames": ["node"],
      "groupName": "Node.js version (all files)"
    }
  ]
}

配置说明 #

• 禁用规则确保engines.node和.nvmrc不会被单独检测更新，仅依赖Dockerfile的版本触发变更。
• postUpdateOptions会在Dockerfile版本更新完成后，自动将新版本值同步替换到指定文件的对应位置。
• 分组规则保证所有相关文件的版本变更都在同一个PR中提交，便于统一审核和合并。

内容的提问来源于stack exchange，提问作者Andrew Lovato