mutations/rails

Rails应用基础镜像文档

镜像概述

本镜像为Rails应用程序提供基础运行环境，基于轻量级设计，包含Ruby运行时、Rails框架依赖及常用系统库，确保Rails应用可快速部署。同时提供扩展变体版本，集成LibreOffice等额外软件包，满足文档处理、格式转换等进阶需求。

核心功能与特性

基础环境支持

• 预装Ruby（版本匹配主流Rails兼容性）及Rails运行必需依赖（如Node.js、Yarn、数据库客户端驱动）
• 包含基础系统库（如libpq-dev、sqlite3、build-essential），减少应用部署时的依赖安装步骤

轻量级与兼容性

• 基于官方Ruby镜像优化，最小化镜像体积，降低部署资源消耗
• 兼容主流Rails版本（建议Rails 5+），支持Bundler依赖管理

多变体支持

• 提供基础版（仅含Rails运行环境）和扩展版（集成LibreOffice等工具）两种镜像标签，可按需选择
• 扩展版包含LibreOffice套件，支持文档格式转换（如DOCX→PDF）、图文处理等功能

使用场景

• Rails应用开发与测试：作为本地开发或CI/CD流程中的基础环境，统一开发与部署环境
• 生产环境部署：适用于中小规模Rails应用的容器化部署，简化服务器配置
• 文档处理类应用：需集成办公文档解析、格式转换功能的Rails应用（如内容管理系统、在线文档工具）

使用方法

基础版镜像使用

直接运行容器

bash
docker run -d -p 3000:3000 -v $(pwd):/app -e RAILS_ENV=production my-rails-app:latest

• -v $(pwd):/app：挂载本地Rails项目目录至容器内/app路径
• -e RAILS_ENV=production：指定Rails运行环境（默认值为development）

Docker Compose配置示例

yaml
version: '3'
services:
  rails-app:
    image: [镜像名称]:base  # 基础版标签
    ports:
      - "3000:3000"
    environment:
      - RAILS_ENV=production
      - DATABASE_URL=postgres://user:password@db:5432/rails_db
    volumes:
      - ./app:/app
      - bundle:/usr/local/bundle  # 挂载Bundler缓存，加速依赖安装
    depends_on:
      - db

  db:
    image: postgres:14
    environment:
      - POSTGRES_USER=user
      - POSTGRES_PASSWORD=password
      - POSTGRES_DB=rails_db
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  bundle:
  postgres_data:

扩展版（含LibreOffice）使用

需指定扩展版标签（如:with-libreoffice）：

bash
docker run -d -p 3000:3000 -v $(pwd):/app -e RAILS_ENV=production my-rails-app:with-libreoffice

扩展版可在Rails应用中通过系统命令调用LibreOffice功能，例如文档转换：

ruby
# Rails代码示例：使用LibreOffice将DOCX转换为PDF
system('libreoffice --headless --convert-to pdf /app/documents/input.docx --outdir /app/documents/output')

配置参数

环境变量

卷挂载建议

• /app：挂载Rails项目目录，实现代码热更新（开发环境）
• /usr/local/bundle：挂载Bundler缓存卷，避免重复安装依赖
• /app/public：挂载静态资源目录（生产环境建议）

注意事项

• 生产环境使用时，建议通过RAILS_ENV=production指定环境，并配置数据库连接参数
• 扩展版镜像体积较大（因包含LibreOffice），非必要场景建议使用基础版
• 需根据Rails应用所需Ruby版本选择对应镜像标签（如my-rails-app:ruby-3.2）