interaction/github-actions-runner

GitHub Actions Runner 镜像

镜像概述和主要用途

该镜像基于https://github.com/myoung34/docker-github-actions-runner扩展，主要用于提供可横向扩展的GitHub Actions Runner环境。通过支持docker-compose的扩展功能，可根据需求动态调整Runner数量，满足不同规模的CI/CD工作流需求。

核心功能和特性

• 扩展支持：可通过docker-compose up --scale SERVICE=NUM命令或compose file v2的scale选项实现Runner数量的动态扩展
• 功能继承：完整继承基础镜像https://github.com/myoung34/docker-github-actions-runner的所有功能特性
• 持久化配置：支持工作目录挂载，确保工作流数据持久化
• Docker集成：可访问宿主机Docker服务，支持需要Docker环境的工作流

使用场景和适用范围

• 组织级或项目级GitHub Actions工作流需要多个Runner并行处理任务
• 需要根据工作负载动态调整Runner数量的场景
• 对CI/CD环境弹性伸缩有需求的团队或项目

使用方法和配置说明

Docker Compose配置示例

以下是支持扩展的docker-compose配置示例：

yaml
version: '2.4'

services:
  github-actions:
    environment:
      ACCESS_TOKEN: ${GITHUB_ACTIONS_ACCESS_TOKEN}  # GitHub访问令牌
      ORG_NAME: ${GITHUB_ACTIONS_ORG_NAME}          # GitHub组织名称
      ORG_RUNNER: 'true'                            # 是否为组织级Runner
      RUNNER_NAME: ${GITHUB_ACTIONS_RUNNER_NAME}    # Runner名称
      RUNNER_WORKDIR: ${PWD}/_work                  # 工作目录
    image: docker.xuanyuan.run/interaction/github-actions-runner
    restart: always
    scale: ${GITHUB_ACTIONS_SCALE:-2}               # 初始扩展数量，默认2个
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock   # 挂载Docker socket
      - ${PWD}/_work:${PWD}/_work                  # 挂载工作目录

环境变量说明

扩展Runner数量

1. 通过compose文件设置初始数量：

   yaml
   scale: 3  # 初始启动3个Runner
   

2. 通过命令动态调整数量：

   bash
   docker-compose up --scale github-actions=5 -d  # 将Runner数量扩展到5个
   

卷挂载说明

• /var/run/docker.sock:/var/run/docker.sock：允许Runner内部访问宿主机Docker服务，支持需要Docker环境的工作流
• ${PWD}/_work:${PWD}/_work：挂载工作目录，确保工作流数据持久化