actidde/deploy

Capistrano部署工具镜像

镜像概述

本Docker镜像基于Alpine Linux 3.20.3构建，专为使用Capistrano进行应用部署设计。集成了Ruby运行环境、Capistrano部署工具及相关依赖组件，提供轻量级、高效的部署环境，简化自动化部署流程。

核心功能与特性

基础环境

• 操作系统：Alpine Linux 3.20.3（轻量级基础，减小镜像体积）

Ruby环境与Gems

• Ruby 3.3.6（稳定版Ruby运行时）
• Gem bundler 2.5.23（Ruby依赖管理工具）
• Gem capistrano 3.19.2（核心部署自动化工具）
• Gem net-ssh 7.3.0（SSH网络操作库，Capistrano依赖）
• Gem ed25519 1.3.0（ED25519密钥认证支持）
• Gem bcrypt_pbkdf 1.1.1（BCrypt PBKDF密钥派生功能）

部署工具链

• Rsync 3.3.0（文件同步工具，用于部署文件传输）
• Git 2.45.2（版本控制工具，用于拉取代码）
• Make 4.4.1（构建工具，支持编译依赖）
• gcc 13.2.1（C编译器，用于安装原生Ruby扩展）
• curl 8.11.0（网络请求工具，用于下载资源）

使用场景

适用于需要通过Capistrano自动化部署Ruby应用（如Rails、Sinatra等）的开发或运维场景，尤其适合：

• CI/CD流水线中集成部署步骤，实现自动化部署
• 本地开发环境快速执行部署命令，避免环境依赖冲突
• 多环境（开发、测试、生产）统一部署工具版本，确保部署一致性

使用方法与配置说明

基本运行方式

通过挂载项目目录到容器内，执行Capistrano部署命令：

bash
docker run -v $(pwd):/app -w /app capistrano-deployer cap <stage> deploy

参数说明：

• -v $(pwd):/app：将当前目录（包含Capfile和部署配置）挂载到容器内/app目录
• -w /app：设置容器工作目录为/app，确保Capistrano命令在项目根目录执行
• <stage>：替换为部署环境（如production、staging）

持久化配置（可选）

如需保存SSH密钥或部署配置，可挂载配置目录：

bash
docker run -v $(pwd):/app -v ~/.ssh:/root/.ssh -v ~/.capistrano:/root/.capistrano -w /app capistrano-deployer cap production deploy

挂载说明：

• ~/.ssh:/root/.ssh：共享本地SSH密钥，用于远程服务器认证
• ~/.capistrano:/root/.capistrano：持久化Capistrano缓存和配置

自定义命令

执行其他Capistrano命令（如查看任务列表、回滚部署）：

bash
# 查看可用部署任务
docker run -v $(pwd):/app -w /app capistrano-deployer cap -T

# 回滚到上一版本
docker run -v $(pwd):/app -w /app capistrano-deployer cap production deploy:rollback

构建与扩展（可选）

如需添加额外依赖，可基于此镜像构建自定义镜像：

dockerfile
FROM capistrano-deployer
RUN apk add --no-cache <additional-package>  # 添加系统依赖
RUN gem install <additional-gem>            # 添加Ruby Gem