Jenkins

最新推荐文章于 2024-05-30 22:02:17 发布
最新推荐文章于 2024-05-30 22:02:17 发布
阅读量443 收藏 1
点赞数
分类专栏： Jenkins 文章标签： jenkins
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_42236972/article/details/116082674
版权

Jenkins

前言

在了解Jenkins之前我们可能需要了解CI/CD的概念。CI/CD 是一种通过在应用开发阶段引入自动化来频繁向客户交付应用的方法。CI/CD 的核心概念是持续集成、持续部署。

CI 是什么？CI 和 CD 有什么区别？

缩略词 CI / CD 具有几个不同的含义。CI/CD 中的“CI”始终指持续集成，它属于开发人员的自动化流程。成功的 CI 意味着应用代码的新更改会定期构建、测试并合并到共享存储库中。该解决方案可以解决在一次开发中有太多应用分支，从而导致相互冲突的问题。

CI/CD 中的“CD”指的是持续交付或持续部署，这些相关概念有时会交叉使用。两者都事关管道后续阶段的自动化，但它们有时也会单独使用，用于说明自动化程度。

什么是持续集成？

持续集成（Continuous integration，简称CI）指的是，频繁的将代码集成到主干。

持续集成的目的，就是上产品可以快速迭代，同时还能保持高质量。它的核心措施是，代码集成到主干之前，不惜通过自动化测试。只要有一个测试用例，就不能集成。

通过持续集成，团队可以快速的从一个功能到另一个功能，简而言之，敏捷软件开发很大一部分都要归功于持续集成。

什么是持续部署？

对于一个成熟的 CI/CD 管道来说，最后的阶段是持续部署。作为持续交付——自动将生产就绪型构建版本发布到代码存储库——的延伸，持续部署可以自动将应用发布到生产环境。由于在生产之前的管道阶段没有手动门控，因此持续部署在很大程度上都得依赖精心设计的测试自动化。

实际上，持续部署意味着开发人员对应用的更改在编写后的几分钟内就能生效（假设它通过了自动化测试）。这更加便于持续接收和整合用户反馈。总而言之，所有这些 CI/CD 的关联步骤都有助于降低应用的部署风险，因此更便于以小件的方式（而非一次性）发布对应用的更改。不过，由于还需要编写自动化测试以适应 CI/CD 管道中的各种测试和发布阶段，因此前期投资还是会很大。

持续集成/部署的好处

1、降低风险，由于持续集成不断去构建，编译和测试，可以很早期发现问题，所以修复的代价就少；

2、对系统健康持续检查，减少发布风险带来的问题；

3、减少重复性工作；

4、持续部署，提供可部署单元包；

5、持续交付可提供使用的版本；

6、增强团队信心；

持续集成部署流程说明

image.png

1）首先，开发人员每天进行代码提交，提交到Git仓库

2）然后，Jenkins作为持续集成工具，使用Git工具到Git仓库拉取代码到集成服务器，再配合JDK， Maven等软件完成代码编译，代码测试与审查，测试，打包等工作，在这个过程中每一步出错，都重新再执行一次整个流程。

3）Jenkins把生成的jar或war包分发到测试服务器或者生产服务器，测试人员或用户就可以访问 应用。

Jenkins概念

Jenkins是一个独立的开源软件项目，是基于Java开发的一种持续集成工具，用于监控持续重复的工作，旨在提供一个开放易用的软件平台，使软件的持续集成变成可能。前身是Hudson是一个可扩展的持续集成引擎。可用于自动化各种任务，如构建，测试和部署软件。

Jenkins官网： http://jenkins-ci.org/

主要用于：
  1. 持续、自动地构建/测试软件项目，如CruiseControl与DamageControl。
  2. 监控一些定时执行的任务。
环境搭建

Jenkins支持各个平台上的搭建过程，开发我们主要在Linux和win7上玩转Jenkins，这边主要通过win7下介绍Jenkins玩法，Linux上大同小异。

