pierrickm1/ci-pipeline

PHP + Node.js CI/CD流水线镜像

镜像概述与主要用途

本镜像基于Alpine Linux构建，是一款轻量级、多功能的GitLab CI/CD流水线专用镜像，旨在为CI/CD流程提供一站式支持，涵盖代码检查（lint）、测试（test）、构建（build）和部署（deploy）全环节。依托Alpine Linux的轻量级特性（基于musl C库），实现了更小的镜像体积和更低的资源占用，适配高效自动化流水线需求。

核心功能与特性

轻量级基础架构

• 基于Alpine Linux发行版，相比传统Linux系统，镜像体积更小，资源消耗更低，加速流水线执行效率。

多版本PHP支持

• 初始支持PHP 7.4，后升级至PHP 8.4，满足不同PHP项目的版本兼容性需求。

全面工具集成

• 数据库工具：PostgreSQL、SQLite
• 缓存与消息队列：Redis、RabbitMQ
• PHP开发套件：PHPUnit（测试框架）、Symfony（PHP框架）、Composer（依赖管理）
• 前端开发工具：Vue.js（前端框架）、Vite（构建工具）、Node.js（运行时）
• 搜索引擎：Typesense
• 有限支持Python：提供基础支持，但未经过积极使用验证，功能覆盖有限。

全流程覆盖能力

• 支持CI/CD关键环节：代码规范性检查、自动化测试执行、项目构建打包、部署流程自动化，实现端到端流水线支持。

支持的环境与工具详情

核心运行环境

• PHP：7.4版本（初始支持）及8.4版本（升级后），适配主流PHP项目开发需求。
• Node.js：集成Node.js运行时及前端工具链（Vue.js、Vite），支持前端项目构建与测试。

辅助工具链

• 数据存储：PostgreSQL（关系型数据库）、SQLite（轻量级文件数据库），满足数据库依赖的测试场景。
• 中间件：Redis（缓存系统）、RabbitMQ（消息队列），支持需要缓存或异步任务的应用场景。
• 开发工具：PHPUnit（单元测试）、Composer（PHP依赖管理），覆盖PHP项目开发全流程。

其他支持

• Python：提供基础运行环境，但未经过深度验证，建议仅用于简单脚本执行场景。

使用场景与适用范围

适用项目类型

• 以PHP为主开发语言，结合Node.js前端技术栈的Web应用项目。
• 需要集成数据库、缓存、消息队列等中间件的复杂应用。

适用CI/CD场景

• GitLab CI/CD流水线环境，用于自动化代码质量检查、单元测试、集成测试、项目构建及部署流程。
• 支持多阶段流水线配置，适配开发、测试、生产等不同环境的部署需求。

使用方法

在GitLab CI/CD中配置

在项目的.gitlab-ci.yml文件中指定本镜像，即可启用相关工具链。以下为典型配置示例：

yaml
image: docker.xuanyuan.run/[镜像名称]  # 替换为实际镜像名称或地址

stages:
  - lint       # 代码检查阶段
  - test       # 测试阶段
  - build      # 构建阶段
  - deploy     # 部署阶段

# 代码检查作业示例
code-lint:
  stage: lint
  script:
    - composer install  # 安装PHP依赖
    - phpcs --standard=PSR2 src/  # PHP代码规范检查（需项目配置phpcs）
    - npm install       # 安装Node.js依赖
    - npm run lint      # 前端代码检查（如ESLint）

# 测试作业示例（含数据库依赖）
unit-test:
  stage: test
  services:
    - postgres:14  # 启动PostgreSQL服务（根据需求指定版本）
    - redis:alpine # 启动Redis服务
  variables:
    POSTGRES_DB: test_db
    POSTGRES_USER: test_user
    POSTGRES_PASSWORD: test_pass
  script:
    - composer install --dev  # 安装开发环境依赖
    - phpunit tests/          # 执行PHP单元测试
    - npm install
    - npm run test            # 执行前端测试（如Jest）

# 构建作业示例
project-build:
  stage: build
  script:
    - composer install --no-dev  # 安装生产环境PHP依赖
    - npm install
    - npm run build              # 前端资源构建（如Vite打包）
  artifacts:
    paths:
      - dist/  # 保存构建产物，供部署阶段使用

# 部署作业示例
deploy-production:
  stage: deploy
  script:
    - ./deploy-script.sh  # 执行部署脚本（根据项目实际部署逻辑编写）
  only:
    - main  # 仅在main分支触发部署

注意事项

• 版本兼容性：使用前需确认项目PHP版本（7.4/8.4）与镜像支持版本匹配。
• Python使用限制：如需使用Python功能，建议提前测试核心功能，避免依赖未验证的特性。
• 服务依赖配置：若流水线需使用PostgreSQL、Redis等服务，需在.gitlab-ci.yml的services字段中声明对应服务镜像。