productiveio/ruby

Ruby (基于Amazon Linux 2023) 镜像文档

镜像概述

本镜像是基于Amazon Linux 2023操作系统构建的Ruby运行环境镜像，集成了Ruby解释器及必要的依赖组件，旨在为Ruby应用程序提供稳定、安全的容器化运行环境，适用于从开发测试到生产部署的全流程场景。

核心功能与特性

• 稳定基础：基于Amazon Linux 2023，提供长期支持的系统环境，确保运行稳定性。
• Ruby集成：预装Ruby解释器及相关工具（如gem包管理器），满足Ruby应用运行需求。
• 安全合规：遵循Amazon Linux的安全更新机制，定期接收系统安全补丁。
• 轻量设计：优化镜像体积，减少不必要组件，提升部署效率。

使用场景与适用范围

• 开发环境：作为本地Ruby应用开发的一致环境，避免"本地能跑，线上不行"的环境差异问题。
• 应用部署：容器化部署Ruby Web应用（如Rails、Sinatra）、命令行工具等各类Ruby程序。
• CI/CD流程：集成到持续集成/持续部署管道，用于Ruby应用的自动化构建、测试。
• 学习环境：快速搭建Ruby学习环境，无需手动配置系统依赖。

使用方法与配置说明

获取镜像

从Docker镜像仓库拉取（请将<镜像仓库地址>替换为实际仓库地址）：

bash
docker pull docker.xuanyuan.run/<镜像仓库地址>/amazonlinux2023-ruby:latest

基本运行示例

1. 启动交互式Ruby解释器

bash
docker run -it --rm docker.xuanyuan.run/<镜像仓库地址>/amazonlinux2023-ruby irb

• -it：交互式终端模式
• --rm：退出后自动删除容器
• irb：启动Ruby交互式解释器

2. 运行本地Ruby脚本

假设本地存在app.rb文件：

ruby
puts "Hello, Ruby on Amazon Linux 2023!"

通过挂载本地目录运行：

bash
docker run --rm -v $(pwd):/app -w /app docker.xuanyuan.run/<镜像仓库地址>/amazonlinux2023-ruby ruby app.rb

• -v $(pwd):/app：将当前目录挂载到容器内/app目录
• -w /app：设置工作目录为/app
• ruby app.rb：执行目标脚本

3. Docker Compose部署示例

创建docker-compose.yml：

yaml
version: '3'
services:
  ruby-app:
    image: docker.xuanyuan.run/<镜像仓库地址>/amazonlinux2023-ruby:latest
    volumes:
      - ./app:/app  # 挂载应用代码目录
    working_dir: /app
    command: ruby main.rb  # 启动命令

启动服务：

bash
docker-compose up

环境变量配置

常用环境变量说明：

示例：自定义gem安装路径

bash
docker run -it --rm -e GEM_HOME=/root/.gem docker.xuanyuan.run/<镜像仓库地址>/amazonlinux2023-ruby irb

数据持久化

挂载gem目录以持久化安装的包：

bash
docker run -it --rm -v ~/.ruby-gems:/usr/local/bundle docker.xuanyuan.run/<镜像仓库地址>/amazonlinux2023-ruby irb

本地~/.ruby-gems目录将保存通过gem install安装的包。

扩展配置

如需安装系统依赖（如编译原生扩展工具），可通过root用户执行yum命令：

bash
docker run -it --rm --user root docker.xuanyuan.run/<镜像仓库地址>/amazonlinux2023-ruby yum install -y gcc make

注意事项

• 生产环境建议使用指定版本标签（如ruby-3.2）而非latest，确保环境一致性。
• 推荐使用非root用户运行容器，通过--user参数指定普通用户。
• 定期更新镜像以获取最新安全补丁和Ruby版本更新。