第五章 九析带你玩转 rancher - 流水线发布

本系列文章:

第一章：九析带你玩转 rancher - 安装篇

第二章：九析带你玩转 rancher - 导入集群篇

第三章：九析带你玩转 rancher - 集成 gitlab

第四章：九析带你玩转 rancher - 集成 harbor

第五章：九析带你玩转 rancher - 流水线发布

目录

1 前言

2 设置流水线

    2.1 关联代码库

        2.1.1 指定项目空间

        2.1.2 设置代码库

    2.2 关联镜像库

    2.3 全局流水线设置

    2.4 项目空间流水线设置

3 执行流水线

4 流水线成功执行

1 前言

        本文是在上章《九析带你玩转 rancher - 集成 gitlab》的基础上进行配置的，所以在发布 rancher 流水线前，需确保 rancher 和 gitlab 已经关联。

流水线是 DevOps 的实现，它提供非常友好的界面 UI，使开发人员仅仅通过鼠标，就可以完成整个微服务的发布上线。在 rancher 中，一个微服务就对应一条流水线。

2 设置流水线

        设置流水线需同时设置全局流水线和项目流水线。全局流水线的设置会影响到项目流水线。

2.1 关联代码库

2.1.1 指定项目空间

        本文 default 项目空间下配置流水线：

        在 default 项目空间下，选择“资源” -> “流水线” 菜单：

2.1.2 设置代码库

        选择“设置代码库”按钮：

        选择“刷新代码库”按钮：

        由于 gitlab 已经跟 rancher 关联，故刷新代码库之后，就会显示你在 gitlab 中的服务代码：

        启用服务：

        点击完成：

2.2 关联镜像库

        本文在 default 空间下关联镜像库：

        添加凭证：

        填写相关信息：

2.3 全局流水线设置

        选择指定集群（zcy-arch-k8s），再选择“工具”，最后选择“流水线”：

        修改内容如下：

        全局流水线会控制项目流水线的并发个数、资源占比情况等。

2.4 项目空间流水线设置

        项目空间流水线需同时选中“集群”（zcy-arch-k8s）和“项目空间”（default）：

        选择 “编辑配置” 子菜单：

         点击 “设置流水线” 链接后的图示如下：

        可根据各自需求添加流水线“阶段”，一般情况下，整个流水线跑四个阶段就足够了，即：

1 clone 阶段：这是系统默认的必须阶段，指从代码库下载微服务的源代码。

2 build 阶段：编译源代码，并生成 Dockerfile 文件

3 publish 阶段：根据上阶段的 Dockerfile 文件生成镜像，然后将镜像上传到指定镜像仓库

4 deploy 阶段：从镜像仓库下载上阶段生成的服务镜像，然后启动容器运行

        下面以 java 语言为例，在服务（这里是: chapter-001-helloworld）代码库创建 rancher 总流水线文件 .rancher-pipeline.yml，如下图所示：

        文件定义了流水线 3 个阶段，文件内容如下：

stages:

- name: Build

 steps:

 - runScriptConfig:

     image: jiuxi.harbor.org/stable/maven-3.6.0-jdk-8

     shellScript: mvn -B -U -DskipTests clean package spring-boot:repackage

- name: Publish

 steps:

 - publishImageConfig:

     dockerfilePath: ./Dockerfile

     buildContext: .

     tag: stable/${CICD_GIT_REPO_NAME}:${CICD_GIT_COMMIT}

     pushRemote: true

     registry: jiuxi.harbor.org

   env:

     PLUGIN_DEBUG: "true"

     PLUGIN_INSECURE: "true"

- name: Deploy

 steps:

 - applyYamlConfig:

     path: ./Deployment.yaml

notification: {}

        Publish 阶段是把 Build 阶段生成的 jar 文件，根据预先定义的 Dockerfile 文件做成服务镜像，并推送到私有镜像仓库中，其中自定义 Dockerfile 文件定义如下：

FROM jiuxi.harbor.org/stable/java:8

MAINTAINER "jiuxi"<1494445739@qq.com>

