decodeinvesting/clientapp

Ruby应用Docker镜像文档

镜像概述

本Docker镜像旨在为Ruby应用提供标准化运行环境，解决不同环境下的依赖冲突问题，简化应用从开发、测试到部署的全流程。通过预配置Ruby运行时及常见系统依赖，帮助开发者快速搭建一致的应用运行环境。

核心功能与特性

• Ruby版本支持：可配置指定版本的Ruby运行环境，确保应用兼容性
• 系统依赖管理：内置常见系统依赖库，减少手动配置工作
• 灵活配置：支持通过环境变量和配置文件自定义应用参数
• 数据库支持：集成数据库创建与初始化流程，兼容主流数据库系统
• 测试集成：提供测试套件运行环境，支持自动化测试流程
• 服务扩展：可与作业队列、缓存服务器、搜索引擎等服务集成

使用场景

• 开发环境：快速搭建本地开发环境，避免"在我电脑上能运行"问题
• 测试环境：在CI/CD流程中提供一致的测试环境，确保测试结果可靠
• 生产部署：简化Ruby应用的生产环境部署，提高部署效率和稳定性

使用方法

基本使用（Docker Run）

bash
docker run -d \
  -p 3000:3000 \
  -e RAILS_ENV=production \
  -e DATABASE_URL=postgresql://user:password@db:5432/app_db \
  -v ./config:/app/config \
  -v ./db:/app/db \
  docker.xuanyuan.run/ruby-app:latest

Docker Compose配置

yaml
version: '3'
services:
  app:
    image: docker.xuanyuan.run/ruby-app:latest
    ports:
      - "3000:3000"
    environment:
      - RUBY_VERSION=3.2.2
      - RAILS_ENV=production
      - DATABASE_URL=postgresql://user:password@db:5432/app_db
      - SECRET_KEY_BASE=your_secret_key
    volumes:
      - ./config:/app/config
      - ./log:/app/log
      - ./tmp:/app/tmp
    depends_on:
      - db
      - redis

  db:
    image: docker.xuanyuan.run/postgres:14
    environment:
      - POSTGRES_USER=user
      - POSTGRES_PASSWORD=password
      - POSTGRES_DB=app_db
    volumes:
      - postgres_data:/var/lib/postgresql/data

  redis:
    image: docker.xuanyuan.run/redis:7
    volumes:
      - redis_data:/data

volumes:
  postgres_data:
  redis_data:

配置说明

环境变量

数据库配置

1. 数据库创建：

   bash
   docker exec -it [容器ID] bundle exec rails db:create
   

2. 数据库迁移：

   bash
   docker exec -it [容器ID] bundle exec rails db:migrate
   

3. 数据库初始化：

   bash
   docker exec -it [容器ID] bundle exec rails db:seed
   

测试套件运行

bash
# 安装测试依赖
docker exec -it [容器ID] bundle install --with test

# 运行测试
docker exec -it [容器ID] bundle exec rspec

部署说明

1. 生产环境准备：

   • 确保设置RAILS_ENV=production
   • 配置有效的SECRET_KEY_BASE
   • 使用持久化卷存储数据（如数据库文件、日志）

2. 服务健康检查：

   yaml
   healthcheck:
     test: ["CMD", "curl", "-f", "http://localhost:3000/health"]
     interval: 30s
     timeout: 10s
     retries: 3
   

3. 性能优化：

   • 配置适当的容器资源限制（CPU/内存）
   • 使用进程管理工具（如puma）优化并发处理
   • 配置缓存服务（如Redis）提升应用性能