mips64le/ruby

注意：这是https://hub.docker.com/_/ruby%E9%92%88%E5%AF%B9%60mips64le%60%E6%9E%B6%E6%9E%84%E6%9E%84%E5%BB%BA%E7%9A%84%22per-architecture%22%E4%BB%93%E5%BA%93%E2%80%94%E2%80%94%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%EF%BC%8C%E8%AF%B7%E5%8F%82%E8%A7%81%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8F%E6%96%87%E6%A1%A3%E4%B8%AD%E7%9A%84%22https://github.com/docker-library/official-images#architectures-other-than-amd64%22%E4%BB%A5%E5%8F%8A%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8FFAQ%E4%B8%AD%E7%9A%84%22https://github.com/docker-library/faq#an-images-source-changed-in-git-now-what%22%E3%80%82

快速参考

• 维护者：
  https://github.com/docker-library/ruby

• 获取帮助：
  Docker Community Slack、Server Fault、Unix & Linux 或 Stack Overflow

支持的标签及对应的 Dockerfile 链接

• https://github.com/docker-library/ruby/blob/26c507eea2fc314ad774636f40acac38233bf942/3.5-rc/bookworm/Dockerfile

• https://github.com/docker-library/ruby/blob/26c507eea2fc314ad774636f40acac38233bf942/3.5-rc/slim-bookworm/Dockerfile

• https://github.com/docker-library/ruby/blob/7b7c8319337974e0df7e809c2360027d873ab259/3.4/bookworm/Dockerfile

• https://github.com/docker-library/ruby/blob/7b7c8319337974e0df7e809c2360027d873ab259/3.4/slim-bookworm/Dockerfile

• https://github.com/docker-library/ruby/blob/26c507eea2fc314ad774636f40acac38233bf942/3.3/bookworm/Dockerfile

• https://github.com/docker-library/ruby/blob/26c507eea2fc314ad774636f40acac38233bf942/3.3/slim-bookworm/Dockerfile

• https://github.com/docker-library/ruby/blob/26c507eea2fc314ad774636f40acac38233bf942/3.2/bookworm/Dockerfile

• https://github.com/docker-library/ruby/blob/26c507eea2fc314ad774636f40acac38233bf942/3.2/slim-bookworm/Dockerfile

快速参考（续）

• 提交issues的位置：
  https://github.com/docker-library/ruby/issues?q=

