OpenShift S2I基础镜像

镜像概述与主要用途

本镜像作为OpenShift语言镜像（如s2i-ruby、s2i-nodejs、s2i-python等）的基础，包含构建这些镜像所需的所有核心库、工具及开发依赖。它通过在公共层共享开发包，有效节省磁盘空间并提升镜像拉取速度。此外，镜像内置NPM包管理器，便于安装Web应用所需的JavaScript库。对于无需开发库和NPM的场景，可使用其变体s2i-core镜像。

核心功能与特性

基于稳定平台与软件集合支持

• 稳定基础：基于RHEL或CentOS构建，提供稳定、安全且受支持的运行环境。
• 软件集合（SCL）：集成Software Collections包，提供比系统默认版本更新的软件，且更新频率更高。

自动启用SCL机制

通过设置以下Bash环境变量，实现SCL的自动启用，避免手动操作的繁琐和错误：

• BASH_ENV：为所有非交互式Bash会话启用SCL
• ENV：为所有/bin/sh调用启用SCL
• PROMPT_COMMAND：在交互式shell中启用SCL

示例：

• 设置BASH_ENV后，所有#!/bin/bash脚本无需手动调用scl enable
• 设置PROMPT_COMMAND后，执行podman exec ... /bin/bash时自动启用SCL

开发工具集成

• 包含多种开发库，满足多数构建镜像的依赖需求
• 内置NPM包管理器，方便安装JavaScript库，提升Web开发体验

执行注意事项

SCL包中的可执行文件（如ruby）未直接位于PATH环境变量指定的目录中，因此：

• 不能直接执行 podman exec <容器ID> ... ruby
• 需通过 podman exec <容器ID> ... /bin/bash -c ruby 执行，结合环境变量确保正确调用可执行文件

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

使用场景

• 构建需要source-to-image（S2I）功能的OpenShift语言镜像
• 开发环境中需要集成开发库和NPM包管理器的场景
• 若无需开发库和NPM，建议使用s2i-core变体镜像

使用方法与配置说明

选择基础镜像版本

RHEL7基础镜像

需在已订阅的RHEL机器上构建：

bash
$ git clone --recursive [***]
$ cd s2i-base-container
$ make build VERSIONS=base TARGET=rhel7

CentOS7基础镜像

从DockerHub拉取

console
podman pull sclorg/s2i-base-centos7

从源码构建

bash
$ git clone --recursive [***]
$ cd s2i-base-container
$ make build VERSIONS=base

注意：省略VERSION参数时，构建/测试操作将对所有提供的s2i镜像版本执行。

参见

• 镜像源码（含各变体Dockerfile）：[***]
• 不同系统的Dockerfile命名：
  • CentOS：Dockerfile
  • RHEL7：Dockerfile.rhel7
  • RHEL8：Dockerfile.rhel8
  • Fedora：Dockerfile.fedora