paneidos/ci-image

CI镜像系列文档

镜像概述

CI镜像系列是专为持续集成(CI)环境设计的Docker镜像集合，提供多语言框架支持和专项工具集成，简化CI/CD流水线中的环境配置流程。

核心功能与特性

通用特性

• 支持Ruby、PHP及Node.js开发环境
• 提供PHP版本切换功能：通过switch-php VERSION命令切换指定PHP版本
• 警告：镜像未配置非特权用户，运行时需注意权限管理

Laravel专项支持

• 内置Laravel Envoy部署工具，直接支持Laravel项目的自动化部署流程
• 默认PHP版本：7.4（当前稳定配置）

MariaDB数据库环境

• 基于MariaDB 10.2构建
• InnoDB存储引擎默认文件格式：Barracuda，优化大字段存储支持

使用场景与适用范围

• 多语言CI流水线：适用于Ruby、PHP或Node.js项目的构建、测试流程
• Laravel项目部署：特别优化Laravel开发流程，通过Envoy实现一键部署
• 数据库依赖环境：提供MariaDB 10.2标准环境，满足需要Barracuda格式的InnoDB存储场景

使用方法与配置说明

通用CI镜像使用

基础运行

bash
# 拉取并交互式运行通用CI镜像（假设镜像标签为ci-generic:latest）
docker run -it ci-generic:latest

PHP版本切换

bash
# 切换至PHP 8.1版本
switch-php 8.1

# 验证PHP版本
php -v

Laravel专项镜像使用

基础运行

bash
# 拉取并运行Laravel CI镜像（假设镜像标签为ci-laravel:latest）
docker run -it -v $(pwd):/app ci-laravel:latest

Laravel Envoy部署示例

在Laravel项目根目录执行：

bash
# 运行Envoy部署任务（需项目中存在Envoy.blade.php配置）
envoy run deploy

MariaDB镜像使用

启动数据库服务

bash
# 后台运行MariaDB容器并映射端口
docker run -d -p 3306:3306 \
  --name ci-mariadb \
  -e MYSQL_ROOT_PASSWORD=secret \
  ci-mariadb:10.2

验证InnoDB文件格式

sql
-- 连接数据库后执行
SHOW VARIABLES LIKE 'innodb_file_format';
-- 预期输出：Barracuda

许可证

本仓库代码采用MIT许可证。Docker镜像中包含的第三方软件可能具有独立许可证，具体请参阅各软件官方文档。