Jenkins的pipeline项目

Pipeline简介

概念

Pipeline，简单来说，就是一套运行在 Jenkins 上的工作流框架，将原来独立运行于单个或者多个节点的任务连接起来，实现单个任务难以完成的复杂流程编排和可视化的工作。

使用Pipeline好处

代码：Pipeline以代码的形式实现，通常被检入源代码控制，使团队能够编辑，审查和迭代其传送流程。
持久：无论是计划内的还是计划外的服务器重启，Pipeline都是可恢复的。
可停止：Pipeline可接收交互式输入，以确定是否继续执行Pipeline。
多功能：Pipeline支持现实世界中复杂的持续交付要求。它支持fork/join、循环执行，并行执行任务的功能。
可扩展：Pipeline插件支持其DSL的自定义扩展，以及与其他插件集成的多个选项。

创建 Jenkins Pipeline任务

Pipeline 脚本是由 Groovy 语言实现的，但是我们没必要单独去学习 Groovy
Pipeline 支持两种语法：Declarative(声明式)和 Scripted Pipeline(脚本式)语法
Pipeline 也有两种创建方法：可以直接在 Jenkins 的 Web UI 界面中输入脚本；也可以通过创建一个 Jenkinsfile 脚本文件放入项目源码库中（一般我们都推荐在 Jenkins 中直接从源代码控制(SCM)中直接载入 Jenkinsfile Pipeline 这种方法）。

安装git插件

jenkins工作台->系统管理->节点管理->可选插件->git

安装Pipeline插件

安装插件后，创建任务的时候多了“流水线”类型。初始化jenkins环境时已经默认安装了pipeline插件。
jenkins工作台->系统管理->节点管理->可选插件->pipeline

Pipeline语法快速入门

Scripted脚本式-Pipeline

新建任务 
pipeline-test02 

选择模板 
scripted pipeline 

片段生成器中选择echo 

node ('jenkinsagent-154') { 
    stage('Preparation') { // for display purposes 
        echo 'hello pipeline' 
    } 
}

Declarative声明式-Pipeline

新建任务 
pipeline-test02 

选择模板 
Hello world

agent配置

agent选项： 
any ： 在任何可用的机器上执行pipeline 
none ： 当在pipeline顶层使用none时，每个stage需要指定相应的agent

流水线语法
stages：代表整个流水线的所有执行阶段。通常stages只有1个，里面包含多个stage
stage：代表流水线中的某个阶段，可能出现n个。一般分为拉取代码，编译构建，部署等阶段。
steps：代表一个阶段内需要执行的逻辑。steps里面是shell脚本，git拉取代码，ssh远程发布等任意内容。

任务->流水线->点击链接 "流水线语法" 

选择 Declarative Directive Generator
Directives->Sample Directive->选择agent:Agent选项 
Agent选择 Label:Run on an agent matching a label 

Label:输入agent节点标签内容。"jenkinsagent-154"

点击Generator Declarative Directive按钮，复制生成内容替换任务的agent any部分
agent { label 'jenkinsagent-154' }

测试Declarative任务
点击立即构建
升级案例

pipeline { 
    agent { 
        label 'jenkinsagent-154' 
      }s
      tages {
          stage('检测环境') { 
              steps { 
                  sh label: '', script: '''java -version 
                  mvn -v 
                  git version 
                  docker -v'''
              } 
          }
          stage('拉取代码') { 
              steps { 
                  echo '拉取代码' 
              } 
          }
          stage('编译构建') { 
              steps { 
                  echo '编译构建' 
              } 
          }
          stage('项目部署') { 
              steps { 
                  echo '项目部署' 
              } 
          } 
    } 
}

测试pipeline项目
出现mvn命令没有找到错误。
解决方案一：配置jenkinsagent-154节点。在节点信息中增加环境变量配置
测试脚本。脚本正常执行
解决方案二：增加mvn命令的软连接，将mvn命令追加至/usr/local/bin目录中，具体命令如下：
ln -s /opt/maven/bin/mvn /usr/local/bin/
测试脚本。脚本正常执行

