drevops/ci-runner

CI运行容器Docker镜像

概述

本镜像基于Debian php:8.4-cli-bookworm构建，作为CI（持续集成）环境的运行容器，集成了多种开发工具和CI/CD必备组件，可直接用于执行代码构建、测试、部署等持续集成流程任务。

核心功能与特性

基础镜像

• 基于 Debian php:8.4-cli-bookworm

集成工具与版本

• aspell：3.1.20
• https://github.com/bats-core/bats-core：`1.12.0`
• https://getcomposer.org：`2.8.12`
• https://codecov.io：`0.8.0`
• curl：7.88.1
• https://www.docker.com：`28.5.1`
• https://github.com/docker/buildx：`0.29.1`
• https://docs.docker.com/compose：`2.40.1`
• https://git-scm.com：`2.39.5`
• https://gnupg.org：`2.2.40`
• https://jqlang.github.io/jq：`1.6`
• https://github.com/SimonKagstrom/kcov：`43`
• https://github.com/lsof-org/lsof：`4.95.0`
• https://lynx.invisible-island.net：`2.9.0`
• https://nodejs.org：`23.11.1`
• https://www.npmjs.com：`10.9.2`
• https://www.npmjs.com/package/npx：`10.9.2`
• https://www.php.net：`8.4.13`
• https://rsync.samba.org：`3.2.7`
• ShellCheck：0.11.0
• https://github.com/mvdan/sh：`3.12.0`
• OpenSSH：9.2
• http://mama.indstate.edu/users/ice/tree：`2.1.0`
• UnZip：6.00
• https://www.vim.org：`9.0`
• https://yarnpkg.com：`1.22.22`
• Zip：3.0

使用场景与适用范围

适用于GitHub Actions、GitLab CI、Jenkins等各类持续集成平台，支持PHP、Node.js等多语言项目的代码检查、依赖管理、单元测试、集成测试、镜像构建等CI/CD流程。

使用方法

镜像标签规范

使用时请务必固定版本标签：

drevops/ci-runner:25.1.0

测试环境可使用canary标签：

drevops/ci-runner:canary

GitHub Actions配置示例

在GitHub Actions中使用时，需修复被覆盖的$HOME环境变量：

yaml
name: Test

jobs:
  test:
    runs-on: ubuntu-latest

    container:
      image: docker.xuanyuan.run/drevops/ci-runner:25.8.0

    steps:
      - name: 保留容器中设置的$HOME
        run: echo HOME=/root >> "$GITHUB_ENV" # https://github.com/actions/runner/issues/863

      - name: 检出代码
        uses: actions/checkout@v5

测试

本镜像集成https://github.com/aelsabbahy/goss用于环境测试，可通过dgoss在本地执行测试：

bash
# 构建测试镜像
docker build -t drevops/ci-runner:test-ci .

# 运行测试
dgoss run -i drevops/ci-runner:test-ci

ARM64系统（如Apple Silicon）适配：需安装对应架构的goss二进制文件：

bash
# 创建本地二进制目录
mkdir -p ~/bin

# 下载macOS ARM64 goss（本地使用）
curl -L "https://github.com/aelsabbahy/goss/releases/latest/download/goss-darwin-arm64" -o ~/bin/goss
chmod +x ~/bin/goss

# 下载Linux AMD64 goss（容器测试用）
curl -L "https://github.com/aelsabbahy/goss/releases/latest/download/goss-linux-amd64" -o ~/bin/goss-linux-amd64
chmod +x ~/bin/goss-linux-amd64

# 下载dgoss工具
curl -L "https://github.com/aelsabbahy/goss/releases/latest/download/dgoss" -o ~/bin/dgoss
chmod +x ~/bin/dgoss

# 指定goss路径并运行测试
export GOSS_PATH=~/bin/goss-linux-amd64
~/bin/dgoss run -i drevops/ci-runner:test-ci

维护与发布

版本控制

采用年-月-补丁版本格式：

• YY：年份后两位（如2023年为23）
• m：数字月份（如4月为4）
• patch：当月补丁号（从0开始）
  示例：23.4.2表示2023年4月第3个补丁版本

发布策略

• 定期发布：每月至少一次
• 标签规则：
  • YY.m.patch：GitHub发布标签时生成
  • latest：同步GitHub发布标签
  • canary：每次推送到main分支时自动构建

依赖更新

通过Renovate机器人自动更新依赖，创建PR并在CI通过后自动合并，变更将发布为canary版本。

本仓库使用Scaffold项目模板创建