自定义 S2I 模板

当您了解了 Source-to-Image (S2I) 的工作流和逻辑，就可以根据您的项目自定义镜像构建器模板（即 S2I / B2I 模板），以扩展 S2I 功能。KubeSphere 提供了几种常见的镜像构建器模板，如 Python和 Java。

本教程演示如何创建包含 Nginx 服务的镜像构建器。如果需要在项目中使用运行时镜像，请参阅本文档以了解有关如何创建运行时镜像的更多信息。

准备工作

S2I 模板自定义分成两部分。

• 第一部分：S2I 自定义镜像构建
  • assemble（必需）：从源代码构建应用程序制品的脚本 assemble。
  • run（必需）：用于运行应用程序的脚本。
  • save-artifacts（可选）：管理增量构建过程中的所有依赖。
  • usage（可选）：提供说明的脚本。
  • test （可选）：用于测试的脚本。
• 第二部分：S2I 模板定义

您需要提前准备好 S2I 模板定制所需的元素。

备注

与 OpenShift 的镜像构建器兼容，您可以在 KubeSphere 中重用它。有关 S2I 镜像构建器的更多信息，请参见 S2IRun。

创建镜像构建器

步骤 1：准备 S2I 目录

1. S2I 命令行工具提供了一个易于使用的命令来初始化构建器所需的基本目录结构。运行以下命令以安装S2I CLI。

   $ wget https://github.com/openshift/source-to-image/releases/download/v1.2.04/source-to-image-v1.1.14-874754de-linux-386.tar.gz
   $ tar -xvf source-to-image-v1.1.14-874754de-linux-386.tar.gz
   $ ls
   s2i source-to-image-v1.1.14-874754de-linux-386.tar.gz  sti
   $ cp s2i /usr/local/bin

2. 本教程使用 nginx-centos7 作为镜像构建器的名称。运行 s2i create 命令初始化基本目录结构。

   s2i create nginx-centos7 s2i-builder-docs

3. 目录结构初始化如下。

   s2i-builder-docs/
      Dockerfile - a standard Dockerfile to define the Image Builder
      Makefile - a script for testing and building the Image Builder
      test/
         run - a script that runs the application to test whether the Image Builder is working properly
         test-app/ - directory of the test application
      s2i/bin
         assemble - a script that builds the application
         run - a script that runs the application
         usage - a script that prints the usage of the Image Builder

步骤 2：修改 Dockerfile

Dockerfile 安装用于构建和运行应用程序的的所有必要工具和库。Dockerfile 还将 S2I 脚本复制到输出镜像中。

按如下所示修改 Dockerfile 以定义镜像构建器。

Dockerfile

# nginx-centos7
FROM kubespheredev/s2i-base-centos7:1
# Here you can specify the maintainer for the image that you're building
LABEL maintainer="Runze Xia <[email protected]>"
# Define the current version of the application
ENV NGINX_VERSION=1.6.3
# Set the labels that are used for KubeSphere to describe the Image Builder.
LABEL io.k8s.description="Nginx Webserver" \
      io.k8s.display-name="Nginx 1.6.3" \
      io.kubesphere.expose-services="8080:http" \
      io.kubesphere.tags="builder,nginx,html"
# Install the nginx web server package and clean the yum cache
RUN yum install -y epel-release && \
    yum install -y --setopt=tsflags=nodocs nginx && \
    yum clean all
# Change the default port for nginx
RUN sed -i 's/80/8080/' /etc/nginx/nginx.conf
RUN sed -i 's/user nginx;//' /etc/nginx/nginx.conf
# Copy the S2I scripts to /usr/libexec/s2i in the Image Builder
COPY ./s2i/bin/ /usr/libexec/s2i
RUN chown -R 1001:1001 /usr/share/nginx
RUN chown -R 1001:1001 /var/log/nginx
RUN chown -R 1001:1001 /var/lib/nginx
RUN touch /run/nginx.pid
RUN chown -R 1001:1001 /run/nginx.pid
RUN chown -R 1001:1001 /etc/nginx
USER 1001
# Set the default port for applications built using this image
EXPOSE 8080
# Modify the usage script in your application dir to inform the user how to run this image.
CMD ["/usr/libexec/s2i/usage"]

备注

S2I 脚本将使用 Dockerfile 中定义的标志作为参数。如果您需要使用与 KubeSphere 提供的基础镜像不同的基础镜像，请参见 S2I Scripts。

步骤 3：创建 S2I 脚本

