Dockette / CI 中文技术文档

镜像概述与主要用途

Dockette/CI 是基于 Alpine Linux 的轻量级持续集成 (CI) Docker 镜像集合，提供多版本 PHP 和 Node.js 运行环境，旨在为 CI/CD 流程提供标准化、高效的执行环境。该镜像支持 PHP 5.6 至 8.0 版本及 Node.js 6 至 15 版本，适用于各类应用的自动化测试、构建与部署流程。

核心功能与特性

多版本支持

• PHP：覆盖 5.6、7.0、7.1、7.2、7.3、7.4、8.0 版本，满足不同项目的兼容性需求。
• Node.js：覆盖 6、7、8、9、10、11、12、13、14、15 版本，支持 legacy 项目与现代应用。

轻量级基础

基于 Alpine Linux 构建，镜像体积小，启动速度快，适合资源受限的 CI/CD 环境。

预装核心工具

所有镜像均预装 CI/CD 流程常用工具，减少环境配置时间：

• 版本控制：git、openssh
• 网络工具：curl、wget、ca-certificates
• 构建工具：bash、make
• 包管理：PHP 镜像含 composer，Node.js 镜像含 npm

使用场景与适用范围

• 持续集成流程：自动化测试、代码检查、依赖安装（如 composer install、npm install）。
• 多版本兼容性测试：在同一 CI 系统中验证项目在不同 PHP/Node.js 版本下的运行状态。
• 轻量级构建环境：替代复杂的本地环境配置，快速启动标准化构建流程。

详细使用方法与配置说明

PHP 镜像

版本信息

预装工具

• bash、git、ca-certificates、wget、curl、openssh、make、composer

快速启动命令

将当前目录挂载至容器的 /srv 目录，以交互模式运行 PHP 8.0 环境：

docker run -it --rm -v $(pwd):/srv dockette/ci:php80

其他版本替换标签即可，例如 PHP 7.4：

docker run -it --rm -v $(pwd):/srv dockette/ci:php74

docker-compose 示例

创建 docker-compose.yml 文件，用于 PHP 项目依赖安装与测试：

version: '3.8'
services:
  ci-php:
    image: dockette/ci:php80
    volumes:
      - ./:/srv  # 挂载当前项目目录
    working_dir: /srv  # 设置工作目录
    command: sh -c "composer install && vendor/bin/phpunit"  # 安装依赖并运行测试

启动命令：

docker-compose up

Node.js 镜像

版本信息

预装工具

• bash、git、openssh、curl、make、npm

快速启动命令

将当前目录挂载至容器的 /srv 目录，以交互模式运行 Node.js 14 环境：

docker run -it --rm -v $(pwd):/srv dockette/ci:node14

其他版本替换标签即可，例如 Node.js 12：

docker run -it --rm -v $(pwd):/srv dockette/ci:node12

docker-compose 示例

创建 docker-compose.yml 文件，用于 Node.js 项目依赖安装与构建：

version: '3.8'
services:
  ci-node:
    image: dockette/ci:node14
    volumes:
      - ./:/srv  # 挂载当前项目目录
    working_dir: /srv  # 设置工作目录
    command: sh -c "npm install && npm run build"  # 安装依赖并执行构建

启动命令：

docker-compose up

注意事项

• 所有镜像默认工作目录为 /srv，建议将项目文件挂载至此路径。
• 无特殊环境变量或配置参数，可直接通过 docker run 或 docker-compose 覆盖默认命令。
• 镜像仅包含基础运行环境，如需额外扩展（如 PHP 扩展、Node.js 全局包），可基于此镜像构建自定义 Dockerfile。