cicd-wordpress 镜像文档

镜像概述

cicd-wordpress是专为WordPress项目设计的CI/CD Docker镜像，旨在简化和自动化WordPress应用的持续集成（CI）与持续部署（CD）流程。该镜像集成必要工具链，支持从代码提交到应用部署的全流程自动化，帮助开发团队提升效率并确保部署一致性。

核心功能和特性

• 自动化流程支持：集成CI/CD关键环节，支持代码拉取、依赖安装、构建打包、测试执行和部署触发的自动化串联
• WordPress适配优化：针对WordPress项目架构特点，预置PHP环境、数据库连接工具及主题/插件构建依赖
• 灵活配置机制：支持通过环境变量和配置文件自定义构建脚本、测试策略和部署目标
• 轻量级设计：基于精简基础镜像构建，减少资源占用同时保证功能完整性

使用场景和适用范围

• WordPress主题/插件开发者需要自动化测试和发布流程
• 企业级WordPress站点维护团队实现多环境（开发、测试、生产）自动化部署
• 个人开发者简化WordPress项目的版本管理和部署操作
• 集成至现有CI/CD平台（如GitLab CI、GitHub Actions、Jenkins）作为专用构建环境

使用方法和配置说明

基础使用

拉取并运行镜像的基本命令：

docker run -d --name wp-cicd-instance cicd-wordpress

环境变量配置

通过环境变量自定义镜像行为，常用配置项：

配置示例：

docker run -d \
  --name wp-cicd-configured \
  -e WP_PROJECT_DIR=/my-wp-site \
  -e DEPLOY_TARGET=production \
  -e DB_CONNECTION_TEST=false \
  -v /local/wp-project:/my-wp-site \
  cicd-wordpress

Docker Compose集成

典型docker-compose.yml配置：

version: '3.8'
services:
  wp-cicd:
    image: cicd-wordpress
    container_name: wp-cicd-pipeline
    environment:
      - WP_PROJECT_DIR=/app
      - CI_SCRIPT_PATH=/scripts/custom-pipeline.sh
      - DEPLOY_TARGET=staging
    volumes:
      - ./wp-project:/app
      - ./ci-scripts:/scripts
    restart: unless-stopped

CI/CD平台集成示例

GitLab CI配置（.gitlab-ci.yml）

stages:
  - build
  - test
  - deploy

build-stage:
  image: cicd-wordpress
  stage: build
  script:
    - cd $WP_PROJECT_DIR
    - composer install
    - npm run build
  artifacts:
    paths:
      - $WP_PROJECT_DIR/build/

test-stage:
  image: cicd-wordpress
  stage: test
  script:
    - cd $WP_PROJECT_DIR
    - phpunit tests/
    - wp lint theme ./wp-content/themes/custom-theme

deploy-stage:
  image: cicd-wordpress
  stage: deploy
  script:
    - $CI_SCRIPT_PATH
  only:
    - main