• 支持的架构：(https://github.com/docker-library/official-images#architectures-other-than-amd64)
  https://hub.docker.com/r/amd64/ruby/%E3%80%81https://hub.docker.com/r/arm32v5/ruby/%E3%80%81https://hub.docker.com/r/arm32v6/ruby/%E3%80%81https://hub.docker.com/r/arm32v7/ruby/%E3%80%81https://hub.docker.com/r/arm64v8/ruby/%E3%80%81https://hub.docker.com/r/i386/ruby/%E3%80%81https://hub.docker.com/r/mips64le/ruby/%E3%80%81https://hub.docker.com/r/ppc64le/ruby/%E3%80%81https://hub.docker.com/r/riscv64/ruby/%E3%80%81https://hub.docker.com/r/s390x/ruby/

• 已发布镜像 artifact 详情：
  https://github.com/docker-library/repo-info/blob/master/repos/ruby (https://github.com/docker-library/repo-info/commits/master/repos/ruby)
  （镜像元数据、传输大小等）

• 镜像更新：
  https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fruby
  https://github.com/docker-library/official-images/blob/master/library/ruby (https://github.com/docker-library/official-images/commits/master/library/ruby)

• 本描述的来源：
  https://github.com/docker-library/docs/tree/master/ruby (https://github.com/docker-library/docs/commits/master/ruby)

什么是 Ruby？

Ruby是一种动态、反射式、面向对象的通用开源编程语言。据其作者介绍，Ruby受Perl、Smalltalk、Eiffel、Ada和Lisp的影响。它支持多种编程范式，包括函数式、面向对象和命令式。它还具有动态类型系统和自动内存管理。

***.org/wiki/Ruby_(programming_language)

!https://raw.githubusercontent.com/docker-library/docs/01c***b2fe592c1f93a13b4e289ada0e3a1/ruby/logo.png

如何使用本镜像

在 Ruby 应用项目中创建 Dockerfile

dockerfile
FROM mips64le/ruby:3.3

# 如果 Gemfile 自 Gemfile.lock 修改后发生变化，则抛出错误
RUN bundle config --global frozen 1

WORKDIR /usr/src/app

COPY Gemfile Gemfile.lock ./
RUN bundle install

COPY . .

CMD ["./your-daemon-or-script.rb"]

将此文件放在应用的根目录下，与 Gemfile 同级。

然后可以构建并运行 Ruby 镜像：

console
$ docker build -t my-ruby-app .
$ docker run -it --name my-running-script my-ruby-app

生成 Gemfile.lock

上述 Dockerfile 示例需要应用目录中存在 Gemfile.lock。以下 docker run 命令可帮助生成该文件。在应用根目录（与 Gemfile 同级）中运行：

console
$ docker run --rm -v "$PWD":/usr/src/app -w /usr/src/app mips64le/ruby:3.3 bundle install

运行单个 Ruby 脚本

对于许多简单的单文件项目，编写完整的 Dockerfile 可能不太方便。这种情况下，可以直接使用 Ruby Docker 镜像运行 Ruby 脚本：

console
$ docker run -it --rm --name my-running-script -v "$PWD":/usr/src/myapp -w /usr/src/myapp mips64le/ruby:3.3 ruby your-daemon-or-script.rb

编码

默认情况下，Ruby 继承其运行环境的 locale。对于大多数在桌面系统上运行 Ruby 的用户，这可能意味着使用某种 *.UTF-8 变体（如 en_US.UTF-8 等）。然而在 Docker 中，默认 locale 是 C，这可能导致意外结果。如果应用需要处理 UTF-8，建议通过 -e LANG=C.UTF-8 或 ENV LANG C.UTF-8 显式调整镜像/容器的 locale。

镜像假设

本镜像设置了多个环境变量，这些变量会改变 Bundler 和 Gem 在容器内运行单个应用时的行为（特别是允许将应用的开发源代码 bind-mount 到容器内，且避免主机的 .bundle 干扰容器的正常功能）。

我们设置的环境变量在上述链接的 Dockerfiles 中有明确列出，其中包括 GEM_HOME、BUNDLE_SILENCE_ROOT_WARNING 和 BUNDLE_APP_CONFIG 等。

如果这些变量对您的使用场景造成问题（例如在单个容器中运行多个 Ruby 应用），将它们设置为空字符串应足以取消其影响。

镜像变体

mips64le/ruby 镜像有多种版本，每种版本针对特定使用场景设计。

mips64le/ruby:<version>

这是默认镜像。如果不确定自己的需求，建议使用此版本。它既可用作临时容器（挂载源代码并启动容器以运行应用），也可用作构建其他镜像的基础。

部分标签可能包含如 bookworm 之类的名称，这些是 Debian 发行版的代号，表示镜像基于哪个发行版构建。如果您的镜像需要安装超出镜像自带的额外软件包，建议显式指定其中一个代号，以减少 Debian 新版本发布时可能出现的问题。

此标签基于 https://hub.docker.com/_/buildpack-deps/%E3%80%82%60buildpack-deps%60 面向拥有多个镜像的普通 Docker 用户设计，包含大量极为常见的 Debian 软件包。这减少了基于它构建的镜像所需安装的软件包数量，从而减小系统上所有镜像的总体大小。

mips64le/ruby:<version>-slim

此镜像不包含默认标签中的常见软件包，仅包含运行 mips64le/ruby 所需的最小软件包。除非您的环境中仅部署 mips64le/ruby 镜像且存在空间限制，否则强烈建议使用本仓库的默认镜像。

许可

查看本镜像所包含软件的许可信息。

与所有 Docker 镜像一样，这些镜像可能还包含其他软件，这些软件可能采用其他许可（如基础发行版中的 Bash 等，以及主要软件的任何直接或间接依赖项）。

一些能够自动检测到的额外许可信息可能位于 https://github.com/docker-library/repo-info/tree/master/repos/ruby%E4%B8%AD%E3%80%82

对于任何预构建镜像的使用，确保对镜像中包含的所有软件的使用符合相关许可，是镜像用户的责任。