Capistrano 项目结构全解析Capfile 与 config/deploy 目录详解【免费下载链接】capistranoA deployment automation tool built on Ruby, Rake, and SSH.项目地址: https://gitcode.com/gh_mirrors/ca/capistrano还在为 Capistrano 项目结构一头雾水这篇指南将带你快速看懂部署自动化工具 Capistrano 的核心目录根目录的 Capfile 入口文件、config/deploy 下的环境配置文件以及远程服务器上经典的 current/releases/shared 三层结构。掌握这份地图你就能自信地定制自己的部署流程。一、先建立全局观仓库里的四大区域Capistrano 本身是一个 Ruby 编写的部署自动化工具基于 Rake 和 SSH 构建。浏览源码仓库你会发现项目清晰地分为四个区域目录作用lib/工具核心部署任务、SCM 策略、DSL、内置模板features/Cucumber 集成测试部署场景验收docs/官方文档站点源码spec/RSpec 单元测试对使用者来说真正要重点理解的是lib/capistrano/templates/——它存放着cap install时生成到你项目中的骨架文件。二、Capfile一切部署的入口Capfile 位于项目根目录是 Capistrano 的启动脚本。运行cap deploy时工具会从这里开始加载所有任务。仓库中的模板见 lib/Capfile 和 lib/capistrano/templates/Capfile其结构只有三步加载 DSL 与 stage 机制require capistrano/setup引入默认部署任务require capistrano/deploy挂载 SCM 插件例如 Git 策略install_plugin Capistrano::SCM::Git模板最后还有一行关键的自动加载逻辑Dir.glob(lib/capistrano/tasks/*.rake).each { |r| import r }这意味着你在项目里新建lib/capistrano/tasks/xxx.rake就会被自动导入并出现在cap -T的任务列表中——这是扩展 Capistrano 最常用的方式。 小贴士如果你使用 Mercurial 或 SVN只需在 Capfile 中把 Git 换成对应的 SCM 插件即可内置策略源码分别位于 lib/capistrano/scm/hg.rake对应 hg.rb和 lib/capistrano/scm/svn.rake对应 svn.rb。三、config/deploy 目录详解全局配置与环境隔离cap install生成的config/deploy/目录承担所有部署配置分为两层3.1 全局配置config/deploy.rb定义所有环境共用的变量模板见 lib/capistrano/templates/deploy.rb.erb。最核心的几个变量:application—— 应用名决定远程默认部署路径:repo_url—— 代码仓库地址:linked_files/:linked_dirs—— 需要跨版本持久化的文件与目录如数据库配置、上传目录:keep_releases—— 保留的历史版本数用于回滚文件开头的lock ~ x.x.x会锁定 Capistrano 版本避免升级后配置不兼容。3.2 环境配置config/deploy/production.rb 等每个部署阶段stage一个独立文件如production.rb、staging.rb模板见 lib/capistrano/templates/stage.rb.erb。它负责定义服务器清单server 1.2.3.4, user: deploy, roles: %w{app db web}角色分组:app、:web、:db等供任务按角色分发SSH 选项密钥路径、认证方式等阶段文件中的变量优先级高于全局配置这就是全局 环境两级配置的精髓完整规则可参考 docs/documentation/getting-started/configuration/index.markdown。四、远程服务器上的目录结构current / releases / sharedCapistrano 在每台远程机器上维护一套严格约定的目录由:deploy_to指定根路径/var/www/my_app ├── current - releases/20150120114500/ # 指向最新成功发布的软链接 ├── releases/ # 按时间戳存放每次发布 ├── repo/ # 版本控制仓库镜像 ├── revisions.log # 部署/回滚审计日志 └── shared/ # 持久化数据配置、上传文件这套结构的妙处在于每次部署都是整目录拷贝current软链接在成功后才切换——部署失败时线上版本纹丝不动回滚只需改一个链接。shared目录则保证数据库配置、上传文件等数据跨越版本存活。下图是一次真实部署过程中 Capistrano 创建 release、链接 shared 目录的输出airbrussh 格式官方对这套结构的详细说明见 docs/documentation/getting-started/structure/index.markdown。五、内置任务与插件源码速查当你运行cap deploy时实际执行的是 lib/capistrano/tasks/deploy.rake 中定义的完整流水线clone → update → release → symlink → cleanup。其他内置能力包括lib/capistrano/tasks/doctor.rakecap doctor一键体检服务器环境lib/capistrano/tasks/install.rakecap install生成项目骨架lib/capistrano/tasks/console.rake远程控制台Git 部署策略lib/capistrano/scm/tasks/git.rake六、快速上手三步走在你的应用根目录执行cap install生成 Capfile 与 config/deploy 目录生成模板源自 lib/capistrano/install.rb编辑config/deploy.rb填入:repo_url编辑config/deploy/production.rb填入服务器与角色用cap production git:check验证仓库访问权限通过后再执行cap production deploygit:check 成功时的输出效果如下七、结语记住这张地图Capfile 是入口config/deploy 是大脑lib/capistrano/tasks 是内置手脚远程的 current/releases/shared 是落地的身体。理解了 Capistrano 项目结构的这套约定无论是新增自定义任务、调整环境配置还是排查部署问题你都能快速定位到正确的位置。【免费下载链接】capistranoA deployment automation tool built on Ruby, Rake, and SSH.项目地址: https://gitcode.com/gh_mirrors/ca/capistrano创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考