这明显是架构不兼容导致的问题——树莓派是arm32v7架构，而GitLab Runner默认使用的helper镜像是为amd64（x86）架构构建的，K8s没法在arm节点上运行amd64镜像，所以Pod一直卡在Pending状态。

下面是具体的解决步骤：

1. 先确认问题根源 #

用K8s命令查看Pod的详细事件，验证是不是镜像拉取/架构不匹配的问题：

kubectl describe pod runner-123-project-456-concurrent-789 -n gitlab

在Events区域你应该会看到类似Failed to pull image "gitlab/gitlab-runner-helper:xxxx": rpc error: code = Unknown desc = failed to pull and unpack image...或者明确的架构不兼容提示。

2. 指定arm32v7适配的Helper镜像 #

GitLab官方提供了arm架构的helper镜像，你需要在Runner配置里指定对应版本的arm32v7镜像。你的Runner版本是10.4.0（哈希值857480b6），对应的镜像地址是：

registry.gitlab.com/gitlab-org/gitlab-runner/gitlab-runner-helper:arm32v7-857480b6

3. 修改Runner配置（K8s部署场景） #

如果你的GitLab Runner是通过Kubernetes Deployment部署的，修改Deployment的yaml文件，添加环境变量指定helper镜像：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: hello-world-gitlab-runner
  namespace: gitlab
spec:
  template:
    spec:
      containers:
      - name: gitlab-runner
        image: arm32v7/gitlab-runner:10.4.0
        env:
        - name: HELPER_IMAGE
          value: "registry.gitlab.com/gitlab-org/gitlab-runner/gitlab-runner-helper:arm32v7-857480b6"
        # 保留其他原有配置...

如果是直接使用config.toml配置Runner，在[[runners]]区块下添加：

[[runners]]
  name = "hello-world-gitlab-runner"
  executor = "kubernetes"
  helper_image = "registry.gitlab.com/gitlab-org/gitlab-runner/gitlab-runner-helper:arm32v7-857480b6"
  # 保留其他原有配置...

4. 应用配置并验证 #

修改完成后重新部署Runner：

kubectl apply -f your-runner-deployment.yaml -n gitlab

然后重新触发GitLab流水线，观察Pod状态，应该能正常进入Running状态，不再卡在Pending。

注意：helper镜像的标签必须和你的GitLab Runner版本完全匹配（包括后面的哈希值），不然可能出现兼容性问题。后续如果升级Runner版本，记得同步更新helper镜像的标签。

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