Docker GitHub Actions Runner

![Docker Pulls]([] ![awesome-runners]([]

此镜像用于运行新的自托管GitHub Actions Runner，支持Docker-in-Docker功能，可在自定义基础设施上执行GitHub Actions工作流，提供灵活的配置选项和多平台支持。

快速开始（示例与用法）

详细使用说明请参见Wiki。 贡献前请阅读贡献指南。

包含的软件与配置

尽管本项目与上游软件并非完全一致，但包含的软件包等信息可在此处查看。相关文档请参见Wiki。

注意事项

安全性

已知环境变量存在被窃取的风险。如果使用此Runner，请确保所有工作流变更都通过验证流程（在Actions设置中）进行管控，以防止恶意PR窃取这些变量。

Docker支持

请注意，尽管此Runner安装并允许使用Docker，但GitHub Actions本身尚不支持在自托管Runner中使用Docker。更多信息：

• [***]
• [***]

此外，部分GitHub Actions工作流功能（如Job Services）无法使用，会导致错误。

Containerd支持

当前Runner不支持containerd。

Docker制品

这些容器通过GitHub Actions构建，复制Dockerfile并修改FROM指令以简化构建过程。

环境变量

测试

测试使用goss编写通用断言。所有拉取请求需包含相关断言才能合并。

前提条件：确保已安装docker、goss和dgoss。注意：虽然本地测试可行，但GitHub Actions会测试所有操作系统变体和支持的架构。

测试文件期望待测试镜像通过环境变量GH_RUNNER_IMAGE指定，以辅助CI。

测试步骤：

$ # 需设置goss测试插值的最小变量
$ echo "os: ubuntu" >goss_vars.yaml
$ echo "oscodename: focal" >>goss_vars.yaml
$ echo "arch: x86_64" >>goss_vars.yaml
$ docker build -t my-base-test -f Dockerfile.base .
$ # 在最终镜像中使用基础镜像
$ sed -i.bak 's/^FROM.*/FROM my-base-test/g' Dockerfile
$ docker build -t my-full-test -f Dockerfile .
$ # 在当前git HEAD上测试Dockerfile.base的完整测试
$ GOSS_VARS=goss_vars.yaml GOSS_FILE=goss_full.yaml GOSS_SLEEP=1 dgoss run --entrypoint /usr/bin/sleep \
  -e DEBUG_ONLY=true \
  -e RUNNER_NAME=huzzah \
  -e REPO_URL=[***] \
  -e RUN_AS_ROOT=true \
  -e RUNNER_NAME_PREFIX=asdf \
  -e ACCESS_TOKEN=1234 \
  -e APP_ID=5678 \
  -e APP_PRIVATE_KEY=2345 \
  -e APP_LOGIN=SOMETHING \
  -e RUNNER_SCOPE=org \
  -e ORG_NAME=myoung34 \
  -e ENTERPRISE_NAME=emyoung34 \
  -e LABELS=blue,green \
  -e RUNNER_TOKEN=3456 \
  -e RUNNER_WORKDIR=/tmp/a \
  -e RUNNER_GROUP=wat \
  -e GITHUB_HOST=github.example.com \
  -e DISABLE_AUTOMATIC_DEREGISTRATION=true \
  -e EPHEMERAL=true \
  -e DISABLE_AUTO_UPDATE=true \
  my-full-test 10