5.2. Source-to-Image (S2I) 构建

利用源代码构建，您可以在应用程序内设置环境值（每行一个），方法是在源存储库中的 .s2i/environment 文件中指定它们。此文件中指定的环境变量存在于构建过程和输出镜像。

如果在源存储库中提供 .s2i/environment 文件，则 S2I 会在构建期间读取此文件。这允许自定义构建行为，因为 assembe 脚本可能会使用这些变量。

除了构建之外，指定的环境变量也可以在运行的应用程序本身中使用。例如，使 Rails 应用程序在 development 模式而非 production 模式中启动：

您可以在 BuildConfig 的 sourceStrategy 定义中添加环境变量。这里定义的环境变量可在 assemble 脚本执行期间看到，也会在输出镜像中定义，使它们能够供 run 脚本和应用程序代码使用。

sourceStrategy:
...
  env:
    - name: "DISABLE_ASSET_COMPILATION"
      value: "true"

构建过程包含以下三个基本元素，这些元素组合成最终的容器镜像：

在构建过程中，S2I 必须将源代码和脚本放在构建器镜像中。为此，S2I 创建一个包含源和脚本的 tar 文件，然后将该文件流传输到构建器镜像中。在执行 assemble 脚本前，S2I 解压缩该文件并将其内容放到构建器镜像的 io.openshift.s2i.destination 标签中指定的位置，默认位置为 /tmp 目录。

为了使这个过程能够发生，您必须提供 tar 存档实用程序（可在 $PATH 中使用的 tar 命令）和命令行解释器（/bin/sh 命令）；这样，您的镜像能够使用最快捷的构建路径。如果 tar 或 /bin/sh 命令不可用，则强制 s2i build 过程自动执行额外容器构建，将源和脚本放进镜像中，然后才运行常规构建。

参见下图中的基本 S2I 构建工作流：

图 5.1. 构建工作流

运行构建的过程包括解压源代码、脚本和工件（若存在），并且调用 assemble 脚本。如果这是二次运行（在捕获了“未找到 tar 或 /bin/sh”错误后），它将仅负责调用 assemble 脚本，因为脚本和源代码都已就位。

您可以使用任何编程语言编写 S2I 脚本，只要脚本可在构建器镜像中执行。S2I 支持多种提供 assemble/run/save-artifacts 脚本的选项。每次构建时按以下顺序检查所有这些位置：

镜像中指定的 io.openshift.s2i.scripts-url 标签和 BuildConfig 中指定的脚本都可以采用以下形式之一：

#!/bin/bash

# restore build artifacts
if [ "$(ls /tmp/s2i/artifacts/ 2>/dev/null)" ]; then
    mv /tmp/s2i/artifacts/* $HOME/.
fi

# move the application source
mv /tmp/s2i/src $HOME/src

# build application artifacts
pushd ${HOME}
make all

# install the artifacts
make install
popd

#!/bin/bash

# run the application
/opt/application/run.sh

#!/bin/bash

pushd ${HOME}
if [ -d deps ]; then
    # all deps contents to tar stream
    tar cf - deps
fi
popd

#!/bin/bash

# inform the user how to use the image
cat <<EOF
This is a S2I sample builder image, to use it, install
https://github.com/openshift/source-to-image
EOF