symbols/minimal-ruby

docker-minimal-ruby 镜像文档

镜像概述和主要用途

docker-minimal-ruby是一个基于Alpine Linux和RVM（Ruby Version Manager）的最小化Ruby运行环境镜像。该镜像通过单个层实现Ruby安装，并在构建过程中自动清理冗余文件，不保留任何开发工具，以确保极小的镜像体积。适用于需要轻量级Ruby环境的应用场景，如微服务部署、CI/CD流程或资源受限环境。

核心功能和特性

• 最小化设计：单个层完成RVM和Ruby安装，构建后自动清理临时文件和开发工具，确保镜像精简
• 历史版本支持：维护回溯至Ruby 2.1.6的历史版本
• Alpine版本兼容：提供基于Alpine 3.4和Alpine 3.5的两种标签集
• 自动更新机制：当对应Alpine分支发布新版本时，镜像会自动重建
• 轻量级体积：压缩后镜像大小约32Mb，显著小于传统Ruby镜像

使用场景和适用范围

• 轻量级Ruby应用部署
• 微服务架构中的Ruby服务节点
• CI/CD流水线中的Ruby环境构建
• 资源受限的容器化环境
• 需要特定Ruby历史版本的遗留应用

使用方法和配置说明

标签说明

该镜像提供多种标签以满足不同版本需求：

• :latest：始终指向最新稳定Ruby版本和最新稳定Alpine 3.5
• Major/Minor标签：如2.2，指向该次要版本的最新稳定Ruby和Alpine 3.5（例如2.2对应Ruby 2.2.6和Alpine 3.5）
• 特定Alpine版本标签：格式为<ruby-version>_<alpine-version>，如2.3_3.4表示使用Ruby 2.3.3和Alpine 3.4

基本使用示例

直接运行Ruby交互模式

bash
docker run -it --rm gh2k/docker-minimal-ruby:latest ruby -v

运行Ruby脚本

bash
docker run -it --rm -v $(pwd):/app -w /app gh2k/docker-minimal-ruby:2.7 ruby script.rb

docker-compose配置示例

yaml
version: '3'
services:
  ruby-app:
    image: gh2k/docker-minimal-ruby:2.6_3.5
    volumes:
      - ./app:/app
    working_dir: /app
    command: ruby main.rb

注意事项

• 开发工具依赖：由于镜像已清理开发工具，安装需要编译依赖的gem（如Nokogiri）时，需临时安装相关工具（如build-base、libxml2-dev等），使用后建议清理以保持镜像精简
• 版本兼容性：特定Ruby版本可能与不同Alpine版本存在兼容性差异，建议使用明确的标签（如2.3_3.4）确保环境一致性
• 镜像更新：Alpine基础镜像更新时，对应标签的镜像会自动重建，建议定期更新镜像以获取安全补丁