sebekish/openshift-laravel

基础S2I构建器镜像

镜像概述和主要用途

该镜像为基础S2I（Source-to-Image）构建器镜像，用于将应用源代码转换为可运行的容器镜像。通过集成Dockerfile和S2I脚本，实现从源代码构建、配置到运行的完整流程，支持增量构建和应用测试，适用于快速构建和部署各类应用。

核心功能和特性

• 完整构建流程：包含构建（assemble）、运行（run）等必备S2I脚本，支持应用全生命周期管理
• 增量构建支持：可选的save-artifacts脚本实现构建 artifacts 复用，加速二次构建
• 测试框架：提供测试脚本和测试应用，便于验证构建器镜像功能
• 灵活性：可通过自定义Dockerfile和S2I脚本适配不同类型应用（如Python、Ruby等）
• 易用性：支持make命令简化镜像构建和测试流程

文件与目录结构

Dockerfile

用于安装构建和运行应用所需的工具与库，并将S2I脚本复制到镜像中。

S2I脚本

assemble（必需）

构建应用的核心脚本，示例功能包括：

• 构建Python模块
• 安装Ruby gems依赖
• 配置应用特定参数
• 恢复先前构建的artifacts（若使用增量构建）

run（必需）

启动应用的脚本，负责应用的运行逻辑。

save-artifacts（可选）

支持增量构建的脚本，允许新构建复用前一版本应用镜像的内容。

usage（可选）

打印构建器镜像使用说明的脚本。

脚本可执行性

需通过以下命令确保所有脚本可执行：

bash
chmod +x s2i/bin/**

使用方法和配置说明

创建构建器镜像

基于Dockerfile创建构建器镜像：

bash
docker build -t jo-p-n .

也可通过Makefile（若包含）使用make命令创建。

构建完成后，可通过以下命令查看使用说明：

bash
s2i usage jo-p-n

测试构建器镜像

使用以下命令测试构建器镜像：

bash
docker build -t jo-p-n-candidate .
IMAGE_NAME=jo-p-n-candidate test/run

或通过Makefile使用make test命令。

创建应用镜像

应用镜像结合构建器镜像与应用源代码，通过Dockerfile安装依赖、assemble脚本编译、run脚本运行。创建命令：

bash
s2i build test/test-app jo-p-n jo-p-n-app
---> Building and installing application from source...

S2I将以构建器镜像为基础，整合test/test-app目录的源代码生成应用镜像。

运行应用镜像

通过docker run命令运行应用镜像：

bash
docker run -d -p 8080:8080 jo-p-n-app

应用（如简单静态网页）将可通过http://localhost:8080访问。

使用增量构建

通过save-artifacts脚本实现增量构建，命令：

bash
s2i build --incremental=true test/test-app nginx-centos7 nginx-app
---> Restoring build artifacts...
---> Building and installing application from source...

该命令将备份当前应用源代码，重建镜像后通过assemble脚本重新部署保存的源代码。

使用场景和适用范围

适用于需要快速将源代码转换为容器镜像的场景，如：

• 开发环境中快速构建和测试应用
• CI/CD流水线中自动化构建容器应用
• 需要支持增量构建以提升构建效率的场景
• 各类语言应用（Python、Ruby、静态网站等）的容器化构建