centos/ruby-24-centos7 Docker 镜像 - 轩辕镜像

Ruby 2.4 容器镜像

镜像概述和主要用途

该容器镜像包含Ruby 2.4，作为构建Ruby 2.4应用程序的源到镜像（S2I）基础镜像。用户可选择基于RHEL、CentOS或Fedora的构建器镜像：RHEL镜像可在Red Hat容器目录获取，CentOS镜像在Docker Hub，Fedora镜像在Fedora Registry。生成的镜像可使用podman运行（本文档中podman命令可替换为docker，参数相同）。

核心功能和特性

• 基础平台：提供构建和运行各类Ruby 2.4应用程序及框架的基础环境。
• Ruby特性：Ruby是解释型脚本语言，支持快速面向对象编程，适用于文本文件处理和系统管理任务，具有简洁、直观和可扩展的特点。
• npm支持：包含npm工具，用于安装Web应用所需的JavaScript模块；npm和nodejs版本不做保证，nodejs仅为支持npm运行而包含，版本可能变更。

使用场景和适用范围

适用于开发、部署和运行Ruby 2.4应用程序的场景，支持Ruby on Rails、Sinatra、Padrino等框架，可用于开发调试、持续集成/部署（CI/CD）及生产环境运行。

详细使用方法和配置说明

用法示例

以下以rhscl/ruby-24-rhel7镜像（OpenShift中对应ruby:2.4镜像流标签）为例说明使用方法。

在OpenShift中构建应用

构建ruby-sample-app示例应用：

bash
oc new-app ruby:2.4~[***] --context-dir=2.4/test/puma-test-app/

使用独立S2I工具构建应用

在已安装S2I的系统上：

bash
$ s2i build [***] --context-dir=2.4/test/puma-test-app/ rhscl/ruby-24-rhel7 ruby-sample-app

访问应用

bash
$ curl 127.0.0.1:8080

环境变量

可在源代码仓库的.s2i/environment文件中以键值对形式设置以下环境变量：

• RACK_ENV
  指定应用部署环境（production/development/test），不同环境在日志、错误页面、gem安装等方面行为不同。仅当设为production时会编译应用资产。

• DISABLE_ASSET_COMPILATION
  设为true时跳过资产编译，仅在production环境且资产已预编译时使用。

• PUMA_MIN_THREADS、PUMA_MAX_THREADS
  分别指定Puma Web服务器线程池的最小和最大线程数。

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

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

热部署

为动态获取源代码变更，需执行以下步骤：

Ruby on Rails应用

运行时通过-e参数传递RAILS_ENV=development：

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

其他Ruby应用（Sinatra、Padrino等）

1. 使用支持源代码变更重载的gem，如Shotgun、Rerun或Rack-livereload。
2. 修改S2I运行脚本，使Web服务器由所选gem启动（以检测代码变更）。
3. 运行时传递RACK_ENV=development：

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

修改运行中容器的源代码

使用podman exec进入容器（源代码位于/opt/app-root/src）：

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

性能调优

• 线程数调整：通过PUMA_MIN_THREADS和PUMA_MAX_THREADS设置每个worker的线程范围。

• CPU核心限制：worker进程数默认由容器可用CPU核心数决定（通过cgroup cpusets），可通过--cpuset-cpus指定核心：

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

• 内存限制：总内存需求计算公式为50 + 15 * WORKERS + 0.125 * WORKERS * PUMA_MAX_THREADS（单位：MiB），可通过--memory指定内存限制，worker数会自动缩减以适应：

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

• 显式设置worker数：通过PUMA_WORKERS环境变量直接指定worker进程数，覆盖CPU和内存自动计算结果。

参见

Dockerfile及源码可在[***]Dockerfile，RHEL7为Dockerfile.rhel7，RHEL8为Dockerfile.rhel8，Fedora为Dockerfile.fedora。