5.jenkins的项目构建

Jenkins构建的项目类型介绍

Jenkins中自动构建项目的类型有很多，常用的有以下三种

• 自由风格软件项目（FreeStyle Project）
• Maven项目（Maven Project）
• 流水线项目（Pipeline Project）

每种类型的构建其实都可以完成一样的构建过程与结果，只是在操作方式、灵活度等方面有所区别，在 实际开发中可以根据自己的需求和习惯来选择。（PS：个人推荐使用流水线类型，因为灵活度非常高）

1. 自由风格项目构建

前提是创建好gitlab的ssh和http方式的凭证

下面演示创建一个自由风格项目来完成项目的集成过程： 拉取代码->编译->打包->部署

1. 创建项目

   

2. 配置源码管理，从gitlab拉取代码

1. 编译打包

   构建->添加构建步骤->Executor Shell

   echo "开始编译和打包"
   mvn clean package
   echo "编译和打包结束"
   

2. 部署

​ 把项目部署到远程的Tomcat里面

​ 1）安装 Deploy to container插件

​ Jenkins本身无法实现远程部署到Tomcat的功能，需要安装Deploy to container插件实现

​ 2）添加Tomcat用户凭证

​ 3） 添加构建后操作

点击"Build Now"，开始构建过程，部署成功后，访问 http://192.168.66.102:8080/web_demo-1.0-SNAPSHOT/

2. Maven项目构建

1）安装Maven Integration插件

2）创建Maven项目

3）配置项目

拉取代码和远程部署的过程和自由风格项目一样，只是"构建"部分不同

3.Pipeline流水线项目构建

Pipeline简介

---

1）概念

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

2）使用Pipeline有以下好处（来自翻译自官方文档）：

代码：Pipeline以代码的形式实现，通常被检入源代码控制，使团队能够编辑，审查和迭代其传送流程。

1. ​ 持久：无论是计划内的还是计划外的服务器重启，Pipeline都是可恢复的。
2. 可停止：Pipeline可接收交互式输入，以确定是否继续执行Pipeline。
3. 多功能：Pipeline支持现实世界中复杂的持续交付要求。它支持fork/join、循环执行，并行执行任务的功能。
4. 可扩展：Pipeline插件支持其DSL的自定义扩展 ，以及与其他插件集成的多个选项。

3）如何创建 Jenkins Pipeline呢？

Pipeline 脚本是由 Groovy 语言实现的，但是我们没必要单独去学习 Groovy Pipeline 支持两种语法：Declarative(声明式)和 Scripted Pipeline(脚本式)语法

Pipeline 也有两种创建方法：

1. 直接在 Jenkins 的 Web UI 界面中输入脚本；
2. 通过创建一个 Jenkinsfile 脚本文件放入项目源码库中（一般我们都推荐在 Jenkins 中直接从源代码控制(SCM) 中直接载入 Jenkinsfile Pipeline 这种方法）。

安装Pipeline插件

---

安装插件后，创建项目的时候多了“流水线”类型

Pipeline语法快速入门

---

1）Declarative声明式-Pipeline 创建项目

流水线->选择HelloWorld模板

生成内容如下：

pipeline { agent any
 stages {
  stage('Hello') {
    steps {
      echo 'Hello World'
    }
  }
 }
}

stages：代表整个流水线的所有执行阶段。通常stages只有1个，里面包含多个stage

stage：代表流水线中的某个阶段，可能出现n个。一般分为拉取代码，编译构建，部署等阶段。

steps：代表一个阶段内需要执行的逻辑。steps里面是shell脚本，git拉取代码，ssh远程发布等任意内 容。

编写一个简单声明式Pipeline：

pipeline { agent any

stages {
stage('拉取代码') {
steps {
echo '拉取代码'
}
}
stage('编译构建') {
steps {
echo '编译构建'
}
}
stage('项目部署') {
steps {
echo '项目部署'
}
}
}

点击构建，可以看到整个构建过程

2）Scripted Pipeline脚本式-Pipeline

创建项目,这次选择"Scripted Pipeline"

node {
def mvnHome
stage('Preparation') {
// for display purposes
}
stage('Build') {
}
stage('Results') {
}
}

​ Node：节点，一个 Node 就是一个 Jenkins 节点，Master 或者 Agent，是执行 Step 的具体运行环境，后续讲到Jenkins的Master-Slave架构的时候用到。

​ Stage：阶段，一个 Pipeline 可以划分为若干个 Stage，每个 Stage 代表一组操作，比如：

​ Build、Test、Deploy，Stage 是一个逻辑分组的概念。

​ Step：步骤，Step 是最基本的操作单元，可以是打印一句话，也可以是构建一个 Docker 镜像， 由各类 Jenkins 插件提供，比如命令：sh ‘make’，就相当于我们平时 shell 终端中执行 make 命令一样。

编写一个简单的脚本式Pipeline

node {
def mvnHome
stage('拉取代码') { // for display purposes echo '拉取代码'
}
stage('编译构建') { echo '编译构建'
}
stage('项目部署') { echo '项目部署'
}
}

构建结果和声明式一样！采用脚本生成器生成各个阶段代码

pipeline { agent any

stages {
stage('拉取代码') { steps {
checkout([$class: 'GitSCM', branches: [[name: '*/master']], doGenerateSubmoduleConfigurations: false, extensions: [], submoduleCfg: [], userRemoteConfigs: [[credentialsId: '68f2087f-a034-4d39-a9ff-1f776dd3dfa8', url: 'git@192.168.66.100:itheima_group/web_demo.git']]])
}
}
stage('编译构建') { steps {
sh label: '', script: 'mvn clean package'
}
}
stage('项目部署') { steps {
deploy adapters: [tomcat8(credentialsId: 'afc43e5e-4a4e-4de6-984f- b1d5a254e434', path: '', url: 'http://192.168.66.102:8080')], contextPath: null, war: 'target/*.war'
}
}
}

3) Pipeline Script from SCM

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

1. 在项目根目录建立Jenkinsfile文件，把内容复制到该文件中

1. 把Jenkinsfile上传到Gitlab ,在项目中引用该脚本文件

   

4.Jenkins的参数化构建

有时在项目构建的过程中，我们需要根据用户的输入动态传入一些参数，从而影响整个构建结果，这时我们可以使用参数化构建。Jenkins支持非常丰富的参数类型

接下来演示通过输入gitlab项目的分支名称来部署不同分支项目。

1. 项目创建分支，并推送到Gitlab上

新新建分支：v1，代码稍微改动下，然后提交到gitlab上。这时看到gitlab上有一个两个分支：master和v1。

1. 在Jenkins添加字符串类型参数

改动pipeline流水线代码

点击Build with Parameters

输入分支名称，构建即可！构建完成后访问Tomcat查看结果

注意：

如果采用脚本方式构建，脚本代码同样需要修改引用参数

流水线需要加入所有可能的构建参数

1. 测试

构建时输入指定参数（分支），即可拉取相应分支的代码。