Capistrano 核心概念速览：Stage、Role、Task 与 Filter 一次讲透

Capistrano 核心概念速览Stage、Role、Task 与 Filter 一次讲透【免费下载链接】capistranoA deployment automation tool built on Ruby, Rake, and SSH.项目地址: https://gitcode.com/gh_mirrors/ca/capistranoCapistrano 是一款基于 Ruby、Rake 和 SSH 的服务器部署自动化工具。本文用一次完整的讲解帮你快速吃透它的 4 个核心概念——Stage阶段、Role角色、Task任务与 Filter过滤器无需翻遍源码也能上手配置。为什么需要这些核心概念手动 SSH 到每台服务器执行部署命令不仅繁琐还容易遗漏某台机器。Capistrano 的思路是把部署到哪、按什么顺序、执行什么步骤全部声明化一条命令cap production deploy就能把应用可靠地推送到任意多台机器支持顺序执行或滚动更新。它不仅能部署应用还能自动化审计多台机器查看登录日志、检查运行时长、打安全补丁等任何 SSH 场景下的脚本化工作流。更多内容可参考官方文档 what-is-capistrano。Stage阶段一个环境一份独立配置Stage 就是你部署的目标环境比如development、staging、production。每个 Stage 对应config/deploy/目录下的一个同名配置文件如production.rbstages.rb 通过扫描该目录自动发现所有可用阶段。命令行的写法是cap stage task例如cap production deploy。全局配置放在config/deploy.rbStage 专属配置放在config/deploy/stage_name.rb规则详见 Configuration。⚠️ 注意stages.rb 中定义了保留名deploy、doctor、installStage 不能取这些名字。Role角色给每台服务器分工Role 描述服务器在集群中的职责让同一批任务对不同机器执行不同操作。典型划分角色职责web运行 Nginx/Apache 等 Web 服务器app运行应用进程如 Passenger/Pumadb数据库服务器workers后台任务队列在 Stage 配置文件中声明即可server example.com, roles: [:web, :app] server example.org, roles: [:db, :workers]之后任务里用roles(:db)就能精准定位数据库服务器。服务器、角色与属性的完整模型见 server.rb 和 servers.rb。Task任务部署的原子步骤Task 是 Capistrano 中最小的可执行单元基于 Rake 定义。内置的deploy任务包含check、setup、deploy:checking_revision、deploy:release、deploy:shared_links等一串子任务全部定义在 deploy.rake。一个自定义 Task 长这样来自 官方示例desc Report Uptimes task :uptime do on roles(:all) do |host| info Host #{host}: #{capture(:uptime)} end end执行后Capistrano 会并行 SSH 到所有目标服务器终端呈现如下的 Airbrussh 风格输出——每条远程命令的执行状态一目了然 小贴士execute(:bundle, :install)与execute(bundle install)行为并不完全相同官方文档 对此有专门说明新手容易踩坑。Filter过滤器精确控制跑在哪几台机器Filter 让你只在服务器集合的一个子集上执行任务——比如某台机器出问题只想重新部署它而不动其他机器。Capistrano 内置三种过滤器核心实现位于 configuration/ 目录Host Filter按主机名过滤。如cap --hostsserver1,server2 production deploy也支持正则--hosts^localrubyserver。详见 host-filtering实现见 host_filter.rb。Role Filter按角色过滤。如ROLESapp,web cap production deploy只部署承载 app/web 角色的服务器。详见 role-filtering实现见 role_filter.rb。Property Filter按服务器自定义属性过滤例如roles(:all, active: true)只选中active: true的服务器。详见 property-filtering。 关键规则同一类型的过滤器用逗号分隔时取并集不同类型过滤器叠加时取交集。例如先过滤角色app再过滤主机server1,server2最终只命中角色是 app 且主机名为二者之一的机器。完整机制见 filtering 文档 与 filter.rb。四个概念如何协作一图总结Stage环境 └─ 声明若干 Server └─ 每个 Server 拥有若干 Role └─ Task 通过 roles() 选择执行目标 └─ Filter 在任务级别进一步缩小目标集合用一句话串起来在某个 Stage 里Task 按照 Role 的分工执行而 Filter 帮你把动作精确投送到需要的服务器。掌握这 4 个词你就读懂了 Capistrano 90% 的官方文档。延伸阅读Structure 目录结构理解releases/、shared/、current软链接Before/After 钩子在任务前后插入自定义逻辑【免费下载链接】capistranoA deployment automation tool built on Ruby, Rake, and SSH.项目地址: https://gitcode.com/gh_mirrors/ca/capistrano创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考