部署与运维

这一课你将能做到

1. 用 Puma + systemd 或 Kamal 把 Rails 应用推上生产服务器
2. 配置生产环境的三件套：资产预编译、数据库迁移、密钥管理
3. 说清楚 Rails 7/8 的 Solid 生态（Cache/Queue/Cache）如何省掉 Redis

为什么要学

能写的代码不算本事，能稳定跑在用户面前的代码才是。部署和运维是开发到上线的最后一公里，也是事故最高发的阶段：环境变量漏配、数据库迁移没跑、资产 404、连接池耗尽——任意一条都能让精心写的代码在用户面前变成白屏。Rails 8 的 Kamal 把部署简化到「一条命令上云」，中小团队终于不必深陷 Ansible/Capistrano 的泥潭。

对比本站：Spring Boot + Next.js 的部署通常拆成「Java 容器 + Nginx + Node 进程」，配置两份；Rails 全栈应用是单一进程（Puma），配好反向代理即可，部署脚本短一半。

先建立图像

用户浏览器
      │
      ▼
  Nginx / CDN（SSL、静态文件、缓存）
      │
      ▼
  Puma（Rails 进程）
      │
      ├─ Workers（2~4）× Threads（5）
      │
      ▼
  数据库（SQLite / MySQL / PostgreSQL）
      │
      ▼
  后台 Worker（Solid Queue，可选独立进程）

部署流水线：
代码推送 → CI 跑测试 → 镜像构建（Docker）→ 服务器拉镜像
  → 资产预编译 → 数据库 migrate → 切新容器 → 旧容器退役

跟着做

步骤 1：生产环境配置检查清单

config/environments/production.rb：

Rails.application.configure do
  config.cache_classes = true
  config.eager_load = true
  config.consider_all_requests_local = false   # 不暴露完整错误栈
  config.force_ssl = true                       # 强制 HTTPS
  config.public_file_server.enabled = ENV["RAILS_SERVE_STATIC_FILES"].present?
  config.active_storage.variant_processor = :mini_magick
  config.log_level = :info
  config.logger = ActiveSupport::Logger.new(STDOUT)
end

上线前必做三件事（顺序不可乱）：

# 1. 预编译资产（CSS/JS 指纹化）
RAILS_ENV=production bin/rails assets:precompile

# 2. 跑数据库迁移（新增/改表）
RAILS_ENV=production bin/rails db:migrate

# 3. 重启 Puma 进程加载新代码

步骤 2：Puma 配置

config/puma.rb：

workers ENV.fetch("WEB_CONCURRENCY", 2)
threads_count = ENV.fetch("RAILS_MAX_THREADS", 5)
threads threads_count, threads_count

preload_app!

on_worker_boot do
  ActiveRecord::Base.establish_connection if defined?(ActiveRecord)
end

• workers：进程数，按 CPU 核心数设（通常是核心数或核心数+1）
• threads：每个 worker 的线程数，影响并发连接数
• preload_app!：启动时预加载应用，节省内存（Copy-on-Write）

环境变量：

export WEB_CONCURRENCY=2       # 2 个 worker 进程
export RAILS_MAX_THREADS=5     # 每个 5 线程
export RAILS_ENV=production
export RAILS_MASTER_KEY=...    # 解密 credentials 的密钥