Jenkins特点：
  • 开源免费;
  • 跨平台，支持所有的平台;
  • master/slave支持分布式的build;
  • web形式的可视化的管理页面;
  • 安装配置超级简单;
  • tips及时快速的帮助;
  • 已有的200多个插件
Jenkins 安装环境

1.打开Jenkins 官网

image.png

2.点击图中的Download 按钮，我们将看到如下内容

image.png
3.右键管理员身份运行该安装包，避免权限不足等原因导致安装失败。

image.png
4.点击Next 进入这个界面

image.png
5.如果不需要修改安装路径，直接点击Next即可。这里建议修改成D:\Applications\Jenkins\

image.png

6.接下来我们来到这个界面

image.png

7.然后配置一个端口，端口范围在1-65535之间任意一个数字，可以通过Test Port 测试端口是否被其他程序占用。

image.png
8.然后配置一个端口，端口范围在1-65535之间任意一个数字，可以通过Test Port 测试端口是否被其他程序占用。

image.png

9.如果测试通过，如上图所示，然后我们点击Next.

image.png

10.这里我们需要选择JDK 路径，可以选择jdk 1.8 或JDK 11.
PS: 这里建议安装JDK 1.8 ,这是因为目前lombok 貌似不支持JDK 11，如果贸然使用JDK 11
,你的程序使用了Lombok 则可能无法构建成功。

image.png
11.然后我们来到这个界面，这时候我们点击Install 即可进行安装。

image.png

12.点击Finished 后会自动打开浏览器的 http://localhost:8080/login?from=%2F

image.png
双击图中路径，从这个路径中找到密码
C:\Windows\System32\config\systemprofile\AppData\Local\Jenkins.jenkins\secrets\

13.将密码输入上面的输入框中点击继续，即可打开界面

image.png
这里我们可以选择安装的Jenkins 插件，如果不太熟，新手建议选择安装推荐的插件
以后如果熟悉了可以选择自定义的插件。

14.然后这里就会开始安装

image.png

  1. 耐心等待片刻，即可安装完成。

image.png

16.点击保存并完成。

image.png
17.再次点击保存并完成

image.png
18.到这一步之后点击开始使用Jenkins 即可打开这样的界面

image.png

Jenkins API 接口

Jenkins 作为项目构建,持续部署必不可少的工具,如何使用程序或者脚本来控制构建流程成为本文研究的内容.
默认情况下,安装好Jenkins后,/api路径下面有一些基本 api 的介绍,可供参考,但是不是很直观,没有罗列出 api 接口.

本文使用的 jenkins-java 客户端是:

<dependency>
	<groupId>com.offbytwo.jenkins</groupId>
	<artifactId>jenkins-client</artifactId>
	<version>0.3.7</version>
</dependency>

假设 jenkins 部署地址为: http://localhost:8080

本文用到的 api:

名称API
创建 JobPOST http://localhost:8080/createItem/api/json?name=xxx
更新 JobPOST http://localhost:8080/job/{job_name}/config.xml/api/json
获取 JobGET http://localhost:8080/job/{job_name}/api/json
获取 JobXmlGET http://localhost:8080/job/{job_name}/config.xml/api/json
创建 BuildPOST http://localhost:8080/job/{job_name}/build/api/json
获取 QueueItemGET http://localhost:8080/queue/item/17/api/json
获取 Build信息GET http://localhost:8080/job/test/6/api/json
获取TXT日志GET http://localhost:8080/job/test/{build_number}/logText/progressiveText/api/json
获取 Html 日志GET http://localhost:8080/job/test/{build_number}/logText/progressiveHtml/api/json
创建 Job API

jenkins 的配置都是靠 xml 的格式落地的,所以配置其实都是 xml 的形式.

POST http://localhost:8080/createItem/api/json?name=xxx

将创建需要的 config.xml也用请求传入到服务端,既可以创建成功.

如何知道 config.xml应该如何编写呢?

  • 可以在 jenkins 收工创建一个需要的项目,然后编辑完成后,到 jenkins 工作目录下 找到 jobs/{job_name}/config.xml 用他作为模板来书写你需要的模板.
  • 通过获取 xml 的 api 来获取
