尧图网站建设 
Mend Renovate CLI 实战指南跨平台依赖自动化更新工具的原理、运行方式与配置实践【免费下载链接】renovateHome of the Renovate CLI: Cross-platform Dependency Automation by Mend.io项目地址: https://gitcode.com/GitHub_Trending/re/renovateRenovate 是一个开源的自动化依赖更新dependency update工具帮助开发者摆脱手动升级依赖的重复劳动它会自动扫描仓库中的依赖引用发现新版本后直接生成 Pull Request。本文以本仓库Renovate CLI 官方源码仓库的 readme.md 为骨架结合仓库内的运行文档、入口源码与配置文件系统讲解 Renovate 的核心特性、支持的语言与平台、底层工作原理以及云托管、自托管、CI 流水线和 CLI 直跑四种落地方式读完即可上手部署与配置自己的依赖机器人。什么是 Renovate CLIRenovate 是一款自动化依赖更新工具它的定位非常明确在你的仓库中查找对依赖包括公开依赖与私有依赖的引用当检测到存在更新版本时自动创建 Pull Request 来升级版本从而把检查更新、创建分支、提交 PR这一整套流程交给机器完成。从仓库入口 lib/renovate.ts 可以看到其 CLI 的真实启动链路// lib/renovate.ts节选示意核心流程 const otel await import(./instrumentation/index.ts); otel.init(); // 1. 初始化 OpenTelemetry 可观测性 await logger.init(); // 2. 初始化日志系统 (await import(./proxy.ts)).bootstrap(); // 3. 代理环境引导 parseEarlyFlags(); // 4. 解析 --version / --help 等早期参数 const { start } await import(./workers/global/index.ts); process.exitCode await otel.instrument(run, start); // 5. 执行全局运行主流程启动后的全局调度逻辑位于 lib/workers/global/index.ts通过parseConfigs(getEnv(), process.argv)合并环境变量与命令行参数得到全局配置随后对仓库列表逐仓库执行提取依赖、查询更新、写分支、开 PR 等仓库级流程并在过程中应用autodiscoverRepositories自动发现仓库、isLimitReached提交数限制等全局机制。也就是说Renovate CLI 是一次性进程跑完所有配置的仓库后即退出除非显式设置RENOVATE_X_HARD_EXIT因此非常适合配合 cron 等定时任务周期运行。核心特性一览根据 readme.md 的 Features 章节Renovate 的核心能力包括直接向你的仓库投递更新 PR自动发现相关包文件package files无需逐一手动配置自动在仓库中生成 Pull Request提供决策辅助信息为每次更新附带 age版本发布时间、adoption社区采用度、pass rates通过率、merge confidence合并置信度等数据帮助你判断该接受哪些更新高度可配置可以灵活贴合你的需求与仓库规范分组、定时、自动合并、语义化提交等均可定制覆盖最广的语言与平台集合详见下文可连接私有仓库与私有包注册表支持访问私有依赖源相关内容见 docs/usage/getting-started/private-packages.md支持的语言package managers官方文档声明 Renovate 支持超过 90 种不同的包管理器。从仓库目录结构也可以直观印证这一规模lib/modules/manager下约有 127 个 manager 模块目录涵盖 npm、JavaMaven/Gradle、Pythonpip/poetry/pipenv、.NETNuGet、Scalasbt、RubyBundler、Gogomod、DockerDockerfile/docker-compose、Terraform、Kubernetes、GitHub Actions、CircleCI、Travis 等传统与现代形态的依赖载体。每个 manager 的入口统一收敛在 lib/modules/manager/api.tsmanager 的完整文档见 docs/usage/modules/manager/index.md。支持的平台Renovate 可以更新以下代码托管平台的仓库GitHub、GitLab、Bitbucket、Azure DevOps、AWS Code Commit实验性、Gitea、Forgejo、Gerrit实验性、SCM-Manager实验性。源码层面平台标识符定义在 lib/constants/platforms.tsexport const PLATFORM_HOST_TYPES [ azure, bitbucket, bitbucket-server, codecommit, forgejo, gerrit, gitea, github, gitlab, local, scm-manager, ] as const;该文件还按平台划定了 API 使用范围例如GITHUB_API_USING_HOST_TYPES包含github、github-releases、github-tags等用于 hostRules 与限流管理local平台则用于在本地文件系统上直接运行 Renovate对应platform local时使用当前工作目录的逻辑见 lib/workers/global/index.ts。各平台对接文档见 docs/usage/modules/platform/index.md。Renovate 是如何工作的要真正用好 Renovate需要理解它的四类核心模块。文档 docs/usage/key-concepts/how-renovate-works.md 给出了清晰的模块分工与调用顺序platform 模块与源码托管平台交互负责克隆仓库、读写分支、创建 PRmanager 模块按文件名约定匹配并扫描包文件提取其中的依赖每个依赖都关联一个 datasourcedatasource 模块负责向注册表查询依赖的可用版本versioning 模块对查询到的版本进行合法性校验与排序选出下一个合法更新。文档给出一个直观的例子gitlabcimanager 在流水线文件中提取出依赖python:3.10-alpine它关联dockerdatasourcedatasource 返回候选版本列表后dockerversioning 从中选出与python:3.10-alpine兼容的最新版本python:3.11-alpine。整体运行流程则分为四大阶段完整流程图见 docs/usage/key-concepts/how-renovate-works.md 中的 mermaid 图初始化INITIALIZATION按优先级合并配置cli env file default初始化平台连接查询平台仓库列表并按过滤器收窄提取依赖EXTRACT DEPENDENCIES对每个仓库、每个 manager、每个匹配文件逐一提取依赖并检查漏洞vulnerability查询更新LOOK UP UPDATES对每个依赖用 datasource 拉取版本再用 versioning 计算下一个合法更新写入更新WRITE UPDATES对每个更新判断是否需要创建/变基分支考虑已有分支、并发数量等然后创建分支、应用更新、创建 PR收尾FINALIZE检查配置迁移、清理过期分支。这一提取 → 查询 → 写入的流水线设计使得新增一种语言或平台的接入成本被隔离在单一模块内——这也是 docs/development/adding-a-package-manager.md 所描述的扩展方式。运行 Renovate 的四种方式readme.md 明确指出运行 Renovate 最有效的方式是使用自动化任务调度系统定期对所有启用的仓库运行 Renovate并对用户活动做出优先响应。Mend 提供了云托管与自托管两类方案你也可以把 Renovate 接入自己的 CI 或直接跑 CLI。1. Mend Renovate Community云托管支持GitHub.com、Bitbucket Cloud。由 Mend.io 托管无需任何安装配置提供免费的 Community 计划GitHub Cloud在 GitHub 上为你的组织安装Renovate Cloud-Hosted App然后选择要启用的仓库Bitbucket Cloud为 Workspace 添加Mend App并将 Mend Renovate 用户加入要启用的项目。2. Mend Renovate Community / Enterprise自托管支持GitHub、GitLab、Bitbucket Data Center。安装并运行你自己的 Renovate 服务可以访问内部私有包。官方提供了免费的Mend Renovate Community Self-Hosted与付费的Mend Renovate Enterprise两个版本。自托管版本是有状态的长期运行应用不随仓库处理完毕而退出以 App 形式安装在 GitHub/GitLab 上并响应 Webhook内部包含优先处理PR 合并等事件的优先级任务队列CE 每两周发布一次节奏比 OSS 版每次提交即发布更慢更稳其许可证为 EULA 而非 AGPL-3.0-only。Enterprise 版额外支持多 worker 容器水平扩展、Mend 专属支持以及 Smart Merge Control 等高级特性。3. 在 CI 流水线中运行如果无法使用预制调度系统官方与社区提供了多种流水线集成方式GitHub Actionrenovatebot/github-action在 GitHub Actions 中作为 job 运行GitLab RunnerRenovate Runner 项目同时支持gitlab.com与自托管 GitLabAzure DevOps可使用 Renovate 开发者维护的 Renovate Me 扩展注意该扩展由个人维护相关问题不在主仓库受理自定义流水线用 yml 定义任务触发npx renovate即可Azure 平台的具体配置见 docs/usage/modules/platform/azure/index.md。4. 直接运行 Renovate CLIreadme.md 指出 CLI 方式支持所有平台完整选项见 docs/usage/getting-started/running.md。该文档对 CLI 发行形态做了详细说明npm 包CLI开源 CLI 以 npm 包renovate形式分发可在任意 Node.js 环境运行甚至直接npx renovate。安装 npm 包时需要自行负责安装 Ruby、Python、Composer、Bundler、Poetry 等第三方语言/工具。从 package.json 可以看到它要求 Node.js^24.11.0、pnpm^11.0.0并提供两个可执行入口bin: { renovate: dist/renovate.js, renovate-config-validator: dist/config-validator.js }其中renovate-config-validator用于独立校验 Renovate 配置文件对应脚本node lib/config-validator.ts。Docker 镜像同时在 Docker Hubrenovate/renovate与 GitHub Container Registryghcr.io/renovatebot/renovate分发支持linux/amd64与linux/arm64两种架构arm64 可能仍有少量 bug不支持在 Windows/macOS 容器中运行。镜像分为两种 flavor默认镜像latest标签的默认形态仅内置 Node.js 环境运行时装好所需工具对应binarySourceinstall配置推荐大多数用户使用。工具下载支持持久缓存可通过containerbaseDir控制缓存位置-full镜像预装绝大多数非全部包管理器的最新版本工具适合不想在运行时下载安装的用户缺点是体积达数 GB且每个语言只有单一版本。注意binarySourcedocker把 Docker socket 挂入容器、动态调用 sidecar 镜像的方式已被标记为废弃未来将移除。定时与托管无论选择 npm 包还是 Docker 镜像都需要某种 cron 类能力来调度 Renovate 周期运行——官方建议尽可能每小时运行一次。CE/EE 等长期运行容器则内置了调度概念。自托管配置与认证要点自托管时Renovate 的服务端/管理员配置称为global config可通过四种方式提供配置文件、附加配置文件、环境变量、CLI 参数。默认检查当前目录是否存在config.js其他格式*.js、*.ts、*.json、*.json5、*.yaml、*.yml需用环境变量RENOVATE_CONFIG_FILE指定例如RENOVATE_CONFIG_FILEconfig.yamlconfig.js可以导出普通对象、Promise或返回二者的函数支持在配置中引入异步结果TypeScript 配置.ts/.mts/.cts同样受支持可通过RENOVATE_CONFIG_FILEconfig.ts renovate加载附加配置文件仅当设置RENOVATE_ADDITIONAL_CONFIG_FILE时生效优先级高于默认配置文件环境变量方式有两种单选项如RENOVATE_TOKENabc123驼峰命名、RENOVATE_前缀或用RENOVATE_CONFIG{token:abc123,gitAuthor:ab.com}传入整体 JSON两者混用时单选项环境变量优先。前缀也可通过ENV_PREFIX自定义如ENV_PREFIXRNV_ RNV_TOKENabc123 renovate。认证无论哪个平台都需要为 Renovate 选择一个身份账号并生成 Personal Access Token。自托管建议用户名使用renovate-bot并通过config.gitAuthor配置相同身份如gitAuthor: Renovate renovatesome.domain.test同时务必为 Renovate 使用独立专用账号不要与其他机器人混用否则可能导致摇摆不定flip-flopping。在非 github.com 平台运行时还应设置RENOVATE_GITHUB_COM_TOKEN任意 GitHub 账号、只读权限即可用于拉取 changelog 与部分运行时工具以提升 github.com API 的每小时限额。各平台认证文档见 docs/usage/modules/platform/ 下的对应页面。全局配置清单自托管管理员可用的全部全局选项见 docs/usage/self-hosted-configuration.md所有配置选项的完整参考见 docs/usage/configuration-options.md。配置实践从示例看 Renovate 配置能力本仓库自身就是 Renovate 的吃自己的狗粮dogfooding案例——根目录的 renovate.json 是一份相当完整的真实配置非常值得作为模板研读。它展示了以下常用能力预设继承与忽略extends: [githubrenovatebot/.github]继承组织预设ignorePresets、ignorePaths控制忽略范围人员与提交规范assignees指派审阅人、reviewers指定评审团队、semanticCommitScope与按包类型/文件路径设置的semanticCommitType统一提交信息风格packageRules 精细规则按matchPackageNames、matchDepTypes、matchFileNames、matchUpdateTypes、matchDatasources、matchBaseBranches组合出高度定制行为例如对ghcr.io/renovatebot/base-image在next分支允许预发布ignoreUnstable: false并附带feat(deps)!:提交前缀major 更新打上breaking标签、拆分子前缀分支additionalBranchPrefix、同一依赖的多个 major 分开建 PRseparateMultipleMajor对next分支要求dependencyDashboardApproval: true依赖看板审批自定义 managercustomManagers用正则从源码中提取依赖例如从lib/config/options/index.ts中提取 base-image 版本、从lib/modules/manager/mix/artifacts.ts提取 Erlang 版本并指定datasourceTemplate、packageNameTemplate、versioningTemplate——这正是 Renovate高度可配置的典型体现。对普通用户而言最常见的三类配置还包括按 manager 定制详见 docs/usage/modules/manager/index.md{ gradle: { enabled: false }, enabledManagers: [npm, dockerfile] }enabledManagers会禁用列表之外的所有 manager没有默认文件名约定的 manager如kubernetes需要显式配置managerFilePatterns才会启用manager 的文件匹配模式是累加式的不需要重复内置模式误匹配时用ignorePaths排除。按 datasource 定制详见 docs/usage/modules/datasource/index.mddatasource 决定如何查询新版本通常无需手动配置但在packageRules中作为匹配条件使用{ packageRules: [ { matchDatasources: [npm], matchPackageNames: [lodash], automerge: true } ] }文档地图与进阶阅读仓库docs/目录承载了完整的用户文档与开发文档建议按需取用入门安装与 onboarding、运行 Renovate、自托管示例核心概念Renovate 工作原理、Pull Requests、presets、定时调度、自动合并高级用法访问私有包、Merge Confidence 数据、配置模板、配置迁移参考全部配置选项、自托管配置、环境变量处理对比不同运行方式对比、社区工具参与贡献与安全披露问题与讨论寻求帮助、建议新功能或报告 bug 请优先开 DiscussionIssues 仅由维护者创建贡献指南想贡献代码或本地运行副本请阅读 docs/development/local-development.md、docs/development/adding-a-package-manager.md 与 docs/development/readme.md并参考good first issues寻找合适任务本地克隆仓库可使用git clone https://gitcode.com/GitHub_Trending/re/renovate安全披露发现可能构成安全问题的 bug请通过 GitHub Security Advisories 流程报告或邮件联系renovate-disclosuremend.io以便维护团队在漏洞被滥用前完成评估与修复。总结Renovate 的设计哲学可以概括为自动发现、自动更新、高度可配置它以 manager 提取依赖、datasource 查询版本、versioning 校验排序、platform 落地 PR 的四模块流水线覆盖 90 包管理器与 9 大托管平台并通过云托管、自托管 CE/EE、CI 集成、CLI/Docker 直跑四种方式适配不同规模的团队。无论你是想装个 App 一键启用还是希望在自建 CI 里用npx renovate拉起每小时一次的依赖巡检都可以直接参照本文对应的仓库文档与源码快速落地而面对复杂的 monorepo、私有源、分组与审批诉求时packageRulescustomManagers的组合足以支撑企业级的精细治理。【免费下载链接】renovateHome of the Renovate CLI: Cross-platform Dependency Automation by Mend.io项目地址: https://gitcode.com/GitHub_Trending/re/renovate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Mend Renovate CLI 实战指南：跨平台依赖自动化更新工具的原理、运行方式与配置实践
Mend Renovate CLI 实战指南跨平台依赖自动化更新工具的原理、运行方式与配置实践【免费下载链接】renovateHome of the Renovate CLI: Cross-platform Dependency Automation by Mend.io项目地址: https://gitcode.com/GitHub_Trending/re/renovateRenovate 是一个开源的自动化依赖更新dependency update工具帮助开发者摆脱手动升级依赖的重复劳动它会自动扫描仓库中的依赖引用发现新版本后直接生成 Pull Request。本文以本仓库Renovate CLI 官方源码仓库的 readme.md 为骨架结合仓库内的运行文档、入口源码与配置文件系统讲解 Renovate 的核心特性、支持的语言与平台、底层工作原理以及云托管、自托管、CI 流水线和 CLI 直跑四种落地方式读完即可上手部署与配置自己的依赖机器人。什么是 Renovate CLIRenovate 是一款自动化依赖更新工具它的定位非常明确在你的仓库中查找对依赖包括公开依赖与私有依赖的引用当检测到存在更新版本时自动创建 Pull Request 来升级版本从而把检查更新、创建分支、提交 PR这一整套流程交给机器完成。从仓库入口 lib/renovate.ts 可以看到其 CLI 的真实启动链路// lib/renovate.ts节选示意核心流程 const otel await import(./instrumentation/index.ts); otel.init(); // 1. 初始化 OpenTelemetry 可观测性 await logger.init(); // 2. 初始化日志系统 (await import(./proxy.ts)).bootstrap(); // 3. 代理环境引导 parseEarlyFlags(); // 4. 解析 --version / --help 等早期参数 const { start } await import(./workers/global/index.ts); process.exitCode await otel.instrument(run, start); // 5. 执行全局运行主流程启动后的全局调度逻辑位于 lib/workers/global/index.ts通过parseConfigs(getEnv(), process.argv)合并环境变量与命令行参数得到全局配置随后对仓库列表逐仓库执行提取依赖、查询更新、写分支、开 PR 等仓库级流程并在过程中应用autodiscoverRepositories自动发现仓库、isLimitReached提交数限制等全局机制。也就是说Renovate CLI 是一次性进程跑完所有配置的仓库后即退出除非显式设置RENOVATE_X_HARD_EXIT因此非常适合配合 cron 等定时任务周期运行。核心特性一览根据 readme.md 的 Features 章节Renovate 的核心能力包括直接向你的仓库投递更新 PR自动发现相关包文件package files无需逐一手动配置自动在仓库中生成 Pull Request提供决策辅助信息为每次更新附带 age版本发布时间、adoption社区采用度、pass rates通过率、merge confidence合并置信度等数据帮助你判断该接受哪些更新高度可配置可以灵活贴合你的需求与仓库规范分组、定时、自动合并、语义化提交等均可定制覆盖最广的语言与平台集合详见下文可连接私有仓库与私有包注册表支持访问私有依赖源相关内容见 docs/usage/getting-started/private-packages.md支持的语言package managers官方文档声明 Renovate 支持超过 90 种不同的包管理器。从仓库目录结构也可以直观印证这一规模lib/modules/manager下约有 127 个 manager 模块目录涵盖 npm、JavaMaven/Gradle、Pythonpip/poetry/pipenv、.NETNuGet、Scalasbt、RubyBundler、Gogomod、DockerDockerfile/docker-compose、Terraform、Kubernetes、GitHub Actions、CircleCI、Travis 等传统与现代形态的依赖载体。每个 manager 的入口统一收敛在 lib/modules/manager/api.tsmanager 的完整文档见 docs/usage/modules/manager/index.md。支持的平台Renovate 可以更新以下代码托管平台的仓库GitHub、GitLab、Bitbucket、Azure DevOps、AWS Code Commit实验性、Gitea、Forgejo、Gerrit实验性、SCM-Manager实验性。源码层面平台标识符定义在 lib/constants/platforms.tsexport const PLATFORM_HOST_TYPES [ azure, bitbucket, bitbucket-server, codecommit, forgejo, gerrit, gitea, github, gitlab, local, scm-manager, ] as const;该文件还按平台划定了 API 使用范围例如GITHUB_API_USING_HOST_TYPES包含github、github-releases、github-tags等用于 hostRules 与限流管理local平台则用于在本地文件系统上直接运行 Renovate对应platform local时使用当前工作目录的逻辑见 lib/workers/global/index.ts。各平台对接文档见 docs/usage/modules/platform/index.md。Renovate 是如何工作的要真正用好 Renovate需要理解它的四类核心模块。文档 docs/usage/key-concepts/how-renovate-works.md 给出了清晰的模块分工与调用顺序platform 模块与源码托管平台交互负责克隆仓库、读写分支、创建 PRmanager 模块按文件名约定匹配并扫描包文件提取其中的依赖每个依赖都关联一个 datasourcedatasource 模块负责向注册表查询依赖的可用版本versioning 模块对查询到的版本进行合法性校验与排序选出下一个合法更新。文档给出一个直观的例子gitlabcimanager 在流水线文件中提取出依赖python:3.10-alpine它关联dockerdatasourcedatasource 返回候选版本列表后dockerversioning 从中选出与python:3.10-alpine兼容的最新版本python:3.11-alpine。整体运行流程则分为四大阶段完整流程图见 docs/usage/key-concepts/how-renovate-works.md 中的 mermaid 图初始化INITIALIZATION按优先级合并配置cli env file default初始化平台连接查询平台仓库列表并按过滤器收窄提取依赖EXTRACT DEPENDENCIES对每个仓库、每个 manager、每个匹配文件逐一提取依赖并检查漏洞vulnerability查询更新LOOK UP UPDATES对每个依赖用 datasource 拉取版本再用 versioning 计算下一个合法更新写入更新WRITE UPDATES对每个更新判断是否需要创建/变基分支考虑已有分支、并发数量等然后创建分支、应用更新、创建 PR收尾FINALIZE检查配置迁移、清理过期分支。这一提取 → 查询 → 写入的流水线设计使得新增一种语言或平台的接入成本被隔离在单一模块内——这也是 docs/development/adding-a-package-manager.md 所描述的扩展方式。运行 Renovate 的四种方式readme.md 明确指出运行 Renovate 最有效的方式是使用自动化任务调度系统定期对所有启用的仓库运行 Renovate并对用户活动做出优先响应。Mend 提供了云托管与自托管两类方案你也可以把 Renovate 接入自己的 CI 或直接跑 CLI。1. Mend Renovate Community云托管支持GitHub.com、Bitbucket Cloud。由 Mend.io 托管无需任何安装配置提供免费的 Community 计划GitHub Cloud在 GitHub 上为你的组织安装Renovate Cloud-Hosted App然后选择要启用的仓库Bitbucket Cloud为 Workspace 添加Mend App并将 Mend Renovate 用户加入要启用的项目。2. Mend Renovate Community / Enterprise自托管支持GitHub、GitLab、Bitbucket Data Center。安装并运行你自己的 Renovate 服务可以访问内部私有包。官方提供了免费的Mend Renovate Community Self-Hosted与付费的Mend Renovate Enterprise两个版本。自托管版本是有状态的长期运行应用不随仓库处理完毕而退出以 App 形式安装在 GitHub/GitLab 上并响应 Webhook内部包含优先处理PR 合并等事件的优先级任务队列CE 每两周发布一次节奏比 OSS 版每次提交即发布更慢更稳其许可证为 EULA 而非 AGPL-3.0-only。Enterprise 版额外支持多 worker 容器水平扩展、Mend 专属支持以及 Smart Merge Control 等高级特性。3. 在 CI 流水线中运行如果无法使用预制调度系统官方与社区提供了多种流水线集成方式GitHub Actionrenovatebot/github-action在 GitHub Actions 中作为 job 运行GitLab RunnerRenovate Runner 项目同时支持gitlab.com与自托管 GitLabAzure DevOps可使用 Renovate 开发者维护的 Renovate Me 扩展注意该扩展由个人维护相关问题不在主仓库受理自定义流水线用 yml 定义任务触发npx renovate即可Azure 平台的具体配置见 docs/usage/modules/platform/azure/index.md。4. 直接运行 Renovate CLIreadme.md 指出 CLI 方式支持所有平台完整选项见 docs/usage/getting-started/running.md。该文档对 CLI 发行形态做了详细说明npm 包CLI开源 CLI 以 npm 包renovate形式分发可在任意 Node.js 环境运行甚至直接npx renovate。安装 npm 包时需要自行负责安装 Ruby、Python、Composer、Bundler、Poetry 等第三方语言/工具。从 package.json 可以看到它要求 Node.js^24.11.0、pnpm^11.0.0并提供两个可执行入口bin: { renovate: dist/renovate.js, renovate-config-validator: dist/config-validator.js }其中renovate-config-validator用于独立校验 Renovate 配置文件对应脚本node lib/config-validator.ts。Docker 镜像同时在 Docker Hubrenovate/renovate与 GitHub Container Registryghcr.io/renovatebot/renovate分发支持linux/amd64与linux/arm64两种架构arm64 可能仍有少量 bug不支持在 Windows/macOS 容器中运行。镜像分为两种 flavor默认镜像latest标签的默认形态仅内置 Node.js 环境运行时装好所需工具对应binarySourceinstall配置推荐大多数用户使用。工具下载支持持久缓存可通过containerbaseDir控制缓存位置-full镜像预装绝大多数非全部包管理器的最新版本工具适合不想在运行时下载安装的用户缺点是体积达数 GB且每个语言只有单一版本。注意binarySourcedocker把 Docker socket 挂入容器、动态调用 sidecar 镜像的方式已被标记为废弃未来将移除。定时与托管无论选择 npm 包还是 Docker 镜像都需要某种 cron 类能力来调度 Renovate 周期运行——官方建议尽可能每小时运行一次。CE/EE 等长期运行容器则内置了调度概念。自托管配置与认证要点自托管时Renovate 的服务端/管理员配置称为global config可通过四种方式提供配置文件、附加配置文件、环境变量、CLI 参数。默认检查当前目录是否存在config.js其他格式*.js、*.ts、*.json、*.json5、*.yaml、*.yml需用环境变量RENOVATE_CONFIG_FILE指定例如RENOVATE_CONFIG_FILEconfig.yamlconfig.js可以导出普通对象、Promise或返回二者的函数支持在配置中引入异步结果TypeScript 配置.ts/.mts/.cts同样受支持可通过RENOVATE_CONFIG_FILEconfig.ts renovate加载附加配置文件仅当设置RENOVATE_ADDITIONAL_CONFIG_FILE时生效优先级高于默认配置文件环境变量方式有两种单选项如RENOVATE_TOKENabc123驼峰命名、RENOVATE_前缀或用RENOVATE_CONFIG{token:abc123,gitAuthor:ab.com}传入整体 JSON两者混用时单选项环境变量优先。前缀也可通过ENV_PREFIX自定义如ENV_PREFIXRNV_ RNV_TOKENabc123 renovate。认证无论哪个平台都需要为 Renovate 选择一个身份账号并生成 Personal Access Token。自托管建议用户名使用renovate-bot并通过config.gitAuthor配置相同身份如gitAuthor: Renovate renovatesome.domain.test同时务必为 Renovate 使用独立专用账号不要与其他机器人混用否则可能导致摇摆不定flip-flopping。在非 github.com 平台运行时还应设置RENOVATE_GITHUB_COM_TOKEN任意 GitHub 账号、只读权限即可用于拉取 changelog 与部分运行时工具以提升 github.com API 的每小时限额。各平台认证文档见 docs/usage/modules/platform/ 下的对应页面。全局配置清单自托管管理员可用的全部全局选项见 docs/usage/self-hosted-configuration.md所有配置选项的完整参考见 docs/usage/configuration-options.md。配置实践从示例看 Renovate 配置能力本仓库自身就是 Renovate 的吃自己的狗粮dogfooding案例——根目录的 renovate.json 是一份相当完整的真实配置非常值得作为模板研读。它展示了以下常用能力预设继承与忽略extends: [githubrenovatebot/.github]继承组织预设ignorePresets、ignorePaths控制忽略范围人员与提交规范assignees指派审阅人、reviewers指定评审团队、semanticCommitScope与按包类型/文件路径设置的semanticCommitType统一提交信息风格packageRules 精细规则按matchPackageNames、matchDepTypes、matchFileNames、matchUpdateTypes、matchDatasources、matchBaseBranches组合出高度定制行为例如对ghcr.io/renovatebot/base-image在next分支允许预发布ignoreUnstable: false并附带feat(deps)!:提交前缀major 更新打上breaking标签、拆分子前缀分支additionalBranchPrefix、同一依赖的多个 major 分开建 PRseparateMultipleMajor对next分支要求dependencyDashboardApproval: true依赖看板审批自定义 managercustomManagers用正则从源码中提取依赖例如从lib/config/options/index.ts中提取 base-image 版本、从lib/modules/manager/mix/artifacts.ts提取 Erlang 版本并指定datasourceTemplate、packageNameTemplate、versioningTemplate——这正是 Renovate高度可配置的典型体现。对普通用户而言最常见的三类配置还包括按 manager 定制详见 docs/usage/modules/manager/index.md{ gradle: { enabled: false }, enabledManagers: [npm, dockerfile] }enabledManagers会禁用列表之外的所有 manager没有默认文件名约定的 manager如kubernetes需要显式配置managerFilePatterns才会启用manager 的文件匹配模式是累加式的不需要重复内置模式误匹配时用ignorePaths排除。按 datasource 定制详见 docs/usage/modules/datasource/index.mddatasource 决定如何查询新版本通常无需手动配置但在packageRules中作为匹配条件使用{ packageRules: [ { matchDatasources: [npm], matchPackageNames: [lodash], automerge: true } ] }文档地图与进阶阅读仓库docs/目录承载了完整的用户文档与开发文档建议按需取用入门安装与 onboarding、运行 Renovate、自托管示例核心概念Renovate 工作原理、Pull Requests、presets、定时调度、自动合并高级用法访问私有包、Merge Confidence 数据、配置模板、配置迁移参考全部配置选项、自托管配置、环境变量处理对比不同运行方式对比、社区工具参与贡献与安全披露问题与讨论寻求帮助、建议新功能或报告 bug 请优先开 DiscussionIssues 仅由维护者创建贡献指南想贡献代码或本地运行副本请阅读 docs/development/local-development.md、docs/development/adding-a-package-manager.md 与 docs/development/readme.md并参考good first issues寻找合适任务本地克隆仓库可使用git clone https://gitcode.com/GitHub_Trending/re/renovate安全披露发现可能构成安全问题的 bug请通过 GitHub Security Advisories 流程报告或邮件联系renovate-disclosuremend.io以便维护团队在漏洞被滥用前完成评估与修复。总结Renovate 的设计哲学可以概括为自动发现、自动更新、高度可配置它以 manager 提取依赖、datasource 查询版本、versioning 校验排序、platform 落地 PR 的四模块流水线覆盖 90 包管理器与 9 大托管平台并通过云托管、自托管 CE/EE、CI 集成、CLI/Docker 直跑四种方式适配不同规模的团队。无论你是想装个 App 一键启用还是希望在自建 CI 里用npx renovate拉起每小时一次的依赖巡检都可以直接参照本文对应的仓库文档与源码快速落地而面对复杂的 monorepo、私有源、分组与审批诉求时packageRulescustomManagers的组合足以支撑企业级的精细治理。【免费下载链接】renovateHome of the Renovate CLI: Cross-platform Dependency Automation by Mend.io项目地址: https://gitcode.com/GitHub_Trending/re/renovate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考