Ruby 2.6容器镜像

概述

该容器镜像包含Ruby 2.6，作为源到镜像（S2I）基础镜像，用于构建和运行Ruby 2.6应用程序。用户可选择基于RHEL、CentOS或Fedora的构建器镜像：RHEL镜像可在Red Hat容器目录获取，CentOS镜像在Quay.io，Fedora镜像在Fedora Registry。生成的镜像可使用podman运行。

注意：本文档示例中使用podman命令，所有此类命令均可替换为docker，参数保持不变。

核心功能与特性

• 提供Ruby 2.6运行环境，支持构建和运行各类Ruby应用及框架
• 内置npm工具，方便安装Web应用所需的JavaScript模块（nodejs版本不固定，仅为支持npm功能）
• 支持S2I构建策略，简化OpenShift环境中的应用部署流程
• 包含标准化的应用构建和运行脚本，支持环境变量配置
• 支持热部署和性能调优，适应开发和生产环境需求

使用场景

• OpenShift平台上快速构建和部署Ruby 2.6应用
• 通过S2I策略实现自动化构建流程
• 使用Dockerfile灵活定制Ruby应用镜像（适用于非OpenShift环境或需要高度定制的场景）
• 开发环境中实现热部署，动态响应代码变更
• 生产环境中优化性能，调整线程和工作进程配置

使用方法

在OpenShift中使用

假设使用ubi8/ruby-26镜像（通过OpenShift中的ruby:2.6镜像流标签可用），构建简单ruby-sample-app应用的步骤如下：

oc new-app ruby:2.6~[***]

访问应用：

$ oc get pods
$ oc exec <pod> -- curl 127.0.0.1:8080

源到镜像（S2I）框架和脚本

该镜像支持OpenShift的源到镜像（S2I）构建策略，核心脚本包括：

• /usr/libexec/s2i/assemble：用于处理应用源码，将其放置到镜像内适当目录，遵循Ruby应用开发的常见模式（见环境变量部分）。
• /usr/libexec/s2i/run：作为生成镜像的默认命令，配置Web服务器并在8080端口启动服务。

使用Dockerfile构建应用

相比S2I策略，Dockerfile提供更灵活的构建方式，适用于S2I不够灵活或在OpenShift外构建的场景。步骤如下：

1. 拉取基础构建器镜像

podman pull ubi8/ruby-26

本例使用RHEL7镜像ubi8/ruby-26。

2. 获取应用代码

以示例应用[***]

git clone [***] app-src

3. 在容器中准备应用

包含三个核心操作：放置应用源码、安装依赖、设置默认命令。支持两种方式：

3.1 使用S2I脚本构建

创建如下Dockerfile：

FROM ubi8/ruby-26

# 添加应用源码到assemble脚本预期目录，并设置权限（使容器无需root运行）
USER 0
ADD app-src /tmp/src
RUN chown -R 1001:0 /tmp/src
USER 1001

# 设置开发模式
ENV RAILS_ENV=development

# 安装依赖
RUN /usr/libexec/s2i/assemble

# 设置默认命令
CMD /usr/libexec/s2i/run

3.2 手动配置构建

创建如下Dockerfile：

FROM ubi8/ruby-26

USER 0
ADD app-src ./
RUN bundle install --path ./bundle

CMD bundle exec "rackup -P /tmp/rack.pid --host 0.0.0.0 --port 8080"

4. 构建镜像

podman build -t ruby-app .

5. 运行应用镜像

podman run -d ruby-app

环境变量

可在源码仓库的.s2i/environment文件中定义键值对设置环境变量：

• RACK_ENV
  指定应用部署环境（production、development、test），不同环境在日志详细程度、错误页面、gem安装等方面有不同行为。

  注意：仅当RACK_ENV为production时才会编译应用资产。

• DISABLE_ASSET_COMPILATION
  设置为true时跳过资产编译，仅在production环境下生效，适用于资产已预编译的场景。

• PUMA_MIN_THREADS、PUMA_MAX_THREADS
  指定Puma线程池的最小和最大线程数。

• PUMA_WORKERS
  指定启动的工作进程数，详见Puma的集群模式文档。

• RUBYGEM_MIRROR
  设置自定义RubyGems镜像URL，用于构建过程中下载gem包。

热部署

要动态获取应用源码变更，需执行以下步骤：

Ruby on Rails应用

运行构建的Rails镜像时，通过-e参数传递RAILS_ENV=development：

$ podman run -e RAILS_ENV=development -p 8080:8080 rails-app

其他Ruby应用（Sinatra、Padrino等）

需使用支持源码变更自动重载的gem，如：

• Shotgun
• Rerun
• Rack-livereload

需修改S2I run脚本，使Web服务器通过上述gem启动以检测源码变更。构建镜像后，运行时传递RACK_ENV=development：

$ podman run -e RACK_ENV=development -p 8080:8080 sinatra-app

修改运行中容器的源码

使用Podman的exec命令进入容器：

$ podman exec -it <容器ID> /bin/bash

进入容器后，当前目录为/opt/app-root/src（源码存放目录）。

性能调优

线程与工作进程配置

通过PUMA_MIN_THREADS和PUMA_MAX_THREADS调整线程数，工作进程数默认根据可用CPU核心数（基于cgroup cpusets子系统）确定。可通过--cpuset-cpus参数指定容器允许使用的CPU核心：

$ podman run -e PUMA_MAX_THREADS=32 --cpuset-cpus='0-2,3,5' -p 8080:8080 sinatra-app

内存限制

工作进程数同时受内存限制（通过cgroup强制执行）影响。镜像默认假设基础内存需求为50 MiB，每个工作进程额外需15 MiB，每个线程需128 KiB。总内存需求计算公式：

50 + 15 * 工作进程数 + 0.125 * 工作进程数 * PUMA_MAX_THREADS

可通过--memory参数指定内存限制：

$ podman run -e PUMA_MAX_THREADS=32 --memory=300m -p 8080:8080 sinatra-app

若内存限制比CPU核心数更严格，工作进程数会按上述公式自动缩减。也可通过PUMA_WORKERS显式设置工作进程数。

参见

Dockerfile及其他源码可在[***]Dockerfile，RHEL7对应Dockerfile.rhel7，RHEL8对应Dockerfile.rhel8，Fedora对应Dockerfile.fedora。