woahbase/alpine-ruby

alpine-ruby

镜像概述和主要用途

alpine-ruby是一个多架构的Docker镜像，基于Alpine Linux构建，集成了S6进程管理工具和Ruby运行环境。该镜像旨在提供轻量级、高效的Ruby应用运行环境，支持多种硬件架构，适用于开发、测试及生产环境中的Ruby应用部署。由WOAHBase维护，更多详细文档、镜像资源和源码可访问官方文档、https://hub.docker.com/r/woahbase/alpine-ruby%E5%92%8Chttps://github.com/woahbase/alpine-ruby%E3%80%82

核心功能和特性

多架构支持

• 全面支持多种硬件架构，包括：x86_64、aarch64、armv7l、armhf、i386、ppc64le、riscv64、s390x等，满足不同平台的部署需求。

轻量级基础

• 基于Alpine Linux，具备体积小、资源占用低的特点，镜像尺寸针对各架构进行优化，提升部署效率和运行性能。

集成S6进程管理

• 内置S6进程管理工具，提供可靠的进程监控与管理能力，确保Ruby应用及依赖服务稳定运行。

预装Ruby环境

• 集成Ruby运行环境，可直接用于Ruby应用的开发、测试和运行，无需额外配置基础依赖。

使用场景和适用范围

• 开发环境：快速搭建一致的Ruby开发环境，避免本地环境差异带来的问题。
• 轻量级应用部署：部署Ruby编写的微服务、CLI工具或小型Web应用（如Sinatra、Rack应用）。
• CI/CD流程：作为持续集成/持续部署 pipeline中的Ruby运行环境，执行测试、构建等任务。
• 多架构应用开发：针对跨架构部署需求，验证Ruby应用在不同硬件平台上的兼容性。

使用方法和配置说明

拉取镜像

通过Docker Hub拉取最新版本镜像：

bash
docker pull woahbase/alpine-ruby

如需指定架构，可使用架构标签（如x86_64、aarch64等）：

bash
# 拉取x86_64架构镜像
docker pull woahbase/alpine-ruby:x86_64

# 拉取aarch64架构镜像
docker pull woahbase/alpine-ruby:aarch64

基本使用示例

验证Ruby版本

运行容器并查看Ruby版本：

bash
docker run -it --rm woahbase/alpine-ruby ruby -v

运行Ruby脚本

将本地Ruby脚本挂载到容器中执行：

bash
# 假设当前目录下有script.rb文件
docker run -it --rm -v $(pwd):/app -w /app woahbase/alpine-ruby ruby script.rb

交互式Ruby环境

启动irb交互式Ruby环境：

bash
docker run -it --rm woahbase/alpine-ruby irb

高级配置

自定义启动命令

通过覆盖容器默认命令，运行自定义Ruby应用或命令：

bash
docker run -it --rm woahbase/alpine-ruby sh -c "gem install sinatra && ruby -e 'require \"sinatra\"; get(\"/\") { \"Hello from alpine-ruby\" }; run!'"

持久化数据

挂载卷以持久化Ruby gems或应用数据：

bash
# 持久化gem安装目录
docker run -it --rm -v ruby_gems:/usr/local/bundle woahbase/alpine-ruby gem install rails

多架构部署注意事项

• Docker会自动根据宿主机架构拉取对应版本镜像，无需额外配置。
• 如需在特定架构上构建或测试，可通过--platform参数指定（需Docker支持）：

  bash
  docker run --platform linux/arm64 -it --rm woahbase/alpine-ruby ruby -v
  

维护与支持

该镜像由WOAHBase维护，源码托管于GitHub，相关问题和贡献可通过https://github.com/woahbase/alpine-ruby/issues%E6%88%96https://github.com/woahbase/alpine-ruby/pulls%E6%8F%90%E4%BA%A4%E3%80%82