GET http://localhost:8080/job/{job_name}/config.xml/api/json

Java Client

jenkinsServer.createJob("auto_test_job", replacedText, true);
String xml = jenkinsServer.getJobXml("auto_test_job");
修改 Job API

修改 job 也是修改xml.

POST http://localhost:8080/job/{job_name}/config.xml/api/json

config.xml的内容传入到 body 中,contentType 设置为text/xml

Java Client

 jenkinsServer.updateJob("auto_test_job", replacedText, true);
构建 Build API
根据 job 名称获取 Job
GET http://localhost:8080/job/{job_name}/api/json
新的构建
POST http://localhost:8080/job/{job_name}/build/api/json

提交到服务器成功后返回一个类似于队列ID的东西,因为是异步构建,那么要获取构建的状态,就需要,用这个队列 id去进一步的获取. 例如:

 $ curl -v  -XPOST http://localhost:8080/job/test/build/api/json
*   Trying ::1...
* TCP_NODELAY set
* Connected to localhost (::1) port 8080 (#0)
> POST /job/test/build/api/json HTTP/1.1
> Host: localhost:8080
> User-Agent: curl/7.54.0
> Accept: */*
>
< HTTP/1.1 201 Created
< Date: Sat, 05 Jan 2019 08:33:45 GMT
< X-Content-Type-Options: nosniff
< Location: http://localhost:8080/queue/item/17/
< Content-Length: 0
< Server: Jetty(9.4.z-SNAPSHOT)
<
* Connection #0 to host localhost left intact

上面的Location: http://localhost:8080/queue/item/17/就是返回的队列信息,下面的 queueItem 获取就是依赖这个.

根据 QueueId 获取 QueueItem
GET http://localhost:8080/queue/item/17/api/json

举例

$ curl  http://localhost:8080/queue/item/17/api/json\?pretty\=true
{
  "_class" : "hudson.model.Queue$LeftItem",
  "actions" : [
    {
      "_class" : "hudson.model.CauseAction",
      "causes" : [
        {
          "_class" : "hudson.model.Cause$UserIdCause",
          "shortDescription" : "由用户 anonymous 启动",
          "userId" : null,
          "userName" : "anonymous"
        }
      ]
    }
  ],
  "blocked" : false,
  "buildable" : false,
  "id" : 17,
  "inQueueSince" : 1546677225670,
  "params" : "",
  "stuck" : false,
  "task" : {
    "_class" : "hudson.maven.MavenModuleSet",
    "name" : "test",
    "url" : "http://localhost:8080/job/test/",
    "color" : "blue"
  },
  "url" : "queue/item/17/",
  "why" : null,
  "cancelled" : false,
  "executable" : {
    "_class" : "hudson.maven.MavenModuleSetBuild",
    "number" : 6,
    "url" : "http://localhost:8080/job/test/6/"
  }
}

获取到的 QueueItem 上面就知道这个 item 有没有被 build 执行,比较关键的参数就是executable,如果executable不为空,就说明 jenkins 已经在对这个任务进行 build 的了,build 的编号就是number,也就是我们在 jenkins 页面上看到的编号.你可以通过url字段的值在浏览器打开.

获取 Build 详情

既然开始了 build,我们就可以获取 build 的详细信息.

curl http://localhost:8080/job/test/6/api/json\?pretty\=true
{
  ...
  "building" : false,
  "description" : null,
  "displayName" : "#6",
  "duration" : 13631,
  "estimatedDuration" : 17999,
  "executor" : null,
  "fullDisplayName" : "test #6",
  "id" : "6",
  "keepLog" : false,
  "number" : 6,
  "queueId" : 17,
  "result" : "SUCCESS",
  "timestamp" : 1546677234794,
  "url" : "http://localhost:8080/job/test/6/",
  "builtOn" : "",
 ...
}

从返回结果可以看到 是否还在 build:"building" : false,,如果 build 结束状态就在:"result" : "SUCCESS",

获取Build日志

文本:

GET http://localhost:8080/job/test/{build_number}/logText/progressiveText/api/json

html

GET http://localhost:8080/job/test/{build_number}/logText/progressiveHtml/api/json

Java Client

JobWithDetails job = jenkinsServer.getJob(jenkinsJob);
...
 QueueReference reference = job.build( true);
...
QueueItem queueItem = jenkinsServer.getQueueItem(new QueueReference(queuePart));
...
Build build = jenkinsServer.getBuild(queueItem);
...
BuildWithDetails details = build.details();
BuildResult result = details.getResult();
...
String logs =  details.getConsoleOutputText();

Jenkins 调用API 相关问题

org.apache.http.client.HttpResponseException: Forbidden
	at com.offbytwo.jenkins.client.validator.HttpResponseValidator.validateResponse(HttpResponseValidator.java:11)
	at com.offbytwo.jenkins.client.JenkinsHttpClient.post(JenkinsHttpClient.java:261)
	at com.offbytwo.jenkins.client.JenkinsHttpClient.post(JenkinsHttpClient.java:221)

按ctrl键进去看源码，此post方法在这里传了一个crumbFlag参数，

传一个true进来，这里就会去获取crumb值，

获取到的信息长这个样子：
{"_class":“hudson.security.csrf.DefaultCrumbIssuer”,“crumb”:“2e214ad29c6319a985dde08d70818c1287a7f1ae077d4e65156d6e636d5a67bd”,“crumbRequestField”:“Jenkins-Crumb”}

然后将其中的crumb值放入到请求头中。

API调用的如果遇到类似的问题，可以在方法中传入crumbFlag参数 true即可。

keys落寞
关注
  • 0
    点赞
  • 踩
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
JenkinsAPI实现—JAVA
BUGdeQD的博客
12-09 1429
通过JAVA 操作 Jenkins API，实现对 Jenkins Job、View等等的增、删、改、查操作。 参靠及项目地址： Jenkins API wiki 地址：https://wiki.jenkins.io/display/JENKINS/Remote+access+API Jenkins-Java-Client Github 地址：https://githu...
java调用JenkinsServer API操作
red_blue2的博客
09-18 3915
java调用JenkinsServerServer API操作1.下载配置jenkins1.1 下载jenkins1.2 配置jenkins2.java调用JenkinsServerServer API2.1、Jenkins API 格式2.2 操作Jenkins 视图 （view）2.3 操作 Jenkins 任务（job）2.4 操作 Jenkins 编译（build）2.5 对 Java Client 组件的补充 参考文档: 利用 Java 操作 Jenkins API 实现对 Jenkins 的控制
Jenkins持续集成之修改jenkins工作目录
最新发布
别人的故事，是参考答案，而不是标准答案
05-30 546
一般不建议把工作目录放到默认的C盘，故可以更改到其他盘中
com.offbytwo.jenkins jenkins-client在添加springweb依赖之后报错URI does not specify a valid host name
qq_46274911的博客
04-23 427
Jenkins API 报错
Jenkins offbytow
weixin_36723134的博客
07-02 732
首先导入jar包： com.offbytwo.jenkins.JenkinsServer 1.create job： (1). getJenkinsServer(){ return new new JenkinsServer(URI.create(jenkinsUrl), jenkinsUsername, jenkinsPassword); } (2). generateConfigXml(){...
Get Jenkins job build queue length
SDET亮子的记事本
12-28 1776
Jenkins API doesn’t provide the job build queue length. Hence, it seems we have to parse the html to get the job build queue length Jenkins API 没有提供job build 队列长度，所以貌似只能用解析Html的方法取之。Python:from Beauti
Jenkins的item-引用同一个Jenkins的其他item
StudyHappiness的博客
06-07 822
Jenkins的item-引用同一个Jenkins的其他item，item引用指定路径的文件
jenkins
huan_128的专栏
07-14 304
目录 1、General 2、重试次数 3、构建触发器 选择构建一个自由风格的软件项目，点击OK 1、General 进入项目内进行配置 commit agent's Docker container Define a Docker templater Discard old builds GitHub 项目 This build requires lockable resources This project is parameterized Throttle build
Jenkins打包配置文件
03-11
Jenkins是一款开源的持续集成（Continuous Integration，简称CI）服务器，它可以帮助开发团队自动化软件构建、测试和部署的过程。在“Jenkins打包配置文件”这个主题中，我们主要讨论的是如何管理和配置Jenkins来...
jenkins老版本资源
11-09
Jenkins 是一款开源的持续集成（Continuous Integration, CI）服务器，它被广泛应用于软件开发过程中，用于自动化构建、测试和部署任务。这个压缩包文件集合提供了 Jenkins 的老版本及其相关资源，这对于那些需要...
jenkins官方最新版
03-30
jenkins官方最新版
jenkins压缩包，jdk8，jenkins.war以及Jenkins安装及配置的pdf
11-01
这个压缩包包含Jenkins的基础环境——JDK8，Jenkins的核心文件——jenkins.war，以及一份关于Jenkins安装和配置的PDF指南，对于学习和部署Jenkins的初学者来说是非常有价值的资源。 首先，我们来详细了解一下...
windows下安装Jenkins 2.289.3 jenkins.msi
01-24
jdk1.8支持的最后一个版本jenkins，验证可用Jenkins Jenkins 2.289.3 jenkins.msi jdk1.8支持的最后一个版本jenkins，验证可用Jenkins Jenkins 2.289.3 jenkins.msi jdk1.8支持的最后一个版本jenkins，验证可用...
jenkins.war-2.356，适合JDK8的最后jenkins版本
06-21
1. **安装与配置**：Jenkins可以通过下载`jenkins.war`文件，然后在Java环境中运行`java -jar jenkins.war`启动。也可以选择将其部署到像Tomcat这样的Web容器中。配置过程中，需要设定Jenkins的URL、初始化密码，并...
利用Java操作Jenkins API实现对Jenkins的控制详解_java jenkins api(1)
2301_79655589的博客
05-12 1346
经过日积月累， 以下是小编归纳整理的深入了解Java虚拟机文档，希望可以帮助大家过关斩将顺利通过面试。由于整个文档比较全面，内容比较多，篇幅不允许，下面以截图方式展示。由于篇幅限制，文档的详解资料太全面，细节内容太多，所以只把部分知识点截图出来粗略的介绍，每个小节点里面都有更细化的内容！本文已被CODING开源项目：【一线大厂Java面试题解析+核心总结学习笔记+最新讲解视频+实战项目源码】收录需要这份系统化的资料的朋友，可以点击这里获取。
Jenkins使用经验谈4（创建Job）
乱码人生
10-22 441
前面做了那么多工作，现在终于到了创建Job这一步了，某种意义上，Jenkins的主要工作就是为了调度这些Job。Job的创建是有很大自由度的，也没有谁规定一定要创建成什么样子才行。下面我会以实际使用中的几个场景来举例说明。 需要注意的是： [list] [*]Job名称千万不要用中文名称（不作死就不会死）。 [*]创建Job名称时最好有个规划，因为我们最后会通过正则匹配自动将Job归类...
java代码检查 jenkins_java调用jenkins-client实现任务增删查改 互联网技术圈 互联网技术圈...
weixin_32219363的博客
02-24 588
实现对jenkins任务的增加，删除，修改，以及任务构建起始时间，结束时间，任务是否完成，所有任务信息，第N次构建结果，以及第N次构建日志，代码如下：package com.os.devops.jenkins.utils;import com.offbytwo.jenkins.JenkinsServer;import com.offbytwo.jenkins.model.Build;import ...
Jenkins系列三——创建一个job
浅抒流年的博客
06-06 1840
前言 上一篇文章简单介绍了下jenkins的功能已经安装，本篇文章来实际创建一个jenkins job来具体演示jenkins的使用方法。 话说，jenkins的使用其实和把大象放进冰箱需要几步一样
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值