这次记录一个节后恢复发布前遇到的 CI 问题。

5 月 5 日晚上想提前跑一遍流水线，结果 job 没进到测试阶段，runner 日志先停在这里：

```text
Pulling docker image node:20-alpine ...
ERROR: Job failed: failed to pull image "node:20-alpine": context deadline exceeded
```

一开始我以为是依赖安装慢，后来发现 `npm ci` 根本还没执行。问题在 runner 启动构建容器这一步。

## 先确认失败位置

我把流水线分成几段看：

| 阶段 | 检查点 |
|---|---|
| runner 启动 | `.gitlab-ci.yml` 里的 `image` |
| service 启动 | redis、postgres 等依赖容器 |
| 构建测试 | `npm ci`、`go test` |
| Docker build | Dockerfile 里的 `FROM` |
| K8s 部署 | Pod 事件里的 `ImagePullBackOff` |

当前失败在第一段，所以没有继续看代码和测试。

## 把镜像逐个拉一遍

这次涉及到几类镜像：

```text
node:20-alpine
python:3.12-slim
redis:7-alpine
postgres:16-alpine
your-org/release-helper:2026.05.05
pause:3.10
```

我在 runner 同一网络里做了一次预检：

```bash
docker pull docker.1ms.run/node:20-alpine
docker pull docker.1ms.run/python:3.12-slim
docker pull docker.1ms.run/redis:7-alpine
docker pull docker.1ms.run/postgres:16-alpine
docker pull ghcr.1ms.run/your-org/release-helper:2026.05.05
docker pull k8s.1ms.run/pause:3.10
```

这里的 `your-org/release-helper` 只是示例，实际要换成自己的工具镜像。

## 放到 preflight 阶段

后面我加了一个单独的 preflight job：

```yaml
stages:
  - preflight
  - test
  - build
  - deploy

image_preflight:
  stage: preflight
  image: docker.1ms.run/docker:27-cli
  services:
    - name: docker.1ms.run/docker:27-dind
      command: ["--registry-mirror=https://docker.1ms.run"]
  script:
    - docker pull docker.1ms.run/node:20-alpine
    - docker pull docker.1ms.run/python:3.12-slim
    - docker pull docker.1ms.run/redis:7-alpine
    - docker pull docker.1ms.run/postgres:16-alpine
    - docker pull ghcr.1ms.run/your-org/release-helper:2026.05.05
```

这样失败会提前出现在 preflight 阶段，不会和后面的测试、构建混在一起。

## K8s 节点还要单独测

runner 能拉，不代表部署节点能拉。目标集群用的是 containerd，所以我又在节点上测了一遍：

```bash
crictl pull docker.1ms.run/nginx:stable-alpine
crictl pull k8s.1ms.run/pause:3.10
crictl images | grep -E "nginx|pause"
```

这一步主要排除节点 DNS、containerd 配置、私有镜像凭证和磁盘空间问题。

## 记录

这次的经验是：流水线失败时先看日志停在哪一段。

如果还停在 `Pulling docker image`，就先处理镜像链路。等镜像预检通过，再看依赖安装、测试、构建和部署，排查顺序会清楚很多。

5 月 5 日晚上想提前跑一遍流水线，结果 job 没进到测试阶段，runner 日志先停在这里：

节后复现 CI runner 拉镜像超时记录

开发工具

运维

CI/CD流水线构建失败时，先定位失败阶段，优先解决镜像拉取问题。通过预检镜像链路、区分runner和K8s节点环境，可快速排查Docker镜像拉取超时等常见问题。建议在流水线中增加preflight阶段提前验证依赖镜像可用性。

容器

Docker

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

节后复现 CI runner 拉镜像超时记录-腾讯云开发者社区-腾讯云

节后复现 CI runner 拉镜像超时记录

节后复现 CI runner 拉镜像超时记录

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