如何从现有Ruby脚本触发Capistrano部署任务？

我来分享几个靠谱的方案，帮你在现有Ruby脚本里顺畅触发Capistrano部署，解决你之前调用bash脚本时遇到的各种问题。

方案一：正确调用Shell命令（简单直接，适配多数场景） #

很多时候调用cap staging deploy失败，都是因为工作目录不对、Bundle环境未正确加载或者环境变量缺失导致的。下面是经过验证的正确写法，还能捕获输出方便调试：

require 'open3'

# 这里替换成你的消息监听逻辑（比如Redis订阅、Socket监听等）
def listen_for_deploy_signal
  # 示例：当收到特定消息时触发部署
  trigger_received = true # 替换成你的实际触发条件
  if trigger_received
    puts "收到部署触发信号，开始执行staging环境部署..."
    
    # 关键1：指定Capistrano项目的根目录（必须是包含Capfile的目录）
    cap_project_root = "/absolute/path/to/your/capistrano/project"
    # 关键2：用bundle exec确保使用项目Gemfile里的Capistrano版本，避免全局版本冲突
    deploy_command = "cd #{cap_project_root} && bundle exec cap staging deploy"
    
    # 用Open3捕获标准输出和错误输出，方便排查问题
    stdout, stderr, exit_status = Open3.capture3(deploy_command)
    
    if exit_status.success?
      puts "✅ 部署成功！输出内容：\n#{stdout}"
    else
      puts "❌ 部署失败！错误信息：\n#{stderr}"
    end
  end
end

# 启动监听
listen_for_deploy_signal

核心注意点： #

• 必须切换到Capistrano项目的根目录：Capistrano需要读取Capfile、config/deploy/下的配置文件，不在正确目录执行会直接报错。
• 用bundle exec：避免全局安装的Capistrano版本和项目依赖版本不匹配，导致未知错误。
• 用Open3替代system：system只能知道命令是否成功，无法捕获错误输出，而Open3能帮你拿到完整的日志，调试起来事半功倍。

方案二：直接调用Capistrano的Ruby API（更集成，无Shell依赖） #

如果你的Ruby项目已经引入了ActiveSupport，更推荐用这种方式——完全在Ruby环境内执行部署，避免Shell调用带来的环境变量、权限等问题，还能直接捕获Ruby异常。

require 'capistrano/all'
require 'active_support' # 你已经引入，这里可以保留

def trigger_capistrano_deploy
  # 指定Capistrano项目根目录
  cap_project_root = "/absolute/path/to/your/capistrano/project"
  
  # 切换到项目目录，加载Capistrano配置
  Dir.chdir(cap_project_root) do
    # 加载Capfile和所有部署配置
    load 'Capfile'
    
    begin
      # 直接调用deploy任务
      Capistrano::Application.invoke("deploy")
      puts "✅ 部署任务执行成功！"
    rescue => e
      puts "❌ 部署任务执行失败：#{e.message}"
      puts "完整错误栈：\n#{e.backtrace.join("\n")}"
    end
  end
end

# 消息监听逻辑，触发时调用部署方法
def listen_for_trigger
  # 替换成你的实际监听逻辑，比如消费消息队列、处理HTTP请求等
  received_message = "deploy_staging" # 示例消息
  if received_message == "deploy_staging"
    trigger_capistrano_deploy
  end
end

listen_for_trigger

这个方案的优势： #

• 完全Ruby化：不需要处理Shell的各种坑，所有逻辑都在Ruby环境内，调试更直观。
• 更灵活：可以在部署前后插入自定义Ruby逻辑（比如记录部署日志、发送通知）。
• 权限一致：直接使用运行Ruby脚本的用户权限，和手动执行Capistrano命令的权限完全匹配。

常见问题排查 #

1. SSH认证失败：确保运行Ruby脚本的用户拥有部署服务器的SSH权限（和你手动执行cap命令的用户一致），可以提前测试ssh user@server是否能免密登录。
2. 环境变量缺失：如果部署需要特定环境变量（比如部署令牌、API密钥），可以在脚本里手动设置：ENV['DEPLOY_TOKEN'] = 'your_token'，或者在启动脚本时传入。
3. Bundle依赖问题：如果用API方式，确保你的脚本的Gemfile里包含Capistrano的相关依赖，或者在项目目录下执行bundle install后再运行脚本。
4. 长期运行的监听服务：如果你的脚本需要一直监听消息，可以用daemons gem把它做成守护进程，或者用systemd等工具管理进程，避免脚本意外退出。

内容的提问来源于stack exchange，提问作者Cyril Duchon-Doris