ADD ./target/application.jar application.jar

EXPOSE 8080

CMD ["/bin/sh", "-c", "java -jar application.jar"]

        Deploy 阶段是在 k8s 中执行自定义部署文件 Deployment.yaml，创建服务的 service 和 deployment 资源，并运行容器，自定义 Deployment.yaml 文件内容如下：

apiVersion: v1

kind: Service

metadata:

 name: ${CICD_GIT_REPO_NAME}

 labels:

   app: ${CICD_GIT_REPO_NAME}

spec:

 type: ClusterIP

 selector:

   app: ${CICD_GIT_REPO_NAME}

 ports:

 - port: 8080

   targetPort: 8080

---

apiVersion: apps/v1

kind: Deployment

metadata:

 name: ${CICD_GIT_REPO_NAME}

spec:

 replicas: 1

 selector:

   matchLabels:

     app: ${CICD_GIT_REPO_NAME}

 minReadySeconds: 5

 strategy:

   type: RollingUpdate

 template:

   metadata:

     labels:

       app: ${CICD_GIT_REPO_NAME}

   spec:

     containers:

     - name: ${CICD_GIT_REPO_NAME}

       image: jiuxi.harbor.org/stable/${CICD_GIT_REPO_NAME}:${CICD_GIT_COMMIT}

       livenessProbe:

         tcpSocket:

           port: 8080

       imagePullPolicy: Always

       env:

       - name: TZ

         value: "Asia/Shanghai"

       - name: MY_POD_IP

         valueFrom:

           fieldRef:

             fieldPath: status.podIP

       - name: jiuxi_logs_${CICD_GIT_REPO_NAME}-stdout

         value: "stdout"

       - name: jiuxi_logs_${CICD_GIT_REPO_NAME}-logs

         value: "/data/logs/${CICD_GIT_REPO_NAME}/*.log"

       volumeMounts:

       - name: logs

         mountPath: /data/logs/${CICD_GIT_REPO_NAME}

       - name: time

         mountPath: /etc/localtime

       resources:

         limits:

           memory: 1Gi

     volumes:

     - name: time

       hostPath:

         path: /etc/localtime

     - name: logs

       emptyDir: {}

     restartPolicy: Always

        提交 .rancher-pipeline.yaml、Deployment.yaml、Dockerfile 文件到 gitlab。然后在 rancher 中重新点击“设置代码库”：

      “刷新代码库”，点击“完成”：

        再点击“编辑配置”：

        流水线已经自动配置好：

        确定一下 Publish 阶段的镜像仓库地址是否正确：

        点击“完成”按钮：

        点击确认，整个流水线的配置已经完成。

3 执行流水线

        选择“运行”菜单来执行流水线：

        选择指定代码分支，我这里是“master”：

        点击“运行”：

        流水线开始执行，首次启动流水线时，需下载 jenkins、minio、docker-registry 等镜像，因此需要一定时间。如果执行报如下错：

        说明 pipeline 运行容器并不识别自定义域名，你需要重启流水线。

        启动后，jenkins 会动态生成 pipeline 容器，此时你需要趁着 pipeline 容器生成瞬间进入它的控制台（所以你最好同时打开 2 个 rancher 页面，一个是流水线执行页面，如上图；另外一个是 default 项目空间页面，如下图）：

        要注意，jenkins 在生成 pipeline 容器的时候，页面会自动刷新（所以你不用手动刷新页面）；其次，你要确保流水线前面的状态是 Running 时，操作后面的“更多”按钮才可以显示“执行命令行”菜单：

        在弹出的“执行命令行”界面输入下面命令修改 /etc/hosts 文件：

echo "10.110.101.100 jiuxi.gitlab.com jiuxi.harbor.org jiuxi.nexus.org" >> /etc/hosts

4 流水线成功执行

         在 default 项目空间下查看服务：

        发现 chapter-001-helloworld 已经成功运行：

        点击进入 chapter-001-helloworld 查看 pod 日志：

        发现服务已经正常运行：

        自此，轻松完爆 rancher 流水线发布。