说明

创建CI流水线,使用KubeSphere DevOps完成源码编译、镜像构建并推送到Harbor仓库或其他云仓库,最后以git commit方式更新yaml仓库中image字段。

CD部分我们使用Argo CD来做,Argo CD持续监测yaml仓库配置文件变动,当 CI 部分执行git push时便会触发 Argo CD 更新 yaml 文件到 k8s 集群。

准备工作

流水线概述

使用 KubeSphere 创建DevOps工程

备注:

  • 阶段 1:Checkout SCM:从 GitLab 仓库检出源代码。
  • 阶段 2:单元测试:待该测试通过后才会进行下一阶段。
  • 阶段 3:SonarQube 分析:配置 SonarQube 用于静态代码分析。
  • 阶段 4:构建并推送快照镜像:构建镜像并附上标签snapshot-$BUILD_NUMBER推送至 Docker Hub,其中$BUILD_NUMBER是流水线活动列表中的记录的序列号。
  • 阶段 5:制品:生成一个制品(jar 文件包或其他)并保存。
  • 阶段 6:部署至开发环境:在开发环境中创建一个部署和一个服务。该阶段需要进行审核,部署成功运行后,会发送电子邮件或微信报警通知。

KubeSphere 创建流水线

创建一个帐户

(1)登录控制台后,点击左上角的平台管理,然后选择访问控制。

使用 KubeSphere 创建DevOps工程

(2)了解内置账户角色

使用 KubeSphere 创建DevOps工程

(3)创建帐户将被分配platform-regular角色。

使用 KubeSphere 创建DevOps工程

创建一个企业空间

(1)admin账户登录控制台后,点击左上角的平台管理,然后选择访问控制。

使用 KubeSphere 创建DevOps工程

(2)在企业空间中,可以看到仅列出了一个默认企业空间system-workspace,即系统企业空间,其中运行着与系统相关的组件和服务,无法删除该企业空间。

使用 KubeSphere 创建DevOps工程

(3)点击右侧的创建,将新企业空间命名为demo-workspace,并将用户ws-admin设置为企业空间管理员,如下图所示:

使用 KubeSphere 创建DevOps工程

完成后,点击创建。

(4)在企业空间设置中,选择企业成员,然后点击邀请成员即上面创建的java账户。

使用 KubeSphere 创建DevOps工程

创建项目

(1)以 admin 身份登录 KubeSphere,在项目管理中,点击创建。

使用 KubeSphere 创建DevOps工程

(2)输入项目名称(例如 demo-project),然后点击确定完成,可以为项目添加别名和描述。

使用 KubeSphere 创建DevOps工程

(3)设置项目配额

使用 KubeSphere 创建DevOps工程

(4)邀请成员java并授予demp-workspace-self-provisioner角色权限

使用 KubeSphere 创建DevOps工程

创建一个 DevOps 工程

(1)以java身份登录 KubeSphere,创建DevOps 工程。

使用 KubeSphere 创建DevOps工程

(2)创建相关凭证

创建git仓库和镜像仓库凭证

使用 KubeSphere 创建DevOps工程

(3)在 KubeSphere DevOps 工程下创建一条空流水线,命名为demo-java

使用 KubeSphere 创建DevOps工程

使用 KubeSphere 创建DevOps工程

进入流水线,选择编辑 Jenkinsfile,复制以下内容:

pipeline {

    environment {
        GIT_URL='http://192.168.98.221:8091/root/spring-demo.git'
        GIT_CREDENTIAL_ID = 'git-id'
        GIT_BRANCH = 'master'
        REGISTRY = 'registry.cn-shanghai.aliyuncs.com/tengfeiwu/spring-demo'
        REGISTRY_CREDENTIAL_ID = 'harbor-id'
    }

    agent {
        node {
            label 'maven'
        }
    }

    stages {

        stage('SCM Checkout') {
            steps {
                git branch: "${GIT_BRANCH}", credentialsId: "${GIT_CREDENTIAL_ID}", url: "${GIT_URL}"
            }
        }

        stage('source build') {
            steps {
                container('maven') {
                    sh 'mvn clean package'

                }
            }
        }

        stage('docker build & push') {
            steps {
                script {
                    env.COMMIT_ID = sh(returnStdout: true, script: "git log -n 1 --pretty=format:'%h'").trim()
                    env.TIMESTRAP = sh(returnStdout: true, script: 'date +%Y%m%d%H%M%S').trim()
                    env.DOCKER_TAG = "dev_${TIMESTRAP}_${COMMIT_ID}_${BUILD_NUMBER}"
                }
                container('maven') {
                    withCredentials([usernamePassword(passwordVariable : 'DOCKER_PASSWORD' ,usernameVariable : 'DOCKER_USERNAME' ,credentialsId : "$REGISTRY_CREDENTIAL_ID" ,)]) {
                        sh 'docker build -t $REGISTRY:$DOCKER_TAG .'
                        sh 'echo "$DOCKER_PASSWORD" | docker login $REGISTRY -u "$DOCKER_USERNAME" --password-stdin'
                        sh 'docker push $REGISTRY:$DOCKER_TAG'
                    }
                }
            }
        }

        stage('update docker tag') {
            environment {
                BUILD_USER = 'tengfei.wu'
                BUILD_USER_EMAIL = 'tengfei.wu@ceshi.com'
                YAML_REPO_URL='http://${username}:${password}@192.168.98.221:8091/root/argocd-gitops.git'
            }

            steps {
                withCredentials([usernamePassword(passwordVariable : 'password' ,usernameVariable : 'username' ,credentialsId : "$GIT_CREDENTIAL_ID" ,)]) {
                    sh """
                        git config --global user.name "$BUILD_USER"
                        git config --global user.email "$BUILD_USER_EMAIL"
                        git clone ${YAML_REPO_URL} && cd argocd-gitops
                        sed -i "s#$REGISTRY.*#${REGISTRY}:${DOCKER_TAG}#g" javademo/javademo-deployment.yaml
                        git add -A && git commit -m "update tag: ${DOCKER_TAG}" && git push ${YAML_REPO_URL}
                    """
                }
            }
        }
    }
}

说明:

注意修改相关参数,流水线中引用了 2 个凭证:

  • GIT_CREDENTIAL_ID为内网git仓库账号密码;

  • REGISTRY_CREDENTIAL_ID为镜像仓库账号密码;

(4)运行流水线

点击运行,等待流水线执行完成,查看状态为成功:

使用 KubeSphere 创建DevOps工程

查看流水线构建日志,可以看到执行了以下过程,其中最后 update docker tag 步骤,执行了 2 个关键操作,sed 命令替换镜像 tag,然后执行 git push 更新 yaml 仓库。

使用 KubeSphere 创建DevOps工程

(5)查看推送到镜像仓库的镜像

使用 KubeSphere 创建DevOps工程