如何处理带有子模块的 Rails 应用程序部署？

Question

我最近将几个插件转换为子模块，并意识到当您“git克隆”存储库时，子模块目录将为空。 这对于联合开发人员初始化其子模块和更新是有意义的。

但是，当我使用 capistrano 进行部署时，子模块代码显然不会被部署，这会导致问题。 我可以进入发布分支并初始化并更新那里的模块，但这显然不是一个理想的解决方案。

有人对如何处理这个问题有建议吗？ 它像 capistrano 任务一样简单吗？

我在生产方面有点菜鸟。

谢谢你！

Answer 1

根据 这个最近的帖子，capistrano 应该能够初始化并更新您的子模块

set :git_enable_submodules,1

：如果您的 .gitmodules 条目是最新的，config/deploy.rb 应该足够了。
您可能需要 修补 Capistrano (lib/ capistano/recipes/deploy/scm/git.rb) 以确保您的子模块被包含在内。

    def checkout(revision, destination)
      git      = command

      branch   = head

      fail "No branch specified, use for example 'set :branch, \"origin/master\"' in your deploy.rb" unless branch

      if depth = configuration[:git_shallow_clone]
        execute  = "#{git} clone --depth #{depth} #{configuration[:repository]} #{destination} && " 
      else
        execute  = "#{git} clone #{configuration[:repository]} #{destination} && " 
      end

      execute += "cd #{destination} && #{git} checkout -b deploy #{branch}" 

      if submodules = configuration[:git_enable_submodules]
        execute += " && git-submodule init &&" 
        execute += "git-submodule update" 
      end

      execute
    end

---

如果您有嵌套子模块< /strong>，您需要：

gem sources -a http://gems.github.com
$ sudo gem install morhekil-capistrano-deepmodules

只需在部署配置中要求它：

require 'capistrano/deepmodules'

gem 会自动处理剩下的所有事情。
您可以从配置中删除 :git_enable_submodules，gem 不会注意到它 - 如果您需要它，您已经在说您想要启用子模块。

还有一个需要注意的细节 - 目前 gem 仅支持远程缓存策略。 这意味着您必须将以下行添加到您的config中：

set :deploy_via, :remote_cache

它启用了远程缓存，而且这确实是您想要做的事情 - 如果您没有服务器端缓存，那么部署包含大量子模块和其他内容的大型代码库确实是一种麻烦的体验。

Answer 2

如果没有这个选项，set :git_enable_submodules, 1 本身就不起作用：

set :deploy_via, :remote_cache`

这似乎没有在任何地方记录下来，我花了一段时间才弄清楚。 无论如何，即使没有子模块，拥有该选项通常也很好。

Answer 3

通过此提交，Capistrano 支持 Git 子模块和内置的 --recursive 选项。要启用 Git 子模块支持，请将其添加到您的 deploy.rb 文件中：

set :git_enable_submodules, true

如果您使用 递归 Git 子模块，也添加以下内容：

set :git_submodules_recursive, true