zenjoy/ruby

docker-ruby 镜像文档

镜像概述和主要用途

zenjoy/ruby 是基于 Debian 官方 Docker 镜像构建的 Ruby 环境镜像，旨在提供稳定、轻量且跨架构的 Ruby 运行环境。该镜像整合了 Debian 的系统稳定性与 Ruby 的开发灵活性，适用于 Ruby 应用的开发、测试及生产部署场景。

核心功能和特性

• 基于 Debian 官方镜像：继承 Debian 系统的稳定性与安全性，提供可靠的底层运行环境。
• 多架构支持：同时支持 AMD64（x86_64）和 ARM64（aarch64）架构，适配多种硬件平台。
• 双仓库分发：可从 https://hub.docker.com/r/zenjoy/ruby 和 GitHub Container Registry (GHCR) 拉取镜像，提升访问灵活性。
• 镜像签名验证：所有镜像通过 Cosign 进行 keyless 签名，支持完整性验证，确保镜像未被篡改。

使用场景和适用范围

• Ruby 应用开发环境：本地开发 Ruby 脚本或应用，无需手动配置系统 Ruby 版本。
• CI/CD 流程集成：作为自动化构建、测试环节的基础镜像，确保环境一致性。
• 生产环境部署：轻量级部署 Ruby 服务（如 Sinatra、Rack 应用等），依赖 Debian 基础保障运行稳定性。
• 跨架构应用测试：在 AMD64 和 ARM64 平台上验证 Ruby 应用兼容性。

使用方法和配置说明

拉取镜像

从 Docker Hub 拉取

sh
docker pull zenjoy/ruby:latest

从 GHCR 拉取

sh
docker pull ghcr.io/zenjoy/ruby:latest

注：可通过指定标签（如 3.2-slim）拉取特定 Ruby 版本，具体标签请参考 https://hub.docker.com/r/zenjoy/ruby/tags%E3%80%82

验证镜像完整性

所有镜像通过 Cosign keyless 签名，可通过以下命令验证完整性：

sh
cosign verify \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com \
  --certificate-identity-regexp https://github.com/zenjoy/docker-ruby/.github/workflows/ \
  zenjoy/ruby:latest

参数说明：

• --certificate-oidc-issuer：指定签名证书的 OIDC 签发者（GitHub Actions 令牌服务）。
• --certificate-identity-regexp：验证签名者身份与仓库 CI 工作流匹配。

运行容器示例

基本运行（检查 Ruby 版本）

sh
docker run --rm zenjoy/ruby:latest ruby -v
# 输出示例：ruby 3.2.2 (2023-03-30 revision e51014f9c0) [x86_64-linux-gnu]

运行 Ruby 脚本

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

sh
docker run --rm -v $(pwd):/app -w /app zenjoy/ruby:latest ruby app.rb

参数说明：

• -v $(pwd):/app：挂载当前目录到容器内 /app 路径。
• -w /app：设置工作目录为 /app。

Docker Compose 配置示例

创建 docker-compose.yml 文件，部署简单 Ruby 应用：

yaml
version: '3.8'
services:
  ruby-app:
    image: zenjoy/ruby:latest
    volumes:
      - ./src:/app  # 挂载应用代码目录
    working_dir: /app
    command: ruby server.rb  # 运行应用入口脚本
    ports:
      - "4567:4567"  # 映射端口（假设应用监听 4567）
    environment:
      - RUBY_ENV=production  # 设置环境变量（如生产环境标识）
      - RUBYOPT=-W0  # 自定义 Ruby 运行参数（禁用警告）

启动服务：

sh
docker-compose up -d

配置说明

该镜像基于 Debian 和 Ruby 官方配置，默认继承以下特性：

• 系统依赖：包含 Ruby 运行所需的基础库（如 libc6、zlib1g 等）。
• Ruby 配置：默认加载 rubygems，支持 gem install 安装依赖。

可通过以下方式自定义配置：

• 环境变量：设置 RUBY_ENV（环境标识）、RUBYOPT（Ruby 运行参数）、GEM_HOME（gem 安装路径）等。
• 挂载配置文件：如挂载 ~/.gemrc 自定义 gem 源。

贡献指南

欢迎通过以下方式参与改进：

• 提交 https://github.com/zenjoy/docker-ruby/issues 反馈问题或建议。
• 提交 https://github.com/zenjoy/docker-ruby/pulls 贡献代码或文档优化。

许可证信息

镜像包含软件的许可证信息请参考 https://github.com/zenjoy/docker-ruby/blob/main/LICENSE%E3%80%82