midokura/actions-runner-dind

GitHub Runner 镜像

镜像概述

本镜像基于 summerwind/actions-runner-dind 构建，是用于 GitHub Actions 的自托管运行器（self-hosted runner）。它在基础镜像基础上升级了 Docker、Kubectl 及部分常用工具，提供更完善的环境支持，适用于需要自定义运行环境的 GitHub Actions 自动化任务。

核心功能与特性

• 基础继承：保留 summerwind/actions-runner-dind 的核心能力，支持 Docker-in-Docker (DinD) 模式
• 组件升级：内置升级后的 Docker 引擎和 Kubectl 工具，满足最新版本依赖需求
• 工具扩展：包含部分常用辅助工具，增强任务执行能力
• 兼容性：与 GitHub Actions 官方 runner 接口兼容，可无缝集成到现有工作流

使用场景

• 需要在 GitHub Actions 中使用特定版本 Docker 或 Kubectl 的 CI/CD 流程
• 需执行容器化应用构建、测试、部署的自动化任务
• 对运行环境有自定义工具需求的 GitHub Actions 工作流

使用方法

基本部署（Docker Run）

启动 runner 并注册到目标 GitHub 仓库：

bash
docker run -d \
  --name github-runner \
  --privileged \
  -e GH_TOKEN=<your-github-personal-access-token> \
  -e REPO_URL=https://github.com/<owner>/<repo> \
  -v /var/run/docker.sock:/var/run/docker.sock \
  <image-name>:<tag>

参数说明：

• --privileged：启用特权模式，支持 DinD 功能
• -e GH_TOKEN：GitHub 个人访问令牌（需具备 repo 权限）
• -e REPO_URL：目标 GitHub 仓库 URL
• -v /var/run/docker.sock:/var/run/docker.sock：挂载 Docker 套接字（可选，根据 DinD 配置需求）

环境变量配置

支持以下常用环境变量：

Docker Compose 示例

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  github-runner:
    image: <image-name>:<tag>
    privileged: true
    environment:
      - GH_TOKEN=<your-github-personal-access-token>
      - REPO_URL=https://github.com/<owner>/<repo>
      - RUNNER_NAME=my-dind-runner
      - RUNNER_LABELS=docker,kubectl
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

注意事项

• 确保 GitHub 个人访问令牌（GH_TOKEN）具备 repo 范围权限
• 特权模式可能带来安全风险，生产环境中需评估使用场景
• DinD 模式下需确保容器内 Docker 版本与宿主机版本兼容，避免版本冲突