Declarative pipeline和Scripted pipeline的比较

共同点

两者都是pipeline代码的持久实现，都能够使用pipeline内置的插件或者插件提供的steps，两者都可以利用共享库扩展。

区别

两者不同之处在于语法和灵活性。Declarative pipeline对用户来说，语法更严格，有固定的组织结构，更容易生成代码段，使其成为用户更理想的选择。但是Scripted pipeline更加灵活，因为Groovy本身只能对结构和语法进行限制，对于更复杂的pipeline来说，用户可以根据自己的业务进行灵活的实现和扩展。

集成gitlab

http方式

gitlabe->clone->选择http方式

http://192.168.198.152/lagou/jenkinsdemo.git

配置凭据
jenkins工作台->系统管理->凭据管理(manager credentials)
类型:Username with password
修改脚本

1.片段生成器中选择check out 

2.修改pipeline-test03任务中的拉取代码阶段： 
            stage('拉取代码') { 
                 steps { 
                     echo 'gitlab拉取代码' 
                     checkout([$class: 'GitSCM', branches: [[name: '*/master']], 
                     doGenerateSubmoduleConfigurations: false, extensions: [], 
                     submoduleCfg: [], userRemoteConfigs: [[credentialsId: 'b26bd84e-e0cb-4b90-8469-1c2a46213466', 
                     url: 'http://192.168.198.152/lagou/jenkinsdemo.git']]]) 
                 }
             }

测试任务
点击立即构建

ssh方式

免密配置
gitlabe-152节点免密登录配置。gitlab服务器保存公钥信息。方便访问gitlab-152服务器。

1.生成秘钥 
ssh-keygen -t rsa 

2.查看公钥信息 
cat /root/.ssh/id_rsa.pub 

3.gitlabe服务器配置： 
当前用户->setting->SSH Key->点击 add key按钮

配置凭据
1.jenkins工作台->系统管理->凭据管理(manager credentials)。保存gitlab-152服务器的私钥信息。
2.类型:SSH Username with private key
修改脚本

修改pipeline-test03任务中的拉取代码阶段：
             stage('拉取代码') { 
                   steps { 
                       echo 'gitlab拉取代码'
                       checkout([$class: 'GitSCM', branches: [[name: '*/master']], 
doGenerateSubmoduleConfigurations: false, extensions: [], submoduleCfg: [], 
userRemoteConfigs: [[credentialsId: 'c8634952-4993-4455-b164-35427823144f', url: 
'ssh://[email protected]:222/lagou/jenkinsdemo.git']]]) 
                       } 
               }

测试任务
点击立即构建

Pipeline Script from SCM

刚才我们都是直接在Jenkins的UI界面编写Pipeline代码，这样不方便脚本维护，建议把Pipeline脚本放在项目中（一起进行版本控制）

Jenkinsfile文件

在jenkinsdemo项目根目录创建/Jenkinsfile文件。Jenkinsfile文件内容如下：

pipeline { 
    agent { 
        label 'jenkinsagent-154' 
      }
      
    stages { 
        stage('检测环境') { 
            steps { 
                sh label: '', script: '''java -version 
                mvn -v 
                git version 
                docker -v''' 
              } 
        }
        stage('拉取代码') { 
            steps { 
                echo 'gitlab拉取代码' 
                checkout([$class: 'GitSCM', branches: [[name: '*/master']], 
                doGenerateSubmoduleConfigurations: false, extensions: [], submoduleCfg: [], 
                userRemoteConfigs: [[credentialsId: 'c8634952-4993-4455-b164-35427823144f', 
                url: 'ssh://[email protected]:222/lagou/jenkinsdemo.git']]]) 
                } 
            }
        stage('编译构建') { 
            steps { 
                echo 'mvn 编译构建' 
            }
        }
        stage('项目部署') {
            steps { 
                echo 'java项目部署'
            }
        }
    }
}

修改pipeline项目

配置 SCM相关配置

测试pipeline项目

查看控制台输出信息