jurihub/deployer

Jurihub CI/部署工具集镜像

镜像概述和主要用途

Jurihub CI/部署工具集镜像是一个集成化的CI/CD工具环境，包含PHP运行环境、Deployer部署工具以及Node.js+npm前端构建工具。该镜像旨在简化持续集成与部署流程，为开发团队提供统一的工具链，减少因环境差异导致的部署问题，支持从代码构建、测试到应用部署的全流程自动化。

核心功能和特性

• 多环境集成：内置PHP运行环境，支持PHP项目的代码解析与执行；集成Node.js及npm包管理器，满足前端资源构建需求
• 专业部署工具：包含Deployer（PHP部署工具），支持编写部署脚本、多服务器部署、回滚机制等专业部署功能
• 一站式工具链：整合后端（PHP）与前端（Node.js）构建工具，无需单独配置多个环境，降低CI/CD流程中的环境依赖复杂性
• 轻量级设计：基于精简基础镜像构建，在提供完整功能的同时保持较小体积，适合CI/CD流水线中的临时任务执行

使用场景和适用范围

• PHP项目CI/CD流程：适用于基于PHP开发的Web应用，在CI/CD流水线中完成代码检查、单元测试、构建及部署
• 前后端混合项目部署：需同时处理PHP后端逻辑与Node.js前端资源（如React、Vue项目）的全栈项目部署场景
• 自动化部署任务：通过Deployer实现自动化部署流程，支持部署到开发、测试、生产等多环境，包含任务并行执行、钩子函数等高级功能
• 持续集成构建：在GitLab CI、GitHub Actions等CI平台中作为运行环境，执行项目构建、依赖安装（composer、npm install）、静态代码分析等任务

使用方法和配置说明

基础使用示例

通过docker run命令启动容器，挂载项目代码目录并执行部署任务：

bash
# 挂载当前项目目录并运行Deployer部署命令
docker run --rm -v $(pwd):/app \
  -v ~/.ssh:/root/.ssh \  # 挂载SSH密钥用于远程服务器认证（如部署目标服务器）
  jurihub/ci-deploy-toolbox \
  deployer deploy production  # 执行Deployer部署到生产环境

前端资源构建示例

在容器中使用npm构建前端资源：

bash
docker run --rm -v $(pwd):/app jurihub/ci-deploy-toolbox \
  sh -c "cd /app/frontend && npm install && npm run build"

PHP代码检查示例

使用PHP内置工具或第三方工具（如PHPStan）进行代码检查：

bash
docker run --rm -v $(pwd):/app jurihub/ci-deploy-toolbox \
  sh -c "cd /app && composer install && vendor/bin/phpstan analyse"

环境变量配置

容器支持通过环境变量调整工具行为（具体变量视镜像版本可能有所差异）：

数据卷挂载

为确保数据持久化或访问主机资源，建议挂载以下目录：

• /app：项目代码目录（必选，存放待构建/部署的项目文件）
• /root/.ssh：SSH密钥目录（如需通过SSH访问远程仓库或部署目标服务器）
• /root/.composer：Composer缓存目录（加速PHP依赖安装）
• /root/.npm：npm缓存目录（加速前端依赖安装）

扩展说明

• 组件版本：镜像中PHP、Node.js及Deployer的具体版本可通过镜像标签指定（如jurihub/ci-deploy-toolbox:php8.2-node18），未指定标签时使用最新稳定版本
• 自定义配置：可通过挂载自定义PHP配置文件（至/usr/local/etc/php/conf.d）、Deployer配置文件（至/app/deploy.php）或npm配置文件（至/root/.npmrc）调整工具行为
• 安全性注意：在CI/CD环境中使用时，建议限制容器权限，避免挂载敏感目录（如/root）或传递不必要的环境变量