discourse/ruby

Discourse Ruby 镜像文档

镜像概述

Discourse Ruby镜像是由Discourse团队维护的Ruby运行环境镜像，旨在提供稳定、优化的Ruby执行环境，支持多种Ruby版本及应用场景。该镜像基于官方Ruby基础镜像构建，针对性能、兼容性及开发效率进行了优化，特别适用于Discourse项目及各类Ruby应用的开发与部署。

核心功能与特性

• 多版本支持：提供多种Ruby版本标签（如2.7、3.0、3.2等），满足不同应用对Ruby版本的需求
• 预配置依赖：内置常用系统库及Ruby依赖（如Bundler、rake等），减少环境配置步骤
• 优化运行环境：针对生产环境进行性能调优，包含资源限制、日志处理等基础配置
• Discourse兼容性：专为Discourse论坛系统设计，确保与Discourse源代码及插件生态的兼容性
• 轻量级设计：基于Alpine或Debian slim基础镜像，平衡功能与镜像体积

使用场景

• Ruby应用开发：本地开发环境搭建，快速启动Ruby解释器及相关工具链
• 生产环境部署：部署Ruby Web应用（如Rails、Sinatra应用）至服务器或容器平台
• Discourse项目构建：Discourse论坛系统的本地开发、测试及生产环境部署
• CI/CD流程集成：作为持续集成/部署流程中的构建或运行环境，确保环境一致性

使用方法与配置说明

基本使用（docker run）

1. 运行Ruby交互式终端

bash
docker run -it --rm docker.xuanyuan.run/discourse/ruby:latest irb

2. 执行Ruby脚本

将本地脚本挂载至容器并执行：

bash
docker run --rm -v $(pwd):/app -w /app docker.xuanyuan.run/discourse/ruby:3.2 ruby script.rb

3. 指定Ruby版本

通过镜像标签指定具体Ruby版本（例如3.2）：

bash
docker run --rm docker.xuanyuan.run/discourse/ruby:3.2 ruby -v # 输出 Ruby 3.2.x

Docker Compose 配置示例

创建docker-compose.yml文件，用于部署Ruby应用：

yaml
version: '3.8'
services:
  ruby-app:
    image: docker.xuanyuan.run/discourse/ruby:3.2
    volumes:
      - ./app:/app  # 挂载本地应用代码
      - bundle_data:/usr/local/bundle  # 持久化Bundler依赖
    working_dir: /app
    command: bundle exec rails server -b 0.0.0.0
    ports:
      - "3000:3000"
    environment:
      - RAILS_ENV=production
      - DATABASE_URL=postgres://user:password@db:5432/app_db

volumes:
  bundle_data:  # 用于缓存Ruby依赖，加速后续启动

环境变量说明

高级配置

1. 自定义Bundler配置

在容器启动时覆盖Bundler配置：

bash
docker run --rm -e BUNDLE_WITHOUT="" docker.xuanyuan.run/discourse/ruby:latest bundle install

2. 与数据库联动（以PostgreSQL为例）

yaml
# docker-compose.yml
version: '3'
services:
  app:
    image: docker.xuanyuan.run/discourse/ruby:3.2
    depends_on:
      - db
    environment:
      - DATABASE_URL=postgres://postgres:postgres@db:5432/myapp
  db:
    image: docker.xuanyuan.run/postgres:14
    environment:
      - POSTGRES_PASSWORD=postgres

注意事项

• 镜像标签规则：discourse/ruby:<ruby-version>（如3.2），建议生产环境使用具体版本标签而非latest，避免版本变更风险
• 依赖缓存：通过挂载bundle_data卷可缓存Bundler依赖，大幅减少重复安装时间
• 官方文档：完整配置及更新日志请参考GitHub仓库：https://github.com/discourse/docker-ruby
• 系统依赖：若应用需要额外系统库，可通过Dockerfile基于此镜像构建自定义镜像，例如：

  dockerfile
  FROM discourse/ruby:3.2
  RUN apt-get update && apt-get install -y some-package