Dokku 多实例部署中的数据库迁移并发问题解析

问题背景

在使用 Dokku 部署应用时，当应用需要执行数据库迁移且同时运行多个 Web 实例时，开发者可能会遇到 ActiveRecord::ConcurrentMigrationError 错误。这种情况通常发生在以下场景：

1. 应用通过 dokku ps:scale app_name web=2 worker=4 命令扩展了多个实例
2. 部署新版本应用时包含数据库迁移操作
3. 多个 Web 实例同时尝试执行迁移，导致并发冲突

问题本质

这种并发问题的根源在于 Dokku 的部署机制。当应用有多个 Web 实例时，每个实例在启动时都会尝试执行预定义的启动命令（如数据库迁移）。如果这些命令同时操作数据库的迁移表，就会产生冲突。

解决方案

正确使用部署任务

Dokku 提供了专门的部署任务（Deployment Tasks）机制来处理这类一次性操作：

1. 通过 Procfile 配置：在项目根目录的 Procfile 中添加 release 命令

   release: bundle exec rake db:migrate
   web: bundle exec puma -C config/puma.rb
   worker: bundle exec sidekiq -C config/sidekiq.yml
   

2. 通过 app.json 配置：在项目根目录创建 app.json 文件

   {
     "scripts": {
       "dokku": {
         "predeploy": "bundle exec rake db:migrate"
       }
     }
   }
   

关键优势

1. 单次执行：部署任务只在部署过程中执行一次，不受 Web 实例数量的影响
2. 顺序保证：在应用实例启动前完成迁移，确保数据一致性
3. 失败处理：如果迁移失败，整个部署过程会中止，防止应用运行在不一致的状态

最佳实践建议

1. 区分环境操作：将数据库迁移等一次性操作与常驻进程（Web/Worker）分离
2. 使用专用命令：对于 Rails 应用，优先使用 release 命令而非在 Web 进程启动时执行迁移
3. 监控迁移结果：在 CI/CD 流程中加入对迁移结果的检查
4. 考虑回滚机制：为关键迁移准备回滚方案，特别是生产环境

总结

Dokku 的多实例部署能力虽然强大，但也需要开发者理解其背后的执行机制。通过合理使用部署任务功能，可以避免数据库迁移等一次性操作的并发问题，确保应用部署的可靠性和一致性。这种模式不仅适用于数据库迁移，也可用于其他需要在部署期间执行的一次性初始化操作。