离线Gitlab环境下配置Renovate Bot使用自定义NodeJS镜像

问题根源 #

你遇到的报错是因为Renovate默认通过sidecar容器内的install-tool工具从官方源（nodejs.org）下载Node/NPM，即便主镜像已切换到本地仓库，sidecar的工具安装逻辑仍未调整，导致离线环境下无法解析外部域名。

解决方案 #

1. 复用本地生产Node镜像替代自动下载 #

可以直接复用本地仓库中的Node生产镜像作为Renovate的sidecar容器，无需通过install-tool下载。具体配置如下：

• 在Renovate配置文件（如renovate.json或config.js）中，针对Node项目指定自定义sidecar镜像：

  {
    "packageRules": [
      {
        "matchManagers": ["npm"],
        "sidecarImage": "docker.repo.asts.com/your-production-node-image:16.14.2"
      }
    ]
  }
  

• 禁用自动工具安装，避免Renovate尝试下载依赖：

  {
    "env": {
      "CONTAINERBASE_DISABLE_AUTO_INSTALL": "true"
    }
  }
  

• 注意：确保你的生产Node镜像包含bash、curl等基础工具（Renovate的sidecar脚本依赖这些工具），若缺失需在镜像中额外安装。

2. 全局配置预配置语言Docker镜像 #

若需要为多语言项目统一配置本地镜像仓库的预配置镜像，可通过以下方式：

• 设置containerbase.imagePrefix，替换默认的containerbase/前缀，让Renovate从你的本地仓库拉取各类语言的sidecar镜像：

  {
    "containerbase": {
      "imagePrefix": "docker.repo.asts.com/cots/containerbase/"
    }
  }
  

• 确保本地镜像仓库中存在对应语言的containerbase镜像（如containerbase/node、containerbase/python等），若没有可自行构建并推送到本地仓库。
• 针对特定语言项目，也可通过packageRules单独指定镜像，覆盖全局配置。

3. 完整配置示例 #

结合你已有的dockerImagePrefix配置，完整的离线环境配置如下：

{
  "dockerImagePrefix": "docker.repo.asts.com/cots/renovate/",
  "containerbase": {
    "imagePrefix": "docker.repo.asts.com/cots/containerbase/"
  },
  "env": {
    "CONTAINERBASE_DISABLE_AUTO_INSTALL": "true"
  },
  "packageRules": [
    {
      "matchManagers": ["npm"],
      "sidecarImage": "docker.repo.asts.com/your-production-node-image:16.14.2"
    }
  ]
}

验证配置 #

配置完成后，重新运行Renovate任务，检查sidecar启动命令是否已切换为你指定的本地Node镜像，且不再出现install-tool相关的下载命令，即可确认配置生效。

内容的提问来源于stack exchange，提问作者Marco Stramezzi