Renovate 的 GitLab CI/CD 管理器从 gitlab-ci.yml 提取 Docker 依赖与 registryAliases 配置指南【免费下载链接】renovateHome of the Renovate CLI: Cross-platform Dependency Automation by Mend.io项目地址: https://gitcode.com/GitHub_Trending/re/renovateRenovate 内置的 GitLab CI/CD 管理器代码位于 lib/modules/manager/gitlabci用于从gitlab-ci.yml文件中提取 Docker 镜像依赖并自动升级版本。本文以该管理器的官方文档与源码实现为主线系统讲解其支持的依赖形态、registryAliases的完整配置方法、GitLab 预定义变量与 Dependency Proxy 前缀变量的处理机制以及基于源码的底层解析流程帮助你正确配置 Renovate 以在 GitLab CI 场景下获得准确的版本更新。GitLab CI/CD 管理器概述Renovate 将 GitLab CI 归入ci类别模块的displayName为GitLab CI/CD。其默认行为仅扫描仓库根目录下匹配/\\.gitlab-ci\\.ya?ml$/的文件即.gitlab-ci.yml或.gitlab-ci.yaml该文件匹配规则定义在 lib/modules/manager/gitlabci/index.ts 的defaultConfig中export const defaultConfig { managerFilePatterns: [/\\.gitlab-ci\\.ya?ml$/], };管理器支持两种数据源见同一文件的supportedDatasourcesDockerDatasource用于image与services中的 Docker 镜像GitlabTagsDatasource用于 GitLab CI/CD 组件component引用。它能够识别四种依赖类型定义在 lib/modules/manager/gitlabci/dep-types.tsdepType含义image以字符串形式直接声明的 Docker 镜像如image: ruby:2.5.0image-name通过name属性声明的 Docker 镜像如image: { name: ... }service-image作为服务services使用的 Docker 镜像repositoryGitLab CI/CD 组件引用include: - component: ...从 gitlab-ci.yml 提取 Docker 依赖提取核心位于 lib/modules/manager/gitlabci/extract.ts 的extractPackageFile函数。它解析 YAML 后对每个顶层对象依次执行Job.parse与Jobs.parseschema 定义在 lib/modules/manager/gitlabci/schema.ts从而覆盖顶层image字段image: ruby:2.5.0字符串形式或image: { name: ... }对象形式顶层services字段字符串形式- mariadb:10.4.11或带name的对象形式可含alias、entrypoint、command等属性每个具名 Job 内部的image与services。对每个镜像会调用 lib/modules/manager/gitlabci/utils.ts 中的getGitlabDep生成依赖对象并依据dep-types.ts标记对应的depType。以 lib/modules/manager/gitlabci/fixtures/gitlab-ci.1.yaml 为例image: name: renovate/renovate:19.70.8-slim services: - mariadb:10.4.11 - other/image:1.0.0对应测试 lib/modules/manager/gitlabci/extract.spec.ts 验证了提取结果分别得到image-name类型依赖renovate/renovate19.70.8-slim与两个service-image类型依赖mariadb10.4.11、other/image1.0.0。此外extractAllPackageFiles还会递归处理include: - local: ...引用的本地文件解析每个文件中的本地 include 并加入待检查队列直至全部处理完毕见 extract.ts。测试中gitlab-ci.3.yaml连同其 include 的include.yml、include.1.yml共提取出 5 个依赖正是这一递归能力的验证。版本格式默认情况下镜像版本使用 Docker 版本格式进行解析与比较。如果需要调整版本格式例如改用semver、loose或其他 Renovate 支持的版本方案应查阅 Renovate 的版本化versioning文档docs/usage/modules/versioning/index.md并在 Renovate 配置中通过versioning字段覆盖对应依赖的版本规则。使用 registryAliases 解析 GitLab 预定义变量GitLab CI 会注入大量预定义变量例如CI_REGISTRY当前项目的 Container Registry 地址、CI_SERVER_FQDN、CI_SERVER_HOST等。当gitlab-ci.yml中的镜像引用使用了这些变量时Renovate 无法直接得知变量在运行时展开后的真实值因而无法定位到正确的镜像仓库。解决方式是在 Renovate 配置中通过registryAliases为这些变量提供显式的别名值{ registryAliases: { $CI_REGISTRY: registry.example.com, $CI_SERVER_FQDN: gitlab.example.com, $CI_SERVER_HOST: gitlab.example.com } }配置后Renovate 在提取依赖时会把depName中的变量前缀替换为别名值用于解析镜像的真实仓库地址同时保留原始replaceString如$CI_REGISTRY/renovate/renovate:31.65.1-slim与autoReplaceStringTemplate从而在生成 PR 时依然以变量形式原位更新版本而不是把变量写死为具体地址。这一点在测试 extract.spec.ts 中有完整印证当配置$CI_REGISTRY: registry.com、$BUILD_IMAGES: registry.com/build-images后镜像$CI_REGISTRY/renovate/renovate:31.65.1-slim的depName保持为$CI_REGISTRY/renovate/renovate而packageName被解析为registry.com/renovate/renovateautoReplaceStringTemplate则保留了$CI_REGISTRY/前缀用于原位替换。带默认值的变量:-语法GitLab CI 变量支持默认值语法:-例如${CI_REGISTRY:-}表示若CI_REGISTRY未定义则使用空值。Renovate 同样支持在registryAliases中配置这类变量{ registryAliases: { ${CI_REGISTRY:-}: registry.example.com } }注意这里的键必须包含花括号与:-后缀与gitlab-ci.yml中的实际写法保持一致Renovate 才能精确匹配。变量后跟镜像名的两种写法配置好别名后${CI_REGISTRY:-}之后无论是带斜杠还是不带斜杠的镜像引用格式都能被正确解析带斜杠${CI_REGISTRY:-}/image:1.0不带斜杠${CI_REGISTRY:-}image:1.0同时别名值本身带不带结尾斜杠均可正常工作——Renovate 会在拼接时自动兼容这两种写法。换言之${CI_REGISTRY:-}: registry.example.com与${CI_REGISTRY:-}: registry.example.com/都能得到相同的结果。支持 GitLab Dependency Proxy 预定义前缀变量如果你使用了 GitLab Dependency Proxy依赖代理功能可以直接用其预定义变量作为镜像前缀无需任何额外配置。Renovate 在 utils.ts 中通过正则\$\\{?CI_DEPENDENCY_PROXY_(?:DIRECT_)?GROUP_IMAGE_PREFIX\\}?/识别以下两个变量CI_DEPENDENCY_PROXY_GROUP_IMAGE_PREFIXCI_DEPENDENCY_PROXY_DIRECT_GROUP_IMAGE_PREFIX使用示例来自 extract.spec.ts 的测试image: name: ${CI_DEPENDENCY_PROXY_GROUP_IMAGE_PREFIX}/renovate/renovate:31.65.1-slim services: - $CI_DEPENDENCY_PROXY_DIRECT_GROUP_IMAGE_PREFIX/mariadb:10.4.11 - name: $CI_DEPENDENCY_PROXY_GROUP_IMAGE_PREFIX/other/image1:1.0.0 alias: imagealias1提取时前缀变量会被剥离只对变量之后的镜像名如renovate/renovate、mariadb执行依赖解析而replaceString与autoReplaceStringTemplate则完整保留前缀保证更新 PR 时依旧使用 Dependency Proxy 变量路径进行原位替换${CI_DEPENDENCY_PROXY_GROUP_IMAGE_PREFIX}/{{depName}}{{#if newValue}}:{{newValue}}{{/if}}...。包含变量且未配置别名的镜像会被跳过如果镜像引用中包含变量但该变量既不属于 Dependency Proxy 前缀也没有在registryAliases中配置Renovate 无法确定镜像的真实仓库地址会将该依赖标记为skipReason: contains-variable并跳过更新。以 lib/modules/manager/gitlabci/fixtures/gitlab-ci.7.yaml 为例image: name: $VARIABLE/renovate/renovate:31.65.1-slim services: - name: $VARIABLE/other/image1:1.0.0 alias: imagealias1 - name: ${VARIABLE}/other/image1:2.0.0 alias: imagealias2 - name: docker.io/$VARIABLE/image1:3.0.0 alias: imagealias1 - name: docker.io/${VARIABLE}/image1:4.0.0 alias: imagealias2对应的测试 extract.spec.ts 断言上述五个依赖均以skipReason: contains-variable返回。因此如果你的gitlab-ci.yml大量使用自定义变量$VARIABLE、${VARIABLE}或docker.io/$VARIABLE等形式请务必通过registryAliases补齐这些变量的真实值否则对应的镜像将永远得不到版本更新。组件component引用的版本提取除 Docker 镜像外该管理器还会从include: - component: fqdn/path/nameversion中提取 CI/CD 组件依赖使用gitlab-tags数据源与semver-partial版本格式depType为repository。解析逻辑位于 extract.ts通过正则将引用拆分为fqdn如gitlab.example.com、projectPath如an-org/a-project与specificVersion并将fqdn作为registryUrls。组件路径至少需要两级org/project否则会被视为格式错误而忽略。组件引用同样支持通过registryAliases替换其中的变量例如{ registryAliases: { $CI_SERVER_HOST: gitlab.example.com, $COMPONENT_REGISTRY: gitlab.example.com/a-group } }配置后include: - component: $CI_SERVER_HOST/an-org/a-project/a-component1.0会被解析为对an-org/a-project仓库的gitlab-tags依赖版本1.0详见测试 extract.spec.ts。组件版本支持 tag 名、分支名、提交 SHAe3262fdd...及~latest等特殊取值Renovate 会按semver-partial规则进行版本比较。配置示例汇总综合以上所有要点一份面向 GitLab CI 场景的完整 Renovate 配置示例如下{ registryAliases: { $CI_REGISTRY: registry.example.com, $CI_SERVER_FQDN: gitlab.example.com, $CI_SERVER_HOST: gitlab.example.com, ${CI_REGISTRY:-}: registry.example.com, $BUILD_IMAGES: registry.example.com/build-images, $COMPONENT_REGISTRY: gitlab.example.com/a-group } }配置要点回顾预定义变量必须显式配置CI_REGISTRY、CI_SERVER_FQDN、CI_SERVER_HOST等 GitLab 预定义变量需要通过registryAliases提供真实值否则包含这些变量的镜像会被标记contains-variable而跳过Dependency Proxy 变量无需配置CI_DEPENDENCY_PROXY_GROUP_IMAGE_PREFIX与CI_DEPENDENCY_PROXY_DIRECT_GROUP_IMAGE_PREFIX两个前缀变量由管理器原生识别默认值变量按原样书写使用${VAR:-}语法时别名键必须包含花括号与:-后缀两种拼接格式均可变量后带斜杠或不带斜杠都能解析别名值带不带结尾斜杠也兼容组件引用同样受益include: - component:中的变量也可通过registryAliases替换。通过以上配置Renovate 便能在你的gitlab-ci.yml中准确定位镜像与组件依赖、正确解析 GitLab 内部仓库地址并生成可原位替换的版本更新 PR。【免费下载链接】renovateHome of the Renovate CLI: Cross-platform Dependency Automation by Mend.io项目地址: https://gitcode.com/GitHub_Trending/re/renovate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Renovate 的 GitLab CI/CD 管理器：从 gitlab-ci.yml 提取 Docker 依赖与 registryAliases 配置指南
Renovate 的 GitLab CI/CD 管理器从 gitlab-ci.yml 提取 Docker 依赖与 registryAliases 配置指南【免费下载链接】renovateHome of the Renovate CLI: Cross-platform Dependency Automation by Mend.io项目地址: https://gitcode.com/GitHub_Trending/re/renovateRenovate 内置的 GitLab CI/CD 管理器代码位于 lib/modules/manager/gitlabci用于从gitlab-ci.yml文件中提取 Docker 镜像依赖并自动升级版本。本文以该管理器的官方文档与源码实现为主线系统讲解其支持的依赖形态、registryAliases的完整配置方法、GitLab 预定义变量与 Dependency Proxy 前缀变量的处理机制以及基于源码的底层解析流程帮助你正确配置 Renovate 以在 GitLab CI 场景下获得准确的版本更新。GitLab CI/CD 管理器概述Renovate 将 GitLab CI 归入ci类别模块的displayName为GitLab CI/CD。其默认行为仅扫描仓库根目录下匹配/\\.gitlab-ci\\.ya?ml$/的文件即.gitlab-ci.yml或.gitlab-ci.yaml该文件匹配规则定义在 lib/modules/manager/gitlabci/index.ts 的defaultConfig中export const defaultConfig { managerFilePatterns: [/\\.gitlab-ci\\.ya?ml$/], };管理器支持两种数据源见同一文件的supportedDatasourcesDockerDatasource用于image与services中的 Docker 镜像GitlabTagsDatasource用于 GitLab CI/CD 组件component引用。它能够识别四种依赖类型定义在 lib/modules/manager/gitlabci/dep-types.tsdepType含义image以字符串形式直接声明的 Docker 镜像如image: ruby:2.5.0image-name通过name属性声明的 Docker 镜像如image: { name: ... }service-image作为服务services使用的 Docker 镜像repositoryGitLab CI/CD 组件引用include: - component: ...从 gitlab-ci.yml 提取 Docker 依赖提取核心位于 lib/modules/manager/gitlabci/extract.ts 的extractPackageFile函数。它解析 YAML 后对每个顶层对象依次执行Job.parse与Jobs.parseschema 定义在 lib/modules/manager/gitlabci/schema.ts从而覆盖顶层image字段image: ruby:2.5.0字符串形式或image: { name: ... }对象形式顶层services字段字符串形式- mariadb:10.4.11或带name的对象形式可含alias、entrypoint、command等属性每个具名 Job 内部的image与services。对每个镜像会调用 lib/modules/manager/gitlabci/utils.ts 中的getGitlabDep生成依赖对象并依据dep-types.ts标记对应的depType。以 lib/modules/manager/gitlabci/fixtures/gitlab-ci.1.yaml 为例image: name: renovate/renovate:19.70.8-slim services: - mariadb:10.4.11 - other/image:1.0.0对应测试 lib/modules/manager/gitlabci/extract.spec.ts 验证了提取结果分别得到image-name类型依赖renovate/renovate19.70.8-slim与两个service-image类型依赖mariadb10.4.11、other/image1.0.0。此外extractAllPackageFiles还会递归处理include: - local: ...引用的本地文件解析每个文件中的本地 include 并加入待检查队列直至全部处理完毕见 extract.ts。测试中gitlab-ci.3.yaml连同其 include 的include.yml、include.1.yml共提取出 5 个依赖正是这一递归能力的验证。版本格式默认情况下镜像版本使用 Docker 版本格式进行解析与比较。如果需要调整版本格式例如改用semver、loose或其他 Renovate 支持的版本方案应查阅 Renovate 的版本化versioning文档docs/usage/modules/versioning/index.md并在 Renovate 配置中通过versioning字段覆盖对应依赖的版本规则。使用 registryAliases 解析 GitLab 预定义变量GitLab CI 会注入大量预定义变量例如CI_REGISTRY当前项目的 Container Registry 地址、CI_SERVER_FQDN、CI_SERVER_HOST等。当gitlab-ci.yml中的镜像引用使用了这些变量时Renovate 无法直接得知变量在运行时展开后的真实值因而无法定位到正确的镜像仓库。解决方式是在 Renovate 配置中通过registryAliases为这些变量提供显式的别名值{ registryAliases: { $CI_REGISTRY: registry.example.com, $CI_SERVER_FQDN: gitlab.example.com, $CI_SERVER_HOST: gitlab.example.com } }配置后Renovate 在提取依赖时会把depName中的变量前缀替换为别名值用于解析镜像的真实仓库地址同时保留原始replaceString如$CI_REGISTRY/renovate/renovate:31.65.1-slim与autoReplaceStringTemplate从而在生成 PR 时依然以变量形式原位更新版本而不是把变量写死为具体地址。这一点在测试 extract.spec.ts 中有完整印证当配置$CI_REGISTRY: registry.com、$BUILD_IMAGES: registry.com/build-images后镜像$CI_REGISTRY/renovate/renovate:31.65.1-slim的depName保持为$CI_REGISTRY/renovate/renovate而packageName被解析为registry.com/renovate/renovateautoReplaceStringTemplate则保留了$CI_REGISTRY/前缀用于原位替换。带默认值的变量:-语法GitLab CI 变量支持默认值语法:-例如${CI_REGISTRY:-}表示若CI_REGISTRY未定义则使用空值。Renovate 同样支持在registryAliases中配置这类变量{ registryAliases: { ${CI_REGISTRY:-}: registry.example.com } }注意这里的键必须包含花括号与:-后缀与gitlab-ci.yml中的实际写法保持一致Renovate 才能精确匹配。变量后跟镜像名的两种写法配置好别名后${CI_REGISTRY:-}之后无论是带斜杠还是不带斜杠的镜像引用格式都能被正确解析带斜杠${CI_REGISTRY:-}/image:1.0不带斜杠${CI_REGISTRY:-}image:1.0同时别名值本身带不带结尾斜杠均可正常工作——Renovate 会在拼接时自动兼容这两种写法。换言之${CI_REGISTRY:-}: registry.example.com与${CI_REGISTRY:-}: registry.example.com/都能得到相同的结果。支持 GitLab Dependency Proxy 预定义前缀变量如果你使用了 GitLab Dependency Proxy依赖代理功能可以直接用其预定义变量作为镜像前缀无需任何额外配置。Renovate 在 utils.ts 中通过正则\$\\{?CI_DEPENDENCY_PROXY_(?:DIRECT_)?GROUP_IMAGE_PREFIX\\}?/识别以下两个变量CI_DEPENDENCY_PROXY_GROUP_IMAGE_PREFIXCI_DEPENDENCY_PROXY_DIRECT_GROUP_IMAGE_PREFIX使用示例来自 extract.spec.ts 的测试image: name: ${CI_DEPENDENCY_PROXY_GROUP_IMAGE_PREFIX}/renovate/renovate:31.65.1-slim services: - $CI_DEPENDENCY_PROXY_DIRECT_GROUP_IMAGE_PREFIX/mariadb:10.4.11 - name: $CI_DEPENDENCY_PROXY_GROUP_IMAGE_PREFIX/other/image1:1.0.0 alias: imagealias1提取时前缀变量会被剥离只对变量之后的镜像名如renovate/renovate、mariadb执行依赖解析而replaceString与autoReplaceStringTemplate则完整保留前缀保证更新 PR 时依旧使用 Dependency Proxy 变量路径进行原位替换${CI_DEPENDENCY_PROXY_GROUP_IMAGE_PREFIX}/{{depName}}{{#if newValue}}:{{newValue}}{{/if}}...。包含变量且未配置别名的镜像会被跳过如果镜像引用中包含变量但该变量既不属于 Dependency Proxy 前缀也没有在registryAliases中配置Renovate 无法确定镜像的真实仓库地址会将该依赖标记为skipReason: contains-variable并跳过更新。以 lib/modules/manager/gitlabci/fixtures/gitlab-ci.7.yaml 为例image: name: $VARIABLE/renovate/renovate:31.65.1-slim services: - name: $VARIABLE/other/image1:1.0.0 alias: imagealias1 - name: ${VARIABLE}/other/image1:2.0.0 alias: imagealias2 - name: docker.io/$VARIABLE/image1:3.0.0 alias: imagealias1 - name: docker.io/${VARIABLE}/image1:4.0.0 alias: imagealias2对应的测试 extract.spec.ts 断言上述五个依赖均以skipReason: contains-variable返回。因此如果你的gitlab-ci.yml大量使用自定义变量$VARIABLE、${VARIABLE}或docker.io/$VARIABLE等形式请务必通过registryAliases补齐这些变量的真实值否则对应的镜像将永远得不到版本更新。组件component引用的版本提取除 Docker 镜像外该管理器还会从include: - component: fqdn/path/nameversion中提取 CI/CD 组件依赖使用gitlab-tags数据源与semver-partial版本格式depType为repository。解析逻辑位于 extract.ts通过正则将引用拆分为fqdn如gitlab.example.com、projectPath如an-org/a-project与specificVersion并将fqdn作为registryUrls。组件路径至少需要两级org/project否则会被视为格式错误而忽略。组件引用同样支持通过registryAliases替换其中的变量例如{ registryAliases: { $CI_SERVER_HOST: gitlab.example.com, $COMPONENT_REGISTRY: gitlab.example.com/a-group } }配置后include: - component: $CI_SERVER_HOST/an-org/a-project/a-component1.0会被解析为对an-org/a-project仓库的gitlab-tags依赖版本1.0详见测试 extract.spec.ts。组件版本支持 tag 名、分支名、提交 SHAe3262fdd...及~latest等特殊取值Renovate 会按semver-partial规则进行版本比较。配置示例汇总综合以上所有要点一份面向 GitLab CI 场景的完整 Renovate 配置示例如下{ registryAliases: { $CI_REGISTRY: registry.example.com, $CI_SERVER_FQDN: gitlab.example.com, $CI_SERVER_HOST: gitlab.example.com, ${CI_REGISTRY:-}: registry.example.com, $BUILD_IMAGES: registry.example.com/build-images, $COMPONENT_REGISTRY: gitlab.example.com/a-group } }配置要点回顾预定义变量必须显式配置CI_REGISTRY、CI_SERVER_FQDN、CI_SERVER_HOST等 GitLab 预定义变量需要通过registryAliases提供真实值否则包含这些变量的镜像会被标记contains-variable而跳过Dependency Proxy 变量无需配置CI_DEPENDENCY_PROXY_GROUP_IMAGE_PREFIX与CI_DEPENDENCY_PROXY_DIRECT_GROUP_IMAGE_PREFIX两个前缀变量由管理器原生识别默认值变量按原样书写使用${VAR:-}语法时别名键必须包含花括号与:-后缀两种拼接格式均可变量后带斜杠或不带斜杠都能解析别名值带不带结尾斜杠也兼容组件引用同样受益include: - component:中的变量也可通过registryAliases替换。通过以上配置Renovate 便能在你的gitlab-ci.yml中准确定位镜像与组件依赖、正确解析 GitLab 内部仓库地址并生成可原位替换的版本更新 PR。【免费下载链接】renovateHome of the Renovate CLI: Cross-platform Dependency Automation by Mend.io项目地址: https://gitcode.com/GitHub_Trending/re/renovate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考