# gitlab-runner使用docker执行器，无法获取本地镜像。

**URL:** <https://forum.beginner.center/t/topic/2893>\
**Category:** 🛠工具与编程\
**Tags:** docker, gitlab\
**Created:** [2026 年6 月 2 日 11:17 UTC](https://forum.beginner.center/t/topic/2893 "2026-06-02T11:17:16Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

作者： ![doggie](https://forum.beginner.center/user_avatar/forum.beginner.center/doggie/32/550_2.png) [@doggie](https://forum.beginner.center/u/doggie)\
发布日期： [2026 年6 月 2 日 11:17 UTC](https://forum.beginner.center/t/topic/2893/1 "2026-06-02T11:17:16Z")

</div>

> 本文由 [简悦 SimpRead](http://ksria.com/simpread/) 转码， 原文地址 [www.jianshu.com](https://www.jianshu.com/p/2b7e73b0a096)

```
 使用 gitlab-ci 进行持续集成的时候，要注册一个 gitlab-runner，注册 gitlab-runner 又要指定一个执行器。执行器有那么几种：

```

 ![](https://discoursecdn.beginner.center/original/2X/e/ef071a8d3bee3812dc492c5b18778f53d4c289a5.webp) 1

这其中，比较简单常用的就是 shell 执行器，往上有很多资料，这里不再重复。而 docker 执行器是一个相对用的比较少的执行器，因为 docker 执行器要和 docker 配合使用，因此用的人比较少吧。

## **现象：**

仿造官方文档上的写法，在. gitlab.yml 文件中指定一个镜像文件，用以编译和运行我们的项目，如图：

 ![](https://discoursecdn.beginner.center/original/2X/4/4a957d26f86a4cccc5496f3b590ccefb34e97a5e.webp) 2

这个写法的本意是想使用本地的镜像，mytomcat:v1

 ![](https://discoursecdn.beginner.center/original/2X/d/d5b47e3f67a21ec72fb2c88833eabfa421f1384f.webp) 3

作为编译和运行我们的项目的镜像。但是这个时候进行持续集成的话会报一个错：

 ![](https://discoursecdn.beginner.center/original/2X/0/01f21e5e14273dfde4bda19191d714e24a4f7baa.webp) 4

当 pipeline 开始的时候，gitlab-runner 没有用本地已经存在的 mytomcat:v1 这个镜像，而是直接去 docker 中央仓库 pull 这个镜像，这自然是找不到的，所以就报错了。这是为什么呢？

## **解释及解决方法**

**1. 解释**

```
    这是 docker 执行器的 pull policy 导致的，这个 pull policy 的文档在官方文档上排的比较靠后，甚至有点不起眼，这一点是很坑的，明明是跟着官方文档做，但是却是错了，还错得莫名其妙的。

```

 ![](https://discoursecdn.beginner.center/original/2X/b/b2f4c8021cc66139a6a51c896f99dc0e1bdbf341.webp) 5

可以点进去看一下：

 ![](https://discoursecdn.beginner.center/original/2X/8/8d09d5cecc83a7824545943c1ff4578c577ed1ec.webp) 6

这就很明显了，如果你想要指定本地镜像的话，那就要制定 pull policy，否则默认设置 pull\_policy=“always”，意味着 gitlab-runner 每次都要去 docker 中央仓库拉 image 关键字指明的镜像，这也就是这个问题的解释了。

**2. 解决方法**

制定 pull policy，再重启 gitlab-runner 就好了。如图：

 ![](https://discoursecdn.beginner.center/original/2X/b/b651d1e126a85e5c09e55506e8d94c469c0b7e34.webp) 6

**3. 结果**

 ![](https://discoursecdn.beginner.center/original/2X/0/0d7b7aa28a6a02fd2be1ebbfe9770fea4ae59b0c.webp) 7

pull policy 生效，使用的是本地的镜像。
