jenkins流水线实操

不高兴就喝水 2021-12-13

2544

1.背景

随着公司项目的不断迭代，项目越做越庞大，迭代更新的越来越快，项目的构建和部署往往变得繁琐和费时。

在这个背景下引入 jenkins ，可以让项目的构建部署变得轻松。但是随着项目的频繁迭代并且公司微服务数量越来越多，新增和修改构建就变得非常繁琐，需要更加灵活的构建方式来解决这个窘境，这时选择流水线的构建方式是一个不错的选择。

流水线是根据 jenkins 定义的流水线语法，调用不同的插件工具来实现一个应用程序从构建、部署、测试和发布这个过程的。和其他 jenkins job 相比由于采用编程方式配置过程，因此非常的灵活。

2.达到的效果

1.可支持直接重启

2.串行构建多个项目

3.定时构建

4.指定分支构建

5.指定 nacos 命名空间构建

6.并行构建多个项目

7.启动失败回滚

3.构建过程流程图

4.准备工作

jenkins 所在服务器安装:jdk,jenkins,git,maven;

5.配置环境变量

这里直接配置用户环境变量打开.bash_profile按如下配置（以下文件路径按实际安装路径修改即可）

# Get the aliases and functions
if [-f~/.bashre ]; then
    ~/.bashre
fi
export NODE_HOME=/home/ap/xx/software/node
export MAVEN_HOME=/home/ap/xx/software/maven
JAVA_HOME=/home/ap/xx/software/jdk_1.8
CLASS_PATH=.:${JAVA_HOME}/lib/tools.jar:${JAVA_HOME}/lib/dt.jar
PATH=${JAVA_HOME}/bin:$PATH:$HOME/.local/bin:$HOME/bin: $NODE_HOME/bin:$MAVEN_HOME/bin
export PATH
export CLASS PATH

6.启动jenkins服务

nohup java -jar -Xmx1024m -Xms512m jenkins war - httpPort=9010 &

7.插件安装

需要安装的插件包括：

GitHub Branch Source Plugin：GitHub分支源插件
Maven Integration：利用maven编译，打包
Publish over SSH：通过SSH拷贝文件到目标机器，同时可以在目标机器上执行脚本
Pipeline：一套运行于 jenkins 上的工作流框架，将原本独立运行于单个或者多个节点的任务连接起来，实现单个任务难以完成的复杂发布流程
Config File Provider Plugin:可视化统一管理配置文件
Role-based Authorization Strategy：用户权限管理插件
Extended Choice Parameter: 复选框参数

8.配置jenkins

配置Publish over SSH

配置maven的setting文件

配置git凭据

9.串行构建

流程图

groovy流水线脚本

def projectA = [name:"projectA",url:"http://xxx.xxx.xxx.xxx:9091/projectA.git",tar:"projectA-service",port:"9519"]
def projectB = [name:"projectB",url:"http://xxx.xxx.xxx.xxx:9091/projectB.git",tar:"projectB-service",port:"9999"]
def projectC = [name:"projectC",url:"http://xxx.xxx.xxx.xxx:9091/projectC.git",tar:"projectC-service",port:"9580"]

def projectMap =[projectA:projectA,projectB:projectB,projectC:projectC]
//params对应上面的配置对象名称
def branch = params.branch //代码分支
def base_dir = "/home/xx"
def destDir = "${base_dir}/upload" //上传到应用服务器的路径
def namespace = params.namespace //nacos命名空间

//拉取代码
def fetchCode(project,branch,credentialsId){
    fileFlag = fileExists "${project.name}" //判断文件夹是否存在
    if(fileFlag){//不存在则创建
        sh "mkdir ${project.name}"
    }
    dir("${project.name}"){
        //拉取分支代码 如果project里定义的分支直接去project里的分支 credentialsld是jenkins配置的git凭证
        git branch:!!project.branch?project.branch:branch,credentialsld:"${credentialsld}", url:"${project.url}"   
    }
}

//编译打包
def buildInstall(project,branch){
    dir("${project.name}"){
        echo "start ${project.name} ${branch} 编译打包"
        //fileId 对应的是在系统配文件中配置的maven setting配置文件的ID variable是别名
        configFileProvider([configFile(fileld:'xxx',variable:'dev_setting')]){
            //-T 1C 代表每个CPU核心跑一个工程。
            sh "mvn-T 1C -s $dev_setting -DskipTests -Dmaven.compile.fork=true clean install"
            echo "end ${project.name} ${branch} 编译打包"
        }
    }
}

node{
    def projectArr = params.projects.split(",") //获取勾选中的要部署的项目
    stage("拉取代码"){
        for (projectStr in projectArr ){
            if(params.isFetch){
                fetchCode(projectMap[projectStr],branch,params.credentialsld)
            }
        }
    }
    stage("编译打包"){
        for (projectStr in projectArr){
            if(params.isFetch){
                buildinstall(projectMap[projectStr],branch)
            }
        }
    } 
    stage("部署"){
        for (projectStr in projectArr){
            def project = projectMap[projectStr]
            //返回shell执行的结果
            jarFile = sh (script: "find ${project.name} -name '*${project.tar}-jar'",returnStdout:true) //找到要部署的jar包
            echo "jarfile -----${project.name} :${jarFile}"
            index = jarFile.indexOf("target/")
            prefix = jarFile.substring(0,index+7)//获取jar的路径
            jar =jarFile.substring(index+7).trim()//获取jar的完整名称
            echo "即将拷贝文件 prefix:${prefix}; jar:${jar}"
            sshPublisher(
                publishers: [
                    sshPublisherDesc(
                        configName:'env_dev' //env_dev对应Publish over SSH配置 //对应全局配置的参数
                        transfers:[
                            sshTransfer(
                                cleanRemote: false,
                                excludes:''
                                execCommand:"""
                                    sh ${base_dir}/start.sh ${destDir}/${jar} ${project.name} ${params.isFetch} ${project.port} ${namespcae}
                                """ //上传文件后要启动的命令 对应shell脚本中的入参$1到$5
                                execTimeout: 0,
                                flatten: false,
                                makeEmptyDirs: false,
                                noDefaultExcludes: false,
                                patternSeparator:'[,]+
                                remoteDirectorySDF: false,
                                removePrefix:"${prefix}"
                                sourcefiles:"**/${jar}*"
                            )
                        ],
                        usePromotionTimestamp: false,
                        useWorkspaceInPromotion: false,
                        verbose:true
                    )
                ]
            )
        }
    }
}

10.并行构建

流程图

并行打包需要先打api,因为各个项目之间会有api的引用，各个项目并行打包会导致找不到api的错误，所以需要先将api包打完。