cobytes/ci-build-wordpress

镜像概述

基于Alpine Linux的轻量级WordPress CI构建镜像，专为WordPress项目的持续集成与自动化构建流程设计。该镜像整合了WordPress主题、插件及站点构建所需的核心工具，旨在简化CI/CD pipeline中的构建环节，同时保持轻量级与高效性。

核心功能和特性

• 轻量级基础：基于Alpine Linux构建，镜像体积小（通常<200MB），资源占用低，启动速度快
• 完整工具链：预装PHP、Composer、Node.js、npm等WordPress构建必需依赖，无需额外配置
• CI优化：针对自动化流程优化，支持构建命令链式执行，兼容主流CI/CD平台
• 安全特性：继承Alpine Linux的最小化***面特性，减少运行时安全风险

使用场景和适用范围

• WordPress主题开发的自动化测试与打包
• WordPress插件的代码检查、单元测试与构建流程
• WordPress完整站点的CI/CD集成（含依赖安装、资产编译、测试验证）
• 兼容GitHub Actions、GitLab CI/CD、Jenkins、Bitbucket Pipelines等主流CI平台

使用方法和配置说明

本地测试运行

通过docker run命令在本地验证构建流程：

bash
# 挂载当前WordPress项目目录并执行构建命令
docker run --rm -v $(pwd):/app cobytes/docker-ci-build-wordpress:latest \
  sh -c "composer install && npm install && npm run build && phpunit"

CI平台配置示例

GitHub Actions

在项目根目录创建.github/workflows/ci.yml：

yaml
name: WordPress CI Build
on: [push, pull_request]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Run CI build
        uses: docker://cobytes/docker-ci-build-wordpress:latest
        with:
          args: |
            composer install --no-dev
            npm ci
            npm run production
            phpcs --standard=WordPress

GitLab CI/CD

在项目根目录创建.gitlab-ci.yml：

yaml
stages:
  - build

wordpress-build:
  stage: build
  image: cobytes/docker-ci-build-wordpress:latest
  script:
    - composer install
    - npm install
    - npm run build
    - phpunit tests/
  artifacts:
    paths:
      - build/

目录结构要求

项目需遵循标准WordPress开发结构，至少包含：

• composer.json（PHP依赖配置）
• package.json（前端资产配置，如需要）
• 源代码目录（如src/、wp-content/plugins/[plugin-name]/等）

注意事项

• 挂载目录：项目根目录需挂载至容器内/app路径（默认工作目录）
• 命令组合：通过sh -c "command1 && command2 && ..."实现多命令顺序执行
• 版本控制：指定具体标签（如:1.2.0）而非latest以确保构建稳定性
• 资源限制：Alpine基础镜像可能需要在资源受限环境中调整内存分配（尤其Node.js构建时）