wiebenieuwenhuis/deployer

deployer 镜像文档

镜像概述

这是一个专为GitLab CI部署设计的Docker容器镜像，集成了部署过程中常用的多种开发和构建工具，旨在简化CI/CD流程中的自动化部署步骤，提供一致的部署环境。

核心功能与特性

• 集成关键部署工具：包含部署所需的完整工具链，满足多类型项目部署需求：
  • PHP 8.0：支持PHP项目运行及依赖处理
  • Composer：PHP依赖管理工具
  • Deployer.org：专业部署工具，支持多环境部署策略
  • Node 16：JavaScript运行环境，支持前端项目构建
  • NPM：Node.js包管理工具
  • Yarn：高性能Node.js包管理工具
  • Gulp：前端任务自动化工具，支持资源构建与优化

使用场景与适用范围

• GitLab CI/CD流程：作为CI/CD pipeline中的部署阶段容器，执行自动化部署任务
• PHP应用部署：配合Composer和Deployer.org实现PHP项目的依赖管理与部署
• 前端项目部署：通过Node、NPM/Yarn和Gulp完成前端资源构建、打包与部署
• 混合技术栈项目：满足同时使用PHP后端和JavaScript前端的项目部署需求

使用方法与配置说明

基本使用（docker run）

通过以下命令运行容器并执行部署任务：

bash
docker run --rm -v $(pwd):/app deployer:latest dep deploy

参数说明：

• --rm：容器运行结束后自动清理
• -v $(pwd):/app：挂载当前目录到容器内/app路径，使容器可访问项目文件
• dep deploy：执行Deployer部署命令（可根据项目需求替换为具体部署指令）

GitLab CI配置示例

在.gitlab-ci.yml中配置部署阶段：

yaml
deploy_production:
  stage: deploy
  image: deployer:latest
  script:
    - cd /app
    - composer install --no-dev --optimize-autoloader
    - npm install
    - npm run build
    - dep deploy production --tag=$CI_COMMIT_SHA
  only:
    - main
  environment:
    name: production

说明：

• 脚本依次执行PHP依赖安装、前端依赖安装、前端构建和Deployer部署命令
• --tag=$CI_COMMIT_SHA：使用Git提交SHA作为部署标签，便于版本追踪

工具版本说明

镜像中包含的工具版本固定，如需特定版本可基于此镜像通过Dockerfile进行定制：

dockerfile
FROM deployer:latest
# 示例：升级Node版本
RUN apt-get update && apt-get install -y nodejs=18.x