cpsit/deploy-typo3-capistrano

Deploy TYPO3 Capistrano Docker镜像文档

镜像概述与主要用途

本Docker镜像用于通过Capistrano工具部署TYPO3 CMS应用，集成了Capistrano及相关依赖，提供统一的部署环境，简化TYPO3应用的部署流程。需配合Capistrano配置文件使用，支持执行标准Capistrano部署命令。

核心功能与特性

• 内置Capistrano部署工具，无需在主机环境单独安装配置
• 包含TYPO3部署所需依赖包（具体依赖列表可查看镜像内的Gemfile）
• 支持执行Capistrano标准命令，如cap [target] [task]，实现环境部署、任务执行等操作
• 提供隔离的部署环境，避免主机环境依赖冲突

使用场景与适用范围

适用于需要通过Capistrano自动化部署TYPO3 CMS应用的开发、测试或生产环境，尤其适合需要标准化部署流程、统一工具版本的团队或个人项目。

使用方法与配置说明

前置要求

• 已准备Capistrano配置文件（通常包括Capfile、config/deploy.rb及各环境配置文件，如config/deploy/production.rb等）
• 本地TYPO3项目文件及Capistrano配置文件需可被容器访问

部署步骤

1. 构建或获取镜像

若需基于源码构建镜像：

bash
docker build -t typo3-capistrano .

（若使用现成镜像，可直接指定镜像名称，如your-registry/typo3-capistrano）

2. 运行容器并挂载项目文件

将本地TYPO3项目目录和Capistrano配置文件挂载到容器中，确保容器可访问部署所需文件：

bash
docker run -it \
  -v /path/to/your/typo3/project:/app \  # 挂载TYPO3项目目录
  -v /path/to/capistrano/config:/cap/config \  # 挂载Capistrano配置文件目录
  typo3-capistrano

3. 执行Capistrano部署命令

在运行的容器内，切换到项目目录并执行部署命令：

bash
cd /app  # 进入挂载的项目目录
cap production deploy  # 部署到production环境
# 或执行其他任务，如检查部署配置：cap staging deploy:check

命令说明

• cap [target] [task]：标准Capistrano命令，target为部署目标环境（如production、staging），task为具体任务（如deploy、deploy:check）
• 具体支持的任务及配置可参考Capistrano官方文档及项目中的Capistrano配置文件