zenjoy/dev-environments-ruby

多架构 Ruby Docker 镜像

镜像概述和主要用途

本镜像为多架构 Docker 镜像，提供 Ruby 与 Ubuntu 操作系统的组合环境，支持多种硬件架构和版本组合，适用于跨平台的 Ruby 应用开发、测试及部署场景。

核心功能和特性

1. 版本组合支持

• Ruby 版本：2.6、2.7、3.0、3.1
• Ubuntu 版本：18.04 LTS、20.04 LTS

2. 多架构支持

镜像可运行于以下平台：

• linux/amd64（适用于 Intel/AMD 处理器）
• linux/arm64（适用于 Apple M1/M2 等 ARM64 架构）
• linux/arm/v7（适用于树莓派等 ARMv7 架构设备）

3. 兼容性

基于官方 Ubuntu LTS 镜像构建，确保系统依赖稳定性；Ruby 版本与官方 Ruby 镜像兼容，可直接迁移现有 Ruby 应用。

使用场景和适用范围

1. 跨平台开发环境

为开发者提供一致的本地开发环境，无论使用 x86 架构（如 PC）还是 ARM 架构（如 Mac M 系列、树莓派）。

2. CI/CD 流程集成

作为自动化构建、测试环节的基础镜像，支持在不同架构的 CI 节点上运行 Ruby 应用测试。

3. 生产环境部署

适用于需要跨架构部署的 Ruby 应用（如同时部署到云服务器 x86 节点和边缘设备 ARM 节点）。

使用方法和配置说明

镜像标签格式

镜像标签遵循 <ruby-version>-ubuntu<ubuntu-version> 规则，例如：

• Ruby 2.7 + Ubuntu 20.04 LTS：2.7-ubuntu20.04
• Ruby 3.1 + Ubuntu 18.04 LTS：3.1-ubuntu18.04

基础使用步骤

1. 拉取镜像

从镜像仓库拉取指定版本的镜像（以 Ruby 3.0 + Ubuntu 20.04 为例）：

bash
docker pull [镜像仓库地址]/ruby:3.0-ubuntu20.04

注：请将 [镜像仓库地址] 替换为实际镜像仓库（如 Docker Hub 用户名/仓库名）。

2. 运行容器

基本用法（交互式终端，验证 Ruby 版本）：

bash
docker run -it --rm [镜像仓库地址]/ruby:2.7-ubuntu18.04 ruby -v

输出示例：ruby 2.7.8p225 (2023-03-28 revision 1f4d455848) [x86_64-linux-gnu]

挂载本地代码目录（开发场景）：

bash
docker run -it --rm -v $(pwd):/app -w /app [镜像仓库地址]/ruby:3.1-ubuntu20.04

此命令将当前目录挂载到容器内 /app 目录，并进入工作目录，可直接运行本地 Ruby 脚本。

3. Docker Compose 配置示例

创建 docker-compose.yml 文件，定义 Ruby 服务：

yaml
version: '3'
services:
  ruby-app:
    image: [镜像仓库地址]/ruby:3.0-ubuntu20.04
    volumes:
      - ./src:/app  # 挂载本地代码目录
    working_dir: /app
    command: ruby main.rb  # 运行应用入口脚本
    environment:
      - RUBY_ENV=development  # 示例环境变量

启动服务：

bash
docker-compose up

注意事项

• 若需指定架构（如在 ARM64 主机上拉取 amd64 镜像），可通过 docker pull --platform linux/amd64 [镜像标签] 实现。
• 生产环境建议结合持久化存储（如 volumes）和健康检查配置，确保应用稳定性。
• 镜像标签中的 Ruby 和 Ubuntu 版本需匹配支持的组合（如 Ruby 2.6 可搭配 Ubuntu 18.04/20.04）。