Rails基础镜像文档

镜像概述和主要用途

Rails基础镜像是专为Ruby on Rails（RoR）应用设计的标准化容器基础环境，旨在提供预配置的运行时环境，减少开发与部署过程中的环境配置工作。该镜像集成Ruby运行时、Rails核心依赖及常用工具链，可直接作为Rails应用容器化构建的基础层，适用于从开发、测试到生产环境的全流程容器化需求。

核心功能和特性

• 预配置环境：内置指定版本的Ruby、Bundler及Rails核心依赖，无需手动安装基础组件
• 优化构建流程：支持多阶段构建，可分离构建依赖与运行时依赖，减小最终镜像体积
• 工具链集成：包含Node.js（用于资产编译）、Yarn、Git等常用开发/构建工具
• 兼容性设计：兼容主流Rails版本（5.x+）及Ruby版本（2.7+），适配不同应用场景
• 文件系统优化：采用层缓存策略，加速依赖安装与应用启动

使用场景和适用范围

适用场景

• 开发环境快速搭建：一键启动标准化Rails开发环境，避免"在我电脑上能运行"问题
• CI/CD流程集成：作为CI构建节点基础镜像，确保构建环境一致性
• 生产环境部署：可直接作为生产环境运行载体，配合多阶段构建优化资源占用

适用范围

• 中小型Rails Web应用
• Rails API服务
• 基于Rails的后台管理系统
• 需要容器化部署的Rails项目

使用方法和配置说明

基础使用流程

1. 拉取镜像
   从镜像仓库拉取指定版本（推荐指定Ruby/Rails版本标签）：

   bash
   docker pull rails-base-image:ruby3.2-rails7.0
   

2. 基本运行命令
   启动交互式终端（用于开发调试）：

   bash
   docker run -it --rm \
     -v $(pwd):/app \
     -p 3000:3000 \
     rails-base-image:ruby3.2-rails7.0 \
     bash
   

3. 启动Rails应用
   在容器内启动Rails服务器：

   bash
   # 容器内执行
   bundle install
   rails server -b 0.0.0.0
   

环境变量配置

数据持久化

通过挂载卷保存应用代码与数据：

bash
docker run -d \
  -v $(pwd):/app \  # 挂载当前目录作为应用代码
  -v rails-bundle:/usr/local/bundle \  # 持久化Ruby依赖
  -v rails-node_modules:/app/node_modules \  # 持久化Node依赖
  -p 3000:3000 \
  --name my-rails-app \
  rails-base-image:ruby3.2-rails7.0 \
  rails server -b 0.0.0.0

部署示例

docker-compose配置示例

yaml
version: '3.8'
services:
  web:
    image: rails-base-image:ruby3.2-rails7.0
    volumes:
      - .:/app
      - bundle:/usr/local/bundle
      - node_modules:/app/node_modules
    ports:
      - "3000:3000"
    environment:
      - RAILS_ENV=development
      - DATABASE_URL=postgres://user:pass@db:5432/myapp
    depends_on:
      - db
  db:
    image: postgres:14
    environment:
      - POSTGRES_USER=user
      - POSTGRES_PASSWORD=pass
      - POSTGRES_DB=myapp
    volumes:
      - pgdata:/var/lib/postgresql/data

volumes:
  bundle:
  node_modules:
  pgdata:

多阶段构建Dockerfile示例

dockerfile
# 构建阶段：安装依赖并编译资产
FROM rails-base-image:ruby3.2-rails7.0 AS builder
WORKDIR /app
COPY Gemfile* ./
RUN bundle install --without development test
COPY package.json yarn.lock ./
RUN yarn install
COPY . .
RUN RAILS_ENV=production bundle exec rails assets:precompile

# 运行阶段：仅保留运行时依赖
FROM rails-base-image:ruby3.2-rails7.0
WORKDIR /app
COPY --from=builder /usr/local/bundle /usr/local/bundle
COPY --from=builder /app/public/assets /app/public/assets
COPY --from=builder /app/node_modules /app/node_modules
COPY . .
ENV RAILS_ENV=production
CMD ["rails", "server", "-b", "0.0.0.0"]