1. 创建一个 assemble 脚本，如下所示，将配置文件和静态内容复制到目标容器中。

   #!/bin/bash -e
   if [[ "$1" == "-h" ]]; then
    exec /usr/libexec/s2i/usage
   fi
   echo "---> Building and installing application from source..."
   if [ -f /tmp/src/nginx.conf ]; then
     mv /tmp/src/nginx.conf /etc/nginx/nginx.conf
   fi
   if [ "$(ls -A /tmp/src)" ]; then
     mv /tmp/src/* /usr/share/nginx/html/
   fi

   备注

   默认情况下，s2i build 将应用程序源代码放在 /tmp/src。上述命令将应用程序源代码复制到由 kubespheredev/s2i-base-centos7:1 定义的工作目录 /opt/app-root/src。

2. 创建一个 run 脚本，如下所示。在本教程中，它只启动 nginx 服务器。

   #!/bin/bash -e
   exec /usr/sbin/nginx -g "daemon off;"

   备注

   本教程使用 exec 命令执行 nginx 服务器主机进程，让 nginx 接收从 docker 发送的所有信号，而 nginx 可以使用容器的标准输入和输出流。此外，save-artifacts 脚本允许新的构建重用应用程序早期版本镜像内容。save-artifacts 脚本可以删除，因为本教程不实现增量构建。

3. 创建一个 usage 脚本，如下所示，它会打印出镜像使用说明。

   #!/bin/bash -e
   cat <<EOF
   This is the nginx-centos7 S2I image:
   To use it, install S2I: https://github.com/kubesphere/s2i-operator
   Sample invocation:
   s2i build test/test-app kubespheredev/nginx-centos7 nginx-centos7-app
   You can then run the resulting image via:
   docker run -d -p 8080:8080 nginx-centos7-app
   and see the test via http://localhost:8080
   EOF

步骤 4：构建与运行

1. 修改 Makefile 中的镜像名称

   IMAGE_NAME = kubespheredev/nginx-centos7-s2ibuilder-sample
   # Create an Image Builder named above based on the Dockerfile that was created previously.
   .PHONY: build
   build:
    docker build -t $(IMAGE_NAME) .
   # The Image Builder can be tested using the following commands:
   .PHONY: test
   test:
    docker build -t $(IMAGE_NAME)-candidate .
    IMAGE_NAME=$(IMAGE_NAME)-candidate test/run

2. 运行 make build 命令为 NGINX 构建镜像构建器。

   $ make build
   docker build -t kubespheredev/nginx-centos7-s2ibuilder-sample .
   Sending build context to Docker daemon  164.9kB
   Step 1/17 : FROM kubespheredev/s2i-base-centos7:1
    ---> 48f8574c05df
   Step 2/17 : LABEL maintainer="Runze Xia <[email protected]>"
    ---> Using cache
    ---> d60ebf231518
   Step 3/17 : ENV NGINX_VERSION=1.6.3
    ---> Using cache
    ---> 5bd34674d1eb
   Step 4/17 : LABEL io.k8s.description="Nginx Webserver"       io.k8s.display-name="Nginx 1.6.3"       io.kubesphere.expose-services="8080:http"       io.kubesphere.tags="builder,nginx,html"
    ---> Using cache
    ---> c837ad649086
   Step 5/17 : RUN yum install -y epel-release &&     yum install -y --setopt=tsflags=nodocs nginx &&     yum clean all
    ---> Running in d2c8fe644415
   …………
   …………
   …………
   Step 17/17 : CMD ["/usr/libexec/s2i/usage"]
    ---> Running in c24819f6be27
   Removing intermediate container c24819f6be27
    ---> c147c86f2cb8
   Successfully built c147c86f2cb8
   Successfully tagged kubespheredev/nginx-centos7-s2ibuilder-sample:latest

3. 在创建镜像构建器后，运行以下命令创建应用程序镜像。

   $ s2i build ./test/test-app kubespheredev/nginx-centos7-s2ibuilder-sample:latest sample-app
   ---> Building and installing application from source...
   Build completed successfully

   备注

   按照 assemble 脚本中定义的逻辑，S2I 使用镜像构建器作为基础创建应用程序镜像，并从 test/test-app 目录注入源代码。

4. 运行以下命令以运行应用程序镜像。

   docker run -p 8080:8080  sample-app

   您可以在此位置访问 Nginx 应用程序：http://localhost:8080。

步骤 5：推送镜像与创建 S2I 模板

在本地完成 S2I 镜像构建器测试后，可以将镜像推送到自定义镜像仓库。您还需要创建一个 YAML 文件作为 S2I 构建器模板，如下所示。

s2ibuildertemplate.yaml

apiVersion: devops.kubesphere.io/v1alpha1
kind: S2iBuilderTemplate
metadata:
  labels:
    controller-tools.k8s.io: "1.0"
    builder-type.kubesphere.io/s2i: "s2i"
  name: nginx-demo
spec:
  containerInfo:
    - builderImage: kubespheredev/nginx-centos7-s2ibuilder-sample
  codeFramework: nginx # type of code framework
  defaultBaseImage: kubespheredev/nginx-centos7-s2ibuilder-sample # default Image Builder (can be replaced by a customized image)
  version: 0.0.1 # Builder template version
  description: "This is an S2I builder template for NGINX builds whose result can be run directly without any further application server." # Builder template description

步骤 6：在 KubeSphere 使用 S2I 模板

1. 运行以下命令将上面创建的 S2I 模板提交至 KubeSphere。

  $ kubectl apply -f s2ibuildertemplate.yaml
  s2ibuildertemplate.devops.kubesphere.io/nginx created

1. 在 KubeSphere 上创建 S2I 构建时，可以在构建环境中找到自定义 S2I 模板。

S2I 模板参数定义

有关 S2I 模板标签作为参数传递给前端分类的详细说明，请参见下表

参见以下 S2I 模板参数的详细说明。必需参数用星号标记。