Rails Backend Docker 镜像

1. 镜像概述和主要用途

本镜像是基于 Ruby on Rails 框架构建的后端应用运行环境，旨在提供标准化、可移植的 Rails 后端服务部署方案。镜像内置 Ruby 运行时、Rails 核心依赖及常用工具链，支持快速启动 Rails 应用后端，适用于各类 Web 应用、API 服务及微服务架构场景。

2. 核心功能和特性

2.1 框架支持

• 基于最新稳定版 Ruby 及 Rails 构建，兼容 Rails 5.x/6.x/7.x 应用
• 内置 MVC 架构支持、Active Record ORM、Action Pack 路由系统

2.2 运行环境优化

• 预配置 Bundler 依赖管理工具，支持 Gemfile 自动解析
• 多阶段构建优化，减小镜像体积（生产环境镜像约 300-500MB）
• 内置 Puma 应用服务器，支持多进程/多线程配置，优化并发性能

2.3 生态集成

• 支持 PostgreSQL、MySQL、SQLite 等主流数据库适配器
• 兼容 Redis、Memcached 缓存服务
• 集成 Action Cable 实时通信支持
• 支持 Sidekiq/Resque 后台任务处理

2.4 安全与合规

• 内置生产环境安全配置基线（禁用调试模式、强制 HTTPS 重定向等）
• 自动生成安全相关环境变量提示（如 SECRET_KEY_BASE）

3. 使用场景和适用范围

4. 使用方法和配置说明

4.1 镜像获取

公共镜像（Docker Hub）

bash
docker pull rails/backend:latest  # 最新稳定版
docker pull rails/backend:7.0     # 指定 Rails 7.0 版本

私有仓库

bash
docker pull [私有仓库地址]/rails-backend:prod  # 生产环境镜像

4.2 基本运行命令

最简启动（开发环境）

bash
docker run -p 3000:3000 rails/backend:latest

带环境变量的生产环境启动

bash
docker run -d \
  -p 80:3000 \
  -e RAILS_ENV=production \
  -e SECRET_KEY_BASE=$(openssl rand -hex 64) \
  -e DATABASE_URL=postgres://user:pass@db-host:5432/app_db \
  -e RAILS_LOG_TO_STDOUT=true \
  --name rails-backend \
  rails/backend:latest

4.3 Docker Compose 配置示例

生产环境配置（含数据库和 Redis）

yaml
# docker-compose.yml
version: '3.8'

services:
  backend:
    image: rails/backend:7.0
    restart: always
    ports:
      - "80:3000"
    environment:
      RAILS_ENV: production
      SECRET_KEY_BASE: "your-64-byte-secret-key"  # 建议通过环境变量注入
      DATABASE_URL: "postgres://postgres:postgres@db:5432/app_prod"
      REDIS_URL: "redis://redis:6379/0"
      RAILS_MAX_THREADS: 5
      PUMA_WORKERS: 2
    depends_on:
      - db
      - redis
    volumes:
      - rails_uploads:/app/public/uploads  # 持久化用户上传文件
      - rails_logs:/app/log                # 日志持久化

  db:
    image: postgres:14
    volumes:
      - postgres_data:/var/lib/postgresql/data
    environment:
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: postgres
      POSTGRES_DB: app_prod

  redis:
    image: redis:7-alpine
    volumes:
      - redis_data:/data

volumes:
  postgres_data:
  redis_data:
  rails_uploads:
  rails_logs:

启动服务：

bash
docker-compose up -d  # 后台启动所有服务
docker-compose logs -f  # 查看实时日志

4.4 核心环境变量说明

4.5 数据持久化

关键目录挂载

示例：绑定宿主机目录

bash
docker run -d \
  -v /opt/rails/uploads:/app/public/uploads \
  -v /opt/rails/logs:/app/log \
  --tmpfs /app/tmp \
  rails/backend:latest

4.6 自定义配置覆盖

通过环境变量注入配置

bash
# 覆盖 database.yml 中的数据库配置
docker run -e DB_HOST=custom-db -e DB_USER=admin -e DB_PASS=secret rails/backend:latest

通过外部配置文件挂载

bash
# 挂载自定义 database.yml
docker run -v $(pwd)/config/database.yml:/app/config/database.yml rails/backend:latest

5. 构建自定义镜像（适用于代码集成）

若需将业务代码集成到镜像中，可基于基础镜像构建自定义镜像：

Dockerfile 示例

dockerfile
# 基础镜像
FROM rails/backend:7.0 AS builder

# 设置工作目录
WORKDIR /app

# 复制 Gemfile 及依赖文件
COPY Gemfile Gemfile.lock ./
RUN bundle install --without development test

# 复制应用代码
COPY . .

# 预编译资产（生产环境）
RUN RAILS_ENV=production bundle exec rails assets:precompile

# 生产环境镜像（多阶段构建减小体积）
FROM rails/backend:7.0

WORKDIR /app

# 从 builder 阶段复制依赖和编译产物
COPY --from=builder /usr/local/bundle /usr/local/bundle
COPY --from=builder /app/public/assets /app/public/assets
COPY --from=builder /app/public/packs /app/public/packs
COPY . .

# 启动命令
CMD ["bundle", "exec", "puma", "-C", "config/puma.rb"]

构建与运行

bash
docker build -t my-rails-app:1.0 .
docker run -p 3000:3000 my-rails-app:1.0

6. 常见问题处理

6.1 数据库迁移

bash
# 进入容器执行迁移
docker exec -it rails-backend bundle exec rails db:migrate

# 或通过 docker-compose
docker-compose exec backend bundle exec rails db:migrate

6.2 日志查看

bash
docker logs -f rails-backend  # 实时查看日志
docker exec -it rails-backend tail -f log/production.log  # 查看具体日志文件

6.3 性能调优

• Puma 配置：通过 PUMA_WORKERS（进程数）和 RAILS_MAX_THREADS（线程数）调整并发能力，建议 WORKERS = CPU核心数 * 0.5 ~ 1
• 数据库连接池：在 database.yml 中设置 pool: <%= ENV.fetch("RAILS_MAX_THREADS") { 5 } %>，确保与 Puma 线程数匹配
• 缓存优化：启用 Redis 缓存（设置 REDIS_URL），减少数据库查询压力

注：生产环境部署需确保 SECRET_KEY_BASE 安全存储（建议通过密钥管理服务如 Vault 注入），并配置定期轮换机制。