K8S结合Jenkins实现持续集成的动态配置详情分享
前言:
Kubernetes,简称K8s,相信大家都不会陌生。这是一个开源的,用于管理云平台中多个主机上的容器化的应用。
Jenkins,是一个开源软件项目,是基于Java开发的一种持续集成工具,用于监控持续重复的工作,旨在提供一个开放易用的软件平台,使软件项目可以进行持续集成。
在程序员日常的开发当中,使用着各种不同的编程语言,流程中少不了开发、测试、打包、发布等等的步骤,这其中的部分环节,是重复且必须的工作。所以慢慢地引入了持续集成的概念,从而减轻开发人员,运维人员的操作和时间成本,更好地服务好我们的程序猿(嗷嗷嗷 ~ 程序员太苦啦,是时候来点甜啦~)。
接下来让我来给大家分享一下,如何结合K8S和Jenkins可以实现快速地实现以上的一些重复性且必要的工作,让我们的攻城狮更好地专注在开发工作当中!
前置环境条件:
1、已经有部署好的K8S集群环境;
2、已经在K8S环境中已经部署好Jenkins应用;
3、代码仓库(如gitlab、GitHub等)已经通过webhook等方式,和Jenkins能进行通讯;
4、jenkins添加好代码仓库对应的流水线作业。
1、登录到Jenkins UI进行模版配置
登录到Jenkins – 左菜单(系统设置) – 节点管理 – Configure Clouds,进行模版的配置
1.1 编辑Kubernetes模版
第一页详细配置如上图,基本都是用默认值即可,有几个地方需要根据实际的集群信息进行填写就可以啦,挺简单的!!
1.2 编辑pod模版
2-1和2-2是pod模版的名称和模版标签
第二页详细配置如上图,按照上图说明即可。俗话说,工欲善其事,必先利其器,至此,jenkins的模版关键配置已经完成啦,接下来就是使用这些模版的时候啦,请继续往下阅读!!
2、可持续集成配置
2.1 Jenkinsfile使用详解
这里的lable是 上面的标签设置的值
//模板需要修改的值:label(配置的jenkins的slave标签),cloud:(配置的jenkins的cloud) //定义变量 def label = "jenkins-slave-js" //设置pod模版的信息,label是模版标签,cloud是第一步设置的jenkins模版名 //以下操作都是在打包容器里面进行,内容可以高度自定义,贴合不同的需求 podTemplate(label: label , cloud: 'kubernetes') { node(label) { //拉取仓库代码 def myRepo = checkout scm def gitBranch = myRepo.GIT_BRANCH.replaceAll("origin/","").replaceAll("/","-").replaceAll("\\.","-") def timestamp = sh(script: "echo `date '+%Y%m%d%H%M%S'`", returnStdout: true).trim() def gitCommit = sh(script: "git rev-parse --short HEAD", returnStdout: true).trim() gitCommit = "${gitCommit}_${timestamp}" //镜像标签,这里使用git分支名作为镜像的tag def imageTag = "${gitBranch}" //镜像仓库基础地址 def dockerRegistryUrl = "http://xxxxx" //应用服务名称,统一用于以下各个变量名称 def appName = "testAbc" //模板需要更改的值 开始 //helm工具发布时,使用的名称,这里使用【应用名-分支名】的格式 def helmReleaseName = "${appName}-${gitBranch}" //部署应用服务的命名空间 def namespace = "${appName}" //镜像的中间名称,用于平均基础镜像地址 def imageEndpoint = "${appName}/webapi" //模板需要更改的值 结束 //完整镜像地址(不包含镜像tag) def image = "${dockerRegistryUrl}/${imageEndpoint}" //helmChart模版的仓库名称 def chartName = "${appName}" //helmChart的版本 def chartVersion = "1.0" //helmChart完整名称 def chartDirName = "${appName}/${appName}" //K8S的网络模式,一般有Cluster(不对外访问)、NodePort(释放端口对外访问) def serviceType = "ClusterIP" //如果serviceType值是NodePort,这里可以设置指定供对外访问的端口号,不指定则随机,范围详见K8S的NodePort范围,默认是30000-32767 def serviceNodePort = "" //是否使用外部K8S存储,是则设置true,否则设置false def createPvc = true //如果设置了使用外部存储,则这里需要填写k8s的PVC资源的名称,以便以发布的应用服务能绑定此外部存储 def pvcName = "${gitBranch}-${appName}-configs-pvc" //设置外部存储对应应用服务容器里面的路径 def pvcMountPath = "/var/www/${appName}/storage" //定义不同阶段,可以方便清晰地在jenkins UI上看到每个阶段的耗时 stage('单元测试阶段') { script{ } } stage('项目编译阶段') { //此处使用container指定第二步配置的容器名称,就可以使用该容器环境的命令进行操作,如下面命令是前端node编译代码 container("node"){ sh "npm build ./main" sh "npm run serve" } } stage('构建 Docker 镜像阶段') { container('构建 Docker 镜像') { withCredentials([[$class: 'UsernamePasswordMultiBinding', credentialsId: 'docker-harbor', usernameVariable: 'DOCKER_HUB_USER', passwordVariable: 'DOCKER_HUB_PASSWORD']]) { //此处是引入了docker环境,进行docker的打包,推送到远程仓库等操作 container('docker') { sh """ docker login ${dockerRegistryUrl} -u ${DOCKER_HUB_USER} -p ${DOCKER_HUB_PASSWORD} docker build -t ${imageEndpoint}:${imageTag} . docker tag ${imageEndpoint}:${imageTag} ${dockerRegistryUrl}/${imageEndpoint}:${imageTag} docker push ${image}:${imageTag} """ } } } } //K8S使用了helm发布工具进行应用服务的发布 stage('Helm 部署阶段') { withCredentials([[$class: 'UsernamePasswordMultiBinding', credentialsId: 'docker-harbor', usernameVariable: 'DOCKER_HUB_USER', passwordVariable: 'DOCKER_HUB_PASSWORD']]) { container('helm') { // 这里也可以做一些其他的分支判断是否要直接部署 echo "[INFO] 开始 Helm 部署" echo "1 初始化helm client" sh "helm init --client-only --stable-repo-url https://mirror.azure.cn/kubernetes/charts/" //添加打包容器里面的本地helm仓库 sh "helm repo add --username ${DOCKER_HUB_USER} --password ${DOCKER_HUB_PASSWORD} ${chartName} http://${dockerRegistryUrl}/chartrepo/${chartName}" echo "2 如果更新了chart包则需要更新repo仓库" sh "helm repo update" echo "3 更新 ${helmReleaseName} 应用服务" sh """ helm upgrade --install ${helmReleaseName} ${chartDirName} \ --version ${chartVersion} \ --set namespace=${namespace} \ --set gitCommit=${gitCommit} \ --set gitBranch=${gitBranch} \ --set productionDeployment.image.repository=${image} \ --set canaryDeployment.image.repository=${image} \ --set productionDeployment.image.tag=${imageTag} \ --set canaryDeployment.image.tag=master \ --set createPvc=${createPvc} \ --set pvcName=${pvcName} \ --set pvcMountPath=${pvcMountPath} \ --set service.type=${serviceType} \ --set service.nodePort=${serviceNodePort} \ --namespace=${namespace} """ echo "[INFO] Helm 部署应用成功..." } } } } }
至此,我们已经完成配置好jenkins模版和jenkinsfile完整的一套可持续集成系统的工作,我们后续开发时,只需要合并好代码,触发webhook流水线,通知jenkins进行打包、发布、部署的操作即可,实现真正解放我们的双手啦!!!哈哈哈!!!