ghrunner/actions-runner

ghrunner/actions-runner 镜像说明

镜像概述

本镜像提供了GitHub Actions的容器化运行环境，允许用户在自有基础设施上部署runner节点，无缝对接GitHub平台的工作流机制，实现代码的自动化构建、测试和部署等CI/CD流程。

核心功能

• 与GitHub Actions平台深度集成，支持执行仓库中定义的工作流任务
• 容器化部署，便于快速扩展和管理runner节点
• 支持自定义运行环境配置，适配不同项目的依赖需求
• 自动注册与注销机制，简化runner节点的生命周期管理

使用场景

• 企业内部私有CI/CD环境构建，满足数据安全与合规要求
• 需要特定硬件资源（如GPU、高内存）的工作流执行
• 自定义运行环境（如特定版本的语言、工具链）的工作流需求
• 分散式CI/CD任务执行，提升构建效率

配置说明

需配置以下关键环境变量：

• GITHUB_REPOSITORY：目标GitHub仓库地址（格式：owner/repo）
• REGISTRATION_TOKEN：从GitHub仓库获取的runner注册令牌（可在仓库设置→Actions→Runners中生成）
• RUNNER_NAME（可选）：自定义runner名称
• RUNNER_LABELS（可选）：为runner添加标签，用于工作流的节点选择

部署示例

Docker Run命令

bash
docker run -d --name github-runner \
  -e GITHUB_REPOSITORY="your-owner/your-repo" \
  -e REGISTRATION_TOKEN="your-registration-token" \
  -e RUNNER_NAME="my-custom-runner" \
  -e RUNNER_LABELS="linux,x64,my-label" \
  ghrunner/actions-runner

Docker Compose示例

yaml
version: '3'
services:
  github-runner:
    image: ghrunner/actions-runner
    environment:
      - GITHUB_REPOSITORY=your-owner/your-repo
      - REGISTRATION_TOKEN=your-registration-token
      - RUNNER_NAME=my-compose-runner
      - RUNNER_LABELS=linux,x64,compose
    restart: always

注意：注册令牌具有时效性，请及时更新；runner节点需确保能访问GitHub平台的网络连通性。