Bountysource生产部署全攻略Docker Compose、Puma配置与多域名路由实战【免费下载链接】coreBountysource is the funding platform for open-source software.项目地址: https://gitcode.com/gh_mirrors/core112/coreBountysource 是专为开源软件打造的资助平台开源悬赏平台开发者可以在 Issue 上设立赏金资助者为其认领解决问题。本文带你完整掌握 Bountysource 核心服务 core 的生产部署全流程如何用 Docker Compose 一键编排 PostgreSQL、Elasticsearch、Sphinx 与 Web 服务如何用 Puma 调节 workers 与 threads 参数压榨性能以及如何用一个 Rails 应用同时服务 www、api、salt、短链 4 个域名。无论你是运维新手还是 Rails 老兵这份部署指南都能让你快速上线一个稳定运行的 Bountysource 实例 一、先认识 Bountysource 的部署架构Bountysource 生产环境由5 个核心服务组成理解它们的关系是掌握 Bountysource 生产部署的第一步服务作用默认端口bountysourceRails 主应用Web API 后台3000pgsqlPostgreSQL 数据库5432elasticsearch全文检索引擎Elasticsearch 6.8.89200sphinxSphinx 搜索searchd辅助索引9306 / 9312delayedjob异步任务队列邮件、同步等后台任务— 主应用与延迟任务共享同一个镜像区别只在启动命令这在 docker-compose.yml 中体现得非常清晰。下面这张图展示了 Bountysource 生态中的 GitHub 浏览器插件页效果部署成功后访问官网即可看到类似的集成入口二、Docker Compose 一键编排5 个容器全解析Bountysource 提供了开箱即用的 docker-compose.yml 编排文件核心配置如下services: pgsql: # 数据库挂载 ./pgdata 持久化 sphinx: # 搜索服务挂载搜索配置目录 bountysource: # Web 主容器build 自本地 Dockerfile delayedjob: # 任务队列容器与主容器同镜像 elasticsearch: # 单节点模式的 ES 6.8.8几个关键设计点数据持久化pgsql通过命名卷 本地目录./pgdata:/var/lib/postgresql/data保存数据重建容器不会丢数据服务互联bountysource容器通过links声明依赖pgsql、sphinx、elasticsearch容器内可直接用服务名互相访问环境变量注入主容器通过env_file: .env统一读取密钥与域名配置符合 12-Factor 应用原则启动命令差异Web 容器执行rails s Puma而delayedjob容器执行bundle exec rake jobs:work——同镜像、不同职责干净利落。配套的 Dockerfile 基于ruby:2.7.1基础镜像安装 nodejs 与 postgresql-client分两步拷贝先 Gemfile 再应用代码以充分利用 Docker 构建缓存最后EXPOSE 3000开放应用端口。一键部署三步走构建镜像并启动全部服务docker-compose up -d --build进入容器执行数据库迁移docker-compose exec bountysource rake db:migrate访问http://localhost:3000验证服务存活三、Puma 配置调优workers 与 threads 的黄金公式Web 应用使用 Puma 作为应用服务器配置文件为 config/puma.rb全部参数都支持环境变量覆盖这正是 Bountysource Puma 配置最优雅的地方参数环境变量默认值说明portPORT3000监听端口workersPUMA_WORKERS/WEB_CONCURRENCY3进程数threadsPUMA_THREADS/RAILS_MAX_THREADS3每进程线程数min maxworkers Integer(ENV[PUMA_WORKERS] || ENV[WEB_CONCURRENCY] || 3) threads_count Integer(ENV[PUMA_THREADS] || ENV[RAILS_MAX_THREADS] || 3) preload_app! # 预加载应用降低 worker 启动时间调优建议常见经验值是workers 2 × CPU核数 1threads 4~16。例如 4 核机器可设PUMA_WORKERS9 PUMA_THREADS8。另外注意 config/puma.rb 中的on_worker_boot钩子每个 worker 启动时重新建立数据库连接避免 fork 后连接共享导致的并发问题——这是 Puma ActiveRecord 的必配项。项目还保留了 config/unicorn.rb 作为备选服务器同样支持WEB_CONCURRENCY环境变量。在 PaaS 平台如 Heroku部署时Procfile 定义了 4 类进程配合 app.json 声明web与worker各 1 个实例并自动添加 PostgreSQL 插件release: rake db:migrate web: puma -C /app/config/puma.rb worker: NEW_RELIC_DISPATCHERdelayed_job bundle exec rake jobs:work firehose: rails runner Github::Event.firehose!其中firehose进程专门负责实时消费 GitHub 事件流是 Bountysource 保持 Issue 数据新鲜的关键。四、多域名路由实战一个应用服务 4 个域名Bountysource 的 config/routes.rb 展示了 Rails 多域名路由的经典写法——基于 Host 约束constraints路由lambda_api_host lambda { |request| request.host URI.parse(Api::Application.config.api_url).host } lambda_www_host lambda { |request| request.host URI.parse(Api::Application.config.www_url).host } # ...salt_host / short_host 同理 scope constraints: lambda_www_host do get (*path), to: bounty_source#home # 官网前端 end scope constraints: lambda_api_host do match /track, to: track#track, via: :get scope path: payments do # 支付回调 post :paypal_ipn get :paypal_return end end4 个域名各自的路由策略bnty.co短链域GET /:path全部命中shorts#redirect实现短链跳转salt.bountysource.com团队/众筹页面独立控制器salt#render_htmlwww.bountysource.com官网其中/issues/:id、/fundraisers/:id走服务端渲染以优化 SEO/admin/*进入后台api.bountysource.com承载 REST APIv0/v1/v2 三个版本、支付回调、OAuth 登录。四个域名地址由环境变量注入统一在 config/application.rb 读取config.api_url ENV[BOUNTYSOURCE_API_URL] config.www_url ENV[BOUNTYSOURCE_WWW_URL] config.short_url ENV[BOUNTYSOURCE_SHORT_URL] config.salt_url ENV[BOUNTYSOURCE_SALT_URL]实战要点每个 scope 都会先检查request.ssl?非 HTTPS 请求统一跳转到 HTTPSredirect_to_https。在 Nginx 反向代理层按server_name分发 4 个域名到同一个 3000 端口即可无需修改应用代码。五、生产环境配置清单环境变量与最佳实践部署 Bountysource 前请对照 app.json 检查必填环境变量核心项如下变量用途RAILS_ENV/RACK_ENV运行环境productionDATABASE_URL数据库连接串config/database.yml 直接解析该 URICOOKIE_SECRET_KEY_BASESession 加密密钥务必用随机强密钥PUMA_WORKERS/PUMA_THREADS性能调优入口FOG_*/AWS_*静态资源 CDN 与云存储凭证BOUNTYSOURCE_*_URL4 个域名地址其他生产关键配置日志输出到 stdoutconfig/environments/production.rb 设置config.logger Logger.new(STDOUT)且$stdout.sync true方便 Docker/云日志采集LOG_LEVEL环境变量可动态调级资产走 CDNconfig.action_controller.asset_host指向 CloudFront资产预编译且compile false生产环境不会现场编译 JS/CSS搜索走 AWSconfig/initializers/elasticsearch.rb 中 Searchkick 仅在 production 环境启用 AWS 凭证连接托管 Elasticsearch本地部署时可替换为自建的 ES 容器时区统一 UTCconfig/application.rb 强制TZUTC跨时区部署也不会出现时间戳错乱。六、常见部署问题排查1. 容器启动后 3000 端口拒绝连接检查DATABASE_URL是否正确——config/database.yml 在解析失败时会直接抛出Invalid DATABASE_URL异常看docker-compose logs bountysource即可定位。2. 页面能打开但搜索无结果确认elasticsearch与sphinx容器均处于 Up 状态且主应用容器在links中声明了这两个依赖。3. 短链跳转 404核对BOUNTYSOURCE_SHORT_URL的 host 与路由约束中解析的 host 是否完全一致约束是精确字符串匹配。4. worker 频繁重启多半是内存不足workers × threads过高会放大内存占用按第三节公式回调并观察docker stats。小结Bountysource 的生产部署 Docker Compose 五容器编排Puma 环境变量驱动调优Host 约束多域名路由。掌握这套组合拳后你不仅能部署 Bountysource其中的on_worker_boot重建连接、stdout 日志、env_file 密钥管理等做法也可以直接迁移到你自己的任何 Rails 项目中。【免费下载链接】coreBountysource is the funding platform for open-source software.项目地址: https://gitcode.com/gh_mirrors/core112/core创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考