uofa/s2i-shepherd-drupal

S2I Drupal应用构建器镜像文档

概述

本镜像为支持S2I（Source-to-Image）的构建器镜像，专为在OpenShift环境中托管Drupal应用设计。它通过S2I脚本实现应用的自动化构建、部署与运行，支持增量构建以提高开发效率，适用于Drupal应用的容器化部署场景。

在Minishift中构建镜像

本地测试与Minishift构建流程

通常，本地测试完成后，需将镜像构建到Minishift Docker registry中，步骤如下：

设置环境变量

配置Docker构建环境指向Minishift Docker registry：

bash
eval $(minishift docker-env)

执行构建

执行Docker构建命令：

bash
IMAGE_NAME=uofa/s2i-shepherd-drupal
docker build -t ${IMAGE_NAME} .

也可通过make命令构建镜像（镜像中包含Makefile）。

构建完成后，从Shepherd部署时将使用更新后的uofa/s2i-shepherd-drupal镜像。

创建基本S2I构建器镜像

入门

文件与目录

Dockerfile

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

S2I脚本

assemble

创建assemble脚本用于构建应用，例如：

• 构建Python模块
• 安装Ruby gems
• 配置应用特定设置

该脚本还可恢复先前保存的构建制品。

run

创建run脚本用于启动应用。

save-artifacts（可选）

创建save-artifacts脚本用于增量构建，保存已构建的制品。

usage（可选）

创建usage脚本用于打印构建器的使用说明。

使脚本可执行

确保所有S2I脚本可执行：

bash
chmod +x s2i/bin/*

创建构建器镜像

通过以下命令基于Dockerfile创建构建器镜像：

bash
docker build -t shepherd-drupal .

也可通过make命令创建（镜像中包含Makefile）。

构建完成后，执行s2i usage shepherd-drupal可打印usage脚本中定义的使用说明。

测试构建器镜像

使用测试脚本测试构建器镜像：

bash
docker build -t shepherd-drupal-candidate .
IMAGE_NAME=shepherd-drupal-candidate test/run

也可通过make test命令测试（镜像中包含Makefile）。

创建应用镜像

应用镜像结合构建器镜像与应用源代码，通过Dockerfile中安装的应用、assemble脚本构建并由run脚本启动。创建命令如下：

bash
s2i build test/test-app shepherd-drupal shepherd-drupal-app
---> Building and installing application from source...

S2I将基于构建器镜像，使用assemble脚本的逻辑构建应用镜像，并包含test/test-app目录中的源代码。

运行应用镜像

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

bash
docker run -d -p 80:80 shepherd-drupal-app

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

使用保存的制品脚本

通过以下命令使用save-artifacts脚本进行增量构建：

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

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