wodby/ruby

wodby/ruby Docker镜像文档

概述

wodby/ruby是一个针对Ruby应用程序优化的Docker镜像，旨在提供稳定、高效的Ruby运行环境。该镜像由Wodby团队维护，集成了运行Ruby应用所需的核心依赖和配置，支持多种Ruby版本，适用于从开发环境到生产环境的全流程应用部署。

核心功能与特性

多版本支持

• 提供多种Ruby版本标签（如3.2, 3.1, 3.0等），满足不同应用的版本需求
• 标签格式通常为[RUBY_VERSION]-[VARIANT]，例如3.2-alpine（轻量级Alpine基础）或3.1-debian（Debian基础）

优化配置

• 预安装常用系统依赖（如build-essential, libpq-dev等），减少应用部署时的依赖安装步骤
• 内置RubyGems优化配置，加速gem安装
• 支持非root用户运行，增强容器安全性

灵活的环境定制

• 通过环境变量配置Ruby相关参数（如RUBY_ENV, BUNDLE_PATH等）
• 支持自定义启动命令和入口点
• 兼容主流Ruby应用部署模式（如Puma, Unicorn等服务器）

使用场景

开发环境

• 本地开发环境一致性保障，避免"在我电脑上能运行"问题
• 与Docker Compose集成，快速搭建包含Ruby、数据库、缓存等服务的完整开发栈

生产部署

• 用于生产环境中Ruby应用的容器化部署，确保环境一致性和可重复性
• 支持Kubernetes等容器编排平台，便于大规模应用管理

CI/CD流程

• 作为CI/CD流水线中的构建和测试环境，确保代码在标准Ruby环境中验证

使用方法

基本使用（docker run）

运行交互式Ruby控制台

bash
docker run --rm -it docker.xuanyuan.run/wodby/ruby:3.2 ruby -v

运行Ruby脚本

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

部署Rails应用

bash
docker run -d -p 3000:3000 \
  -v $(pwd):/app \
  -w /app \
  -e RAILS_ENV=production \
  -e DATABASE_URL=postgres://user:pass@db:5432/app \
  docker.xuanyuan.run/wodby/ruby:3.2 bundle exec rails server -b 0.0.0.0

Docker Compose示例

yaml
version: '3.8'

services:
  ruby:
    image: docker.xuanyuan.run/wodby/ruby:3.2
    volumes:
      - ./:/app
    working_dir: /app
    environment:
      - RUBY_ENV=development
      - BUNDLE_PATH=/app/vendor/bundle
    command: bundle exec rails server -b 0.0.0.0
    ports:
      - "3000:3000"
    depends_on:
      - db

  db:
    image: docker.xuanyuan.run/postgres:15
    environment:
      - POSTGRES_USER=user
      - POSTGRES_PASSWORD=pass
      - POSTGRES_DB=app

环境变量配置

版本标签说明

镜像标签格式为[RUBY_VERSION]-[BASE_IMAGE]-[TAG_SUFFIX]，例如：

• 3.2：基于最新稳定基础镜像的Ruby 3.2版本
• 3.2-alpine：基于Alpine Linux的轻量级Ruby 3.2版本
• 3.1-debian：基于Debian的Ruby 3.1版本

更多版本标签可参考https://hub.docker.com/r/wodby/ruby/tags。

数据持久化

为避免依赖包重复安装，建议将Bundler缓存目录挂载为卷：

bash
docker run -v bundle_cache:/usr/local/bundle docker.xuanyuan.run/wodby/ruby:3.2 bundle install

注意事项

• 生产环境中建议指定具体版本标签（如3.2.2）而非模糊版本（如3.2），确保版本一致性
• 非root用户运行时，需确保挂载的宿主机目录有适当权限
• 敏感配置（如数据库密码）建议通过环境变量或Docker Secrets管理，避免硬编码

相关链接

• 官方GitHub仓库：https://github.com/wodby/ruby
• Docker Hub镜像：https://hub.docker.com/r/wodby/ruby
• Wodby文档：[***]