在jenkins中创建pipeline流水线项目

1,937 阅读5分钟

这是我参与8月更文挑战的第3天,活动详情查看:8月更文挑战

部份参考自 黑马程序员Java教程自动化部署Jenkins从环境配置到项目开发

pipeline流水线项目

简介

  • 概念

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

  • 优势
  • 代码:Pipeline以代码的形式实现,通常被检入源代码控制,使团队能够编辑,审查和迭代其传送流 程。
  • 持久:无论是计划内的还是计划外的服务器重启,Pipeline都是可恢复的。 可停止:Pipeline可接 收交互式输入,以确定是否继续执行Pipeline。
  • 多功能:Pipeline支持现实世界中复杂的持续交付要 求。它支持fork/join、循环执行,并行执行任务的功能。
  • 可扩展:Pipeline插件支持其DSL的自定义扩 展 ,以及与其他插件集成的多个选项。
  • 贴士
  • Pipeline 脚本是由 Groovy 语言实现的,但是我们没必要单独去学习 Groovy
  • Pipeline 支持两种语法:Declarative(声明式)和 Scripted Pipeline(脚本式)语法
  • Pipeline 也有两种创建方法:
  • 可以直接在 Jenkins 的 Web UI 界面中输入脚本;
  • 也可以通过创建一 个 Jenkinsfile 脚本文件放入项目源码库中(一般我们都推荐在 Jenkins 中直接从源代码控制(SCM) 中直接载入 Jenkinsfile Pipeline 这种方法)。
  • 通常建议使用Declarative(声明式),只有在复杂项目时才采用脚本式

安装pipeline插件

image-20210519160939109

创建流水线项目

image-20210519161009364

Pipeline语法快速入门

下面将直接在 Jenkins 的 Web UI 界面中输入脚本

Declarative声明式

  • 流水线->选择HelloWorld模板

image-20210728202514441

  • 生成内容如下:
 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('Pull') {
             steps {
                 echo 'pull code'
             }
         }
         stage('Build') {
             steps {
                 echo 'Build project'
             }
         }
         stage('publish') {
             steps {
                 echo 'publish project'
             }
         }
     }
 }

image-20210728203733412

  • 构建完后可以看到流水线项目特有的阶段视图

image-20210728203634918

Scripted脚本式

  • 流水线->选择Scripted Pipeline模板

image-20210728204141222

  • 下面是Scripted的框架
 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('Pull') { // for display purposes
         echo 'pull code'
     }
     stage('Build') {
         echo 'build project'
     }
     stage('publish') {
         echo 'publish project'
     }
 }

构建结果和声明式一样。

编写pipeline构建项目

下面还是直接在 Jenkins 的 Web UI 界面中输入,我们使用声明式语法

我们不需要自己去编写复杂的脚本,我们可以靠jenkins自带的工具来生成对应的语法,点击【流水线语法】

image-20210728210043104

image-20210728214348769

  • 通过【片段生成器】来选择要生成的代码样式

1. 拉取代码

  • 选择checkout,选择git,填入仓库地址,选择对应凭证,点击【生成流水线脚本】

image-20210728215616248

image-20210728215643886

  • 复制粘贴到steps里面去

image-20210728215736851

2. 编译打包

  • 选择shell

image-20210728220210092

  • 写入maven命令
 mvn clean package

image-20210728220322535

  • 复制生成后的代码到steps

3. 部署

  • 选择deploy

image-20210728220549312

  • 写入war包地址

image-20210728221103374

  • 选择容器类型,我们的tomcat是8.5.69

image-20210728221124362

  • 填入tomcat地址

image-20210728221218844

  • 复制生成后的代码到steps

构建

 pipeline {
     agent any
 ​
     stages {
         stage('Pull') {
             steps {
                checkout([$class: 'GitSCM', branches: [[name: '*/master']], extensions: [], userRemoteConfigs: [[credentialsId: '565ba95c-7302-465d-bdc4-55d561d7b6e7', url: 'https://gitee.com/whitesheep-y/javaweb_test.git']]])
             }
         }
         stage('Build') {
             steps {
                 sh 'mvn clean package'
             }
         }
         stage('publish') {
             steps {
                 deploy adapters: [tomcat8(credentialsId: '2c037f4f-7484-4e0f-b795-1e3a870b24ec', path: '', url: 'http://192.168.1.107:8888/')], contextPath: null, war: 'target/*.war'
             }
         }
     }
 }
  • 应用保存,返回项目,点击构建

image-20210728221554339

  • 成功

创建Jenkins脚本文件

我们上面的过程是把脚本放在Jenkins的UI界面里,那么这样的问题是维护麻烦。我们后续会根据我们构建的步骤来更改脚本的代码,而这种做法没有进行版本控制。还有一个问题是一旦Jenkins服务器崩溃,这些脚本也会丢失。

所以我们更推荐使用文件的方式,把脚本放在项目下面,这样我们的脚本文件会随着我们代码的推送同步到仓库里面

  • 在项目根目录下创建Jenkinsfile文件,把脚本代码放进去,注意不能有后缀,比如.txt

image-20210728223917962

  • 然后推送到仓库。

image-20210728224305451

  • 返回项目配置,在流水线处选择Pipeline script from ASCM

image-20210728223359576

  • 设置好相关参数,脚本路径注意匹配

image-20210728223533286

  • 重新构建

image-20210728224148743

  • 成功,自此我们初步实现了实现可编程脚本式自动化持续集成与部署