GitLab托管CI Runner配置allowed_pull_policies问题求助

关于config.toml的适用范围 #

没错，config.toml仅适用于自托管/手动部署的GitLab Runner。GitLab.com提供的共享托管Runner由官方统一管理，用户无法通过仓库根目录的config.toml修改其配置——这个文件根本不会被托管Runner读取，所以你添加后报错依旧。

替代解决办法 #

1. 改用自托管Runner #

自己部署一个Runner，在其config.toml中配置allowed_pull_policies = ["always", "if-not-present"]，之后就能在.gitlab-ci.yml中正常使用if-not-present拉取策略。这是唯一能直接启用该策略的方式，完全可控。

2. 优化镜像拉取效率的替代方案 #

如果不想部署自托管Runner，可通过以下方式减少拉取耗时：

• 使用固定版本标签而非latest：latest标签会触发频繁拉取验证，换成固定版本（比如v1.2.3），托管Runner会自动缓存该镜像，后续作业优先使用缓存。
• 依赖GitLab自动缓存：GitLab.com的托管Runner会缓存近期使用过的镜像，只要镜像标签不变，多数情况下不会重复拉取完整镜像。
• 继续使用GitLab容器注册表：你的镜像已经存储在registry.gitlab.com，托管Runner拉取同区域的镜像速度远快于外部仓库，能大幅降低拉取耗时。

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