s2ioperator

S2I Operator

介绍

S2I( source to image )是一款由Openshift开发、自动将代码容器化的工具（https://github.com/openshift/source-to-image），通过预置的模板来支持多种语言和框架，诸如Java，Nodejs, python等等。S2I Operator将S2I引入到kubernetes中，相比原生命令行的使用方式，有下面几个优点：

1. 对外提供API，用户可以直接调用API生成自己需要的镜像，或者进行二次开发
2. 每一次运行的配置文件都存储在k8s中，能够复用
3. 提供webhook，实现CI/CD
4. 提供kubectl apply的方式，对k8s使用者友好

如何安装

kubectl label nodes {nodexxx} s2ioperator=yes
kubectl apply -f https://raw.githubusercontent.com/kubesphere/s2ioperator/master/deploy/s2ioperator.yaml

注意事项，Source2Image需要Docker的支持，需要确保S2IOperator安装的Node上有Docker，并且有足够的空间。目前的S2iOperator是固定在节点上的，通过上面的kubectl label 进行设置。这么做主要为了重复利用Docker Layer，同时方便日后清理。如果不想固定node，可以去掉上面yaml中的nodeSelector属性。

最新版的S2iOperator加入了验证功能，由于目前controller-runtime的局限性（会在下个版本增强），需要手动添加当前集群的CA。执行完上述命令之后，执行下面的命令添加SSL证书。

wget https://raw.githubusercontent.com/kubesphere/s2ioperator/master/hack/certs.sh
chmod +x certs.sh
./certs.sh --service webhook-server-service --namespace devops --secret webhook-server-secret

执行最下面一句命令，需要系统安装openssl，并且拥有正确配置了k8s集群config的kubectl。需要有k8s的管理员权限。

快速开始

1. 新建一个s2ibuilder，s2ibuilder存储了所有需要的配置信息。每一次生成Docker镜像可以复用这些信息，也可以覆盖一些信息。

   kubectl apply -f - <<EOF
   apiVersion: devops.kubesphere.io/v1alpha1
   kind: S2iBuilder
   metadata:
       name: s2ibuilder-sample
   spec:
       config:
           displayName: "For Test"
           sourceUrl: "https://github.com/sclorg/django-ex"
           builderImage: centos/python-35-centos7
           imageName: kubesphere/hello-python
           tag: v0.0.1
           builderPullPolicy: if-not-present
   EOF
   

   可以通过kubectl get s2ib 查看当前所有的S2ibuilder状态

   kubectl get s2ib
   NAME                RUNCOUNT   LASTRUNSTATE   LASTRUNNAME
   s2ibuilder-sample   2          Successful     s2irun-sample1
   

2. 开始一次运行s2irun，在builderName中指定使用的s2ibuilder

   kubectl apply -f - <<EOF
   apiVersion: devops.kubesphere.io/v1alpha1
   kind: S2iRun
   metadata:
       name: s2irun-sample
   spec:
       builderName: s2ibuilder-sample
   EOF
   

   通过kubectl get s2ir s2irun-sample查看当前运行的状态，如果出现了错误，可以查看当前namespace下以"s2irun-sample"开头的pod日志。

   kubectl get s2ir
   NAME             STATE        COMPLETIONTIME
   s2irun-sample    Successful   1m
   
   $ kubectl logs -f s2irun-sample-xxxxx ##查看具体POD的日志
   

3. 查看Job运行的Node节点，利用命令docker image ls 查看编译好的镜像。（查看S2iBuilder配置指南，学习如何自动将镜像导出到镜像仓库）

如何配置S2ibuilder和Sirun

1. S2IBuilder 配置指南
2. S2IRun 配置指南

开源许可