自托管Docker runner调用私有镜像执行构建的实现方案咨询

你当前遇到的报错是GitHub Actions容器执行模式的逻辑冲突导致的：当你在job中配置container字段时，GitHub runner会默认调用本地的docker命令拉取指定镜像、启动执行容器，而你当前的自托管runner本身运行在Docker容器内，内层runner容器没有预装Docker引擎，因此无法完成调用。

以下是三种可落地的实现方案，可根据你的部署场景选择：

方案1：将自托管runner直接部署在宿主机（推荐，改动最小） #

该方案不需要修改现有工作流的核心逻辑，只调整runner部署逻辑即可：

• 在准备运行runner的物理机/虚拟机上预先安装Docker Engine，确保docker命令全局可用
• 按照GitHub自托管runner部署流程，将runner直接安装在宿主机上，保留原有docker-runner标签
• 私有镜像拉取需要额外补充凭证配置，修改后的工作流参考如下：

name: CI with Docker

on:
  push:
    branches: [ master ]
  pull_request:
    branches: [ master ]

jobs:
  build:
    runs-on: docker-runner
    container:
      image: ubuntu:npm-1 # 替换为你的私有镜像完整地址
      # 新增私有镜像拉取凭证，凭证提前存入GitHub Secrets即可
      credentials:
        username: ${{ secrets.DOCKER_REGISTRY_USER }}
        password: ${{ secrets.DOCKER_REGISTRY_PWD }}

    steps:
    - uses: actions/checkout@v4
    - name: Build
      run: npm install

方案2：保留runner容器化部署，启用Docker in Docker能力 #

如果你必须将runner本身运行在Docker容器中，可通过两种方式让内层runner获得docker调用能力：

• 挂载宿主机Docker套接字：启动runner容器时新增参数 -v /var/run/docker.sock:/var/run/docker.sock，直接复用宿主机的Docker引擎，不需要在内层容器单独安装Docker
• 重制runner镜像：基于官方自托管runner基础镜像，在Dockerfile中新增Docker Engine安装步骤，打包后重新部署runner
  上述两种方式完成后，搭配方案1中的工作流配置即可正常运行。

方案3：弃用内置container字段，手动执行容器构建 #

如果不想调整runner部署逻辑，也可以放弃GitHub Actions自带的容器调度能力，手动在步骤中调用docker执行构建：

name: CI with Docker

on:
  push:
    branches: [ master ]
  pull_request:
    branches: [ master ]

jobs:
  build:
    runs-on: docker-runner
    steps:
    - uses: actions/checkout@v4
    - name: 登录私有镜像仓库
      run: docker login -u ${{ secrets.DOCKER_REGISTRY_USER }} -p ${{ secrets.DOCKER_REGISTRY_PWD }} 你的私有镜像仓库域名
    - name: 执行构建
      run: docker run --rm -v $(pwd):/workspace ubuntu:npm-1 sh -c "cd /workspace && npm install"

该方案仅要求runner环境可正常调用docker命令即可。

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