advertile/docker-capistrano

Docker Capistrano镜像

镜像概述

本镜像基于ruby:2.3.0构建，内置Capistrano自动化部署工具，旨在简化应用程序的远程部署流程，支持通过SSH密钥认证实现多环境（如测试、预发布、生产）部署，适用于持续集成/持续部署（CI/CD）场景。

核心功能

• 基于Ruby 2.3.0稳定运行环境
• 集成Capistrano部署工具，支持自动化部署逻辑
• 支持SSH密钥认证及跳转主机配置
• 可通过环境变量动态指定部署环境
• 兼容CI/CD流水线的自动化执行需求

使用场景

• CI/CD流水线中的自动化部署环节
• 多环境（staging、production）的应用发布
• 需要SSH密钥认证的远程服务器部署场景
• 项目版本化部署的标准化流程落地

配置说明

1. SSH配置：复制包含config和known_hosts的.ssh目录到镜像/root/.ssh路径，确保SSH连接认证有效
2. 项目文件：复制项目的.git目录、config目录及Capfile到镜像/usr/src/app路径，提供部署所需的项目元数据和配置
3. 部署脚本：添加自定义deploy.sh脚本到镜像/usr/bin/deploy，用于处理环境变量、密钥生成及部署执行逻辑

部署示例

Dockerfile示例

# 复制SSH部署所需的.ssh目录（含config、known_hosts）
COPY ./config/.ssh /root/.ssh

# 复制项目必要文件
COPY ./.git /usr/src/app/.git
COPY ./config /usr/src/app/config
COPY ./Capfile /usr/src/app/Capfile

# 添加部署执行脚本
COPY ./scripts/deploy.sh /usr/bin/deploy

deploy.sh脚本示例（CI流程用）

bash
#!/bin/bash

# 检查CI_BRANCH环境变量，未设置则默认使用staging环境
if [ -z $CI_BRANCH ]; then
  echo '未指定CI_BRANCH环境变量'
  capistrano_deployment_environment='staging'
  echo "回退到默认环境：$capistrano_deployment_environment"
else
  capistrano_deployment_environment=$CI_BRANCH
  echo "使用指定环境：$capistrano_deployment_environment"
fi

# 从环境变量生成SSH密钥并设置权限
mkdir -p "$HOME/.ssh"
echo -e $CAPISTRANO_PRIVATE_SSH_KEY > $HOME/.ssh/id_rsa
chmod 600 $HOME/.ssh/id_rsa

# 启动SSH代理（适配跳转主机场景）
eval $(ssh-agent) > /dev/null
ssh-add > /dev/null 2>&1

# 复制共享构建产物到项目目录
cp -r /project_name /usr/src/app/build

# 执行Capistrano部署
cap $capistrano_deployment_environment deploy