ascendhit/ruby-plus

Ruby Plus 镜像文档

镜像概述和主要用途

Ruby Plus镜像是基于官方Ruby镜像的扩展版本，旨在为Ruby应用提供更全面的依赖支持。它在基础Ruby镜像的基础上，添加了MySQL、PostgreSQL等常用数据库以及其他常见gems所需的必要系统库，简化了需要这些依赖的Ruby应用的环境配置过程，避免因缺少底层库导致的gems安装或运行失败问题。

核心功能和特性

• 基于官方Ruby镜像：完全继承Ruby官方镜像的所有功能和特性，确保与标准Ruby环境的兼容性和稳定性。
• 集成关键系统库：添加了MySQL客户端库、PostgreSQL客户端库等必要系统依赖，满足mysql2、pg等常用数据库gems的编译和运行需求。
• 简化依赖管理：预先配置了常用gems所需的底层依赖，减少Ruby应用在开发、测试或部署过程中的环境配置工作量。

使用场景和适用范围

Ruby Plus镜像适用于需要使用MySQL、PostgreSQL等数据库交互或依赖其他特定系统库的Ruby应用场景，包括：

• Ruby on Rails等Web框架应用的开发环境搭建
• 需要集成数据库功能的Ruby脚本或工具开发
• 持续集成/持续部署（CI/CD）流程中Ruby应用的构建和测试
• 对依赖环境一致性要求较高的Ruby应用容器化部署

使用方法和配置说明

构建镜像

通过以下命令从源码构建Ruby Plus镜像（需确保本地存在正确配置的Dockerfile）：

bash
docker build -t ascendhit/ruby-plus:5.0.0 .

参数说明：

• -t ascendhit/ruby-plus:5.0.0：指定镜像的名称和标签，格式为[仓库名]/[镜像名]:[版本标签]，可根据实际需求修改
• .：表示使用当前目录下的Dockerfile进行构建

推送镜像（可选）

若需将构建好的镜像推送到Docker仓库（如Docker Hub、私有仓库等），可执行以下命令：

bash
docker push ascendhit/ruby-plus:5.0.0

注意事项：

• 推送前需通过docker login命令登录目标Docker仓库
• 镜像名称需与仓库要求的命名规范一致（如Docker Hub需使用[用户名]/[镜像名]格式）

应用部署示例

在Ruby应用的Dockerfile中，可直接将Ruby Plus镜像作为基础镜像使用，示例如下：

dockerfile
# 使用构建好的Ruby Plus镜像作为基础镜像
FROM ascendhit/ruby-plus:5.0.0

# 设置工作目录
WORKDIR /app

# 复制应用代码和依赖文件
COPY Gemfile Gemfile.lock ./

# 安装应用依赖（此时可直接使用mysql2、pg等依赖镜像中已有的系统库）
RUN bundle install

# 复制应用其他代码
COPY . .

# 启动命令
CMD ["ruby", "app.rb"]

通过以上配置，应用可直接利用Ruby Plus镜像中预安装的系统库，无需在Dockerfile中额外添加apt-get install等依赖安装步骤。