Windows下Jenkins软件安装说明及配置

范围

2 Jenkins 官网

Jenkins官网:Jenkins
Jenkins 各版本下载路径:Jenkins 的安装和设置
Jenkins 插件下载路径:Jenkins Plugins
Jenkin 帮助文档:Using Jenkins

2.1 Windows下jenkins安装

Msi安装包下载路径:[https://get.jenkins.io/windows-stable/2.401.3/jenkins.msi](https://www.jenkins.io/download/" \l "downloading-jenkins)

2.1.1 安装步骤

步骤1:打开安装包



步骤2:选择目标文件夹
选择存储 Jenkins 安装的目标文件夹,然后单击下一步继续。


图2-2 选择目标文件夹
步骤 3:服务登录凭据
安装 Jenkins 时,建议以独立身份安装和运行 Jenkins 使用本地或域用户的Windows服务,因为它比运行Jenkins安全得多 使用LocalSystem(Windows相当于root),这将授予Jenkins完全访问权限 到您的机器和服务。

要使用本地或域用户运行 Jenkins 服务,请指定域用户名和 你想用来运行 Jenkins 的密码, 单击测试凭据以测试您的域凭据,然后单击下一步。


注意:如果在尝试测试凭据时弹出“无效登录错误”弹出窗口, 请按照此处说明的步骤解决此问题。
步骤 4:端口选择
指定 Jenkins 将在其上运行的端口,“测试端口” 按钮以验证指定的端口是否在您的计算机上可用。 因此,如果端口空闲,它将显示一个绿色的对勾,如下所示, 然后点击下一步


步骤 5:选择 Java 主目录
安装过程会检查计算机上的 Java,并使用 Java 主目录。 如果您的计算机上未安装所需的 Java 版本,系统将提示您安装它。
选择 Java 主目录后,单击“下一步”继续。
JDK17下载路径:Java JDK 17 (64-bit) Download for PC


第 6 步:自定义设置
选择需要使用 Jenkins 安装的其他服务,然后单击下一步。


第 7 步:安装 Jenkins
单击安装按钮,开始安装 Jenkins。


此外,单击“安装”按钮将显示安装进度条, 如下图所示:


第 8 步:完成 Jenkins 安装
安装完成后,单击“完成”以完成安装。


Jenkins 将作为 Windows 服务安装。可以通过下图来查看 “jenkins服务”,如下所示:

2.1.2 使用 MSI 安装程序进行静默安装

MSI 安装程序可以通过静默方法安装,该方法可以显示基本 UI (/qb) 或根本不显示 UI (/qn)。silent 方法不会提示用户输入,因此可以将一些属性传递给安装程序以设置特定值。下面显示了静默安装的一个非常基本的命令行。
msiexec.exe /i “path\to\jenkins.msi” /qn /norestart
这将对通常作为提示的内容使用所有默认值,例如:

  • 安装目录
  • 服务帐户用户名/密码
  • Java 安装目录
  • Jenkins 监听的端口

可以通过为要重写的内容传递属性对来覆盖以下每一项:NAME=VALUE

属性名称描述
INSTALLDIR要安装 Jenkins 的目录的路径。(默认值:C:\Program Files\Jenkins)
PORT端口 Jenkins 将监听。(默认值:8080)
JAVA_HOME可以找到 java.exe 的目录。(默认值:在注册表中找到的第一个 Java 运行时,Java 11 的优先级高于 Java 17)
SERVICE_USERNAME运行服务的用户名。该帐户必须具有登录服务权限。(默认值:在静默模式下,本地系统帐户)
SERVICE_PASSWORDSERVICE_USERNAME帐户的密码。只有在提供SERVICE_USERNAME的情况下,才应提供此信息。(默认值:在静默模式下,对于本地系统无)

下面显示了一个更复杂的示例,包括为安装过程创建日志文件:
msiexec.exe /i “path\to\jenkins.msi” /qn /norestart INSTALLDIR=“D:\Jenkins” JAVA_HOME=“C:\Program Files\SomeJava” PORT=80 /Lv* “path\to\logfile.txt”
这会将 Jenkins 安装到 D:\Jenkins 中,使用 C:\Program Files\SomeJava 中的 Java 运行时,Jenkins 将侦听端口 80。

2.1.3 安装后安装向导

下载、安装和运行 Jenkins 后,安装后安装向导开始。
此设置向导将引导您完成几个快速的“一次性”步骤来解锁 Jenkins,使用插件对其进行自定义并创建第一个管理员用户 通过它,您可以继续访问 Jenkins。
解锁Jenkins:
当您首次访问新的 Jenkins 实例时,系统会要求您使用 自动生成的密码。
步骤 1
浏览到(或您配置的任何端口) 安装时 Jenkins),然后等到****“解锁 Jenkins****”页面出现。http://localhost:8080


步骤 2
初始管理员密码应在 Jenkins 安装下找到 路径(在 Jenkins 安装中的步骤 2 中设置)。
对于 C:\Program Files\Jenkins 的默认安装位置,可以在 C:\Program Files\Jenkins\secrets 下找到一个名为 initialAdminPassword 的文件。
但是,如果选择了 Jenkins 安装的自定义路径,则应检查 初始管理员密码文件的位置。


步骤 3
打开突出显示的文件并复制初始管理员密码文件的内容。


步骤 4
在“解锁 Jenkins”页面上,将此密码粘贴到“管理员密码”字段中,然后单击****“继续****”。笔记:

  • 还可以在安装期间打开Jenkins 目录中的 ****jenkins.err.log 日志文件,****也可以获得初始密码。


如果您跳过后续用户创建步骤设置向导,此密码作为默认管理员帐户的密码 (用户名为“admin”)

2.1.4 使用插件自定义 Jenkins

解锁 Jenkins 后,自定义 Jenkins 页面 出现。在这里,您可以安装任意数量的有用插件作为您的一部分 初始设置。
单击显示的两个选项之一:

  • 安装建议的插件 - 安装推荐的插件集,其中 基于最常见的用例。
  • 选择要安装的插件 - 选择要最初安装的插件集 安装。首次访问插件选择页面时,建议 默认情况下会选择插件。

注意:如果您不确定需要哪些插件,请选择建议的安装 插件。 您可以在以后安装(或删除)其他 Jenkins 插件 通过Jenkins 中的 Manage Jenkins > Plugins页面。
安装向导显示正在配置的 Jenkins 的进度以及您的 选择一组正在安装的 Jenkins 插件。此过程可能需要一些时间。

2.1.5 创建第一个管理员用户

最后,在自定义 Jenkins 之后 插件,Jenkins 要求您创建您的第一个管理员用户。

当“创建第一个管理员用户”页面出现时,请指定 管理员用户,然后单击保存并完成。当“Jenkins 已准备就绪”页面出现时,单击“开始使用 Jenkins”。
笔记:此页面可能表明 Jenkins 几乎准备好了!如果是这样,请单击重新启动。
如果页面在一分钟后没有自动刷新,请使用您的网络 浏览器以手动刷新页面。
如果需要,请使用您刚刚的用户的凭据登录 Jenkins 创建后,您已准备好开始使用 Jenkins!

2.1.6 Windows下安装疑难解答

  1. 无效的服务登录凭据


安装要在域用户帐户下运行的服务时,该帐户必须具有作为服务登录的权限。此登录权限严格适用于本地计算机,并且必须在本地安全策略中授予。
执行以下步骤以编辑要定义“作为服务登录”权限的计算机的本地安全策略:

  1. 使用管理权限登录到计算机。
  2. 打开管理工具并打开本地安全策略
  3. 如果您的系统中缺少本地安全策略,请参阅在何处下载适用于 Windows 10 家庭版的 GPEdit.msc? 关于Microsoft社区的问题以进行故障排除的答案
  4. 展开本地策略,然后单击用户权限分配
  5. 在右窗格中,右键单击“作为服务登录”,然后选择“属性”。
  6. 单击“添加用户或组…”按钮以添加新用户。
  7. 在“选择用户或组”对话框中,找到要输入的用户,然后单击“确定”
  8. 单击“作为服务登录属性”中的“确定”以保存更改。

完成上述步骤后,尝试使用添加的用户再次登录。

2.1.7 Jenkins 重置密码

Jenkins密码忘记分两种情况。
一、刚开始安装Jenkins,没有修改过密码 找回:直接找initialAdminPassword,安装初始密码保存在此文件中,具体路径因人而异,可使用find命令查找文件查看,
二、密码之前修改过,但是再次登录时候忘记自己修改的密码了 找回:
1、删除Jenkins目录下config.xml文件中下面代码,并保存文件
true

true


true
false

2.重启Jenkins服务;
3.进入首页>“系统管理”>“Configure Global Security”;
4.勾选“启用安全”;
5.点选“Jenkins专有用户[数据库](https://cloud.tencent.com/solution/database?from=10680" \t "http://pingcode.escopetech.com/wiki/spaces/616d3d9189f4f94ca7c033f6/pages/_blank)”,并点击“保存”;
6.重新点击首页>“系统管理”,发现此时出现“管理用户”;
7.点击进入展示“用户列表”;
8.点击右侧进入修改密码页面,修改后即可重新登录

Jenkins插件安装

3.1 打开插件页面

3.2 插件页面菜单说明

**更新:**已经安装的插件,有新的版本,主要作用更新插件;
**可用插件:**插件服务器中所有插件,主要作用下载新的插件;
**已安装的插件:**已经下载安装的插件,有启用、停用、卸载的功能
**高级设置:**配置插件更新代理、插件离线安装包导入、插件升级站点

3.3 插件安装方法

安装jenkins插件有两种方法,一种是在线安装,一种是离线安装.两种方式介绍如下:
1.如果服务器可以上网,那边选择在线安装,安装流程为:
系统管理----插件管理—选择需要的插件直接安装即可


2.如果服务器不能上网,那么就只能离线安装,首先去下载所需插件:
Index of /download/plugins
然后将下载的插件,通过Jenkins插件管理——》高级——》选择文件——》Deploy
重启后插件即离线安装成功。

3.4 QT自动化编译常用插件

Gitlab
此插件允许 GitLab 在提交代码或打开/更新合并请求时触发 Jenkins 中的构建。还可以将构建状态返回 GitLab。
Gitlab Api
Gitlab令牌设置,访问GitlabAPI
Multiple SCMs
此插件允许 Jenkins 作业从多个 SCM 提供程序中签出源代码
**[Git Parameter Plug-In版本0.9.19](https://plugins.jenkins.io/git-parameter" \t "http://192.168.3.24:8080/manage/pluginManager/_blank) **
此插件允许您在构建中分配 git 分支、标签、拉取请求或修订号作为参数。
Email Extension
此插件允许您配置电子邮件通知的各个方面。您可以自定义电子邮件的发送时间、接收人员以及电子邮件的内容。
Rebuilder
此插件允许用户重新构建参数化构建,而无需再次输入参数。它还允许用户在重建之前编辑参数。

4 Jenkins配置钉钉通知

在我们实际工作中,Jenkins构建成功后的自动化报告除了发到邮箱,还可以进行钉钉通知。
钉钉通知的优点:

  • 实时提醒项目参与人员信息的更新;
  • 便于查看;

4.1 钉钉群机器人设置

  1. 进入钉钉群,依次点击群设置-智能群助手。

  1. 点击添加机器人,选择自定义机器人

  1. 填写机器人名称及自定义关键词,完成即可。

  1. 复制webhook,保存下来后续jenkins配置需要使用。

4.2 钉钉webhook配置

①Jenkins安装钉钉插件,依次进入系统管理-插件管理-可选插件,搜索DingTalk。

② 依次进入系统配置-钉钉全局设置,点击高级,配置钉钉机器人信息,配置完成后,点击测试按钮,看下能否发送成功。

  • id:可以不设置,增加时自动设置;
  • 名称:机器人别名;
  • webook:钉钉中添加自定义机器人时的webhook;
  • 关键字:钉钉机器人中填写的自定义关键字;
  • 加密:钉钉机器人中勾选加签后的内容(也可不设置)。

③ 测试发送成功后,在钉钉群可以收到通知,如下图:

4.3 项目配置构建钉钉通知

  • 勾选atAll:通知群内所有人
  • 指定人:输入框中输入要通知人的手机号(多个手机号之间用逗号或换行分隔)

配置完成后,点击应用-保存,点击任务的立即构建,构建后在钉钉群就可以收到通知了。​​​​​​​

5 Jenkins 配置邮件通知

5.1 Jenkins插件安装

安装Email Extension Plugin插件,由于我已安装,请打开Available plugins 菜单检索Email Extension

在Jenkins Location中配置系统管理员的邮箱地址,不进行配置的话将无法发送邮件

5.2 配置 Jenkins 默认邮件通知

【系统管理】----【系统配置】----【邮件通知】
点击“高级”,显示下列配置项,依次配置完成后,再点击“Test configuration”发送测试邮件。如返回“Email was successfully sent”,证明配置正确。

测试邮件返回邮件内容

邮件通知触发器


阿里企业邮箱SMTP服务器配置

协议服务器地址服务器端口号(常规)服务器端口号(加密)
POP3pop.qiye.aliyun.com110995
IMAPimap.qiye.aliyun.com143993
SMTPsmtp.qiye.aliyun.com25465

5.3 项目中配置Extended E-mail Notification

【选择 “构建后操作”】— 【增加“构建后操作步骤”】—【Editable E-mail Notification】
Extended E-mail Notification的所有配置项如下图所示,只需要配置几项即可,其他配置项默认就行。

  1. Project From:配置项目发件人
  2. Project Recipient List:配置接收邮件的邮箱(多个邮件之间用逗号分隔)
  3. Content Type:发送邮件的格式
  4. Default Subject:发送邮件的标题,默认与系统配置里的一致
  5. Default Content:发送邮件的内容,可自定义

5.4 邮件通知模板

<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>${PROJECT_NAME}-第${BUILD_NUMBER}次构建日志</title>
</head>
 
<body leftmargin="8" marginwidth="0" topmargin="8" marginheight="4"
    offset="0">
    <table width="95%" cellpadding="0" cellspacing="0"
        style="font-size: 11pt; font-family: Tahoma, Arial, Helvetica, sans-serif">
        <tr>
            <td>(本邮件由系统自动发出,无需回复!)</td>
             <td>以下为${PROJECT_NAME }项目构建报告详细信息</td> 
        </tr>
        <tr>
            <td><br />
            <b><font color="#0B610B">构建信息($BUILD_STATUS)</font></b>
            <hr size="2" width="100%" align="center" /></td>
        </tr>
        <tr>
            <td>
                <ul>
                    <li>项目名称 : ${PROJECT_NAME}</li>
                    <li>构建编号 : 第${BUILD_NUMBER}次构建</li>
                    <li>触发原因 : ${CAUSE}</li>
                    <li>构建日志 : <a href="${BUILD_URL}console">${BUILD_URL}console</a></li>
                    <li>工作目录 : <a href="${PROJECT_URL}ws">${PROJECT_URL}ws</a></li>
                    <li>打包目录 : <a href="{PROJECT_NAME}">${PROJECT_NAME}</a></li>
                    <li>Allure Report : <a href="${BUILD_URL}allure">${BUILD_URL}allure</a></li>
                </ul>
            </td>
        </tr>
        <tr>
            <td><b><font color="#0B610B">构建日志(最后100行):</font></b>
            <hr size="2" width="100%" align="center" /></td>
        </tr>
        <tr>
            <td><textarea cols="80" rows="30" readonly="readonly"
                    style="font-family: Courier New">${BUILD_LOG, maxLines=100}</textarea>
            </td>
        </tr>
    </table>
</body>
</html>

5.5 构建后收到邮件提醒

附件为构建日志

 

6 Jenkins配置Gitlab访问令牌

6.1 Gitlab访问令牌配置

在gitlab上创建一个访问令牌,用于jenkins访问gitlab api

注意:添加令牌时确认对目标项目有权限,否则一样无法访问,拉取代码最低Developer权限

具体权限参考:

Guest(匿名用户) - 创建项目、写留言薄

Reporter(报告人)- 创建项目、写留言薄、拉项目、下载项目、创建代码片段

Developer(开发者)- 创建项目、写留言薄、拉项目、下载项目、创建代码片段、创建合并请求、创建新分支、推送不受保护的分支、移除不受保护的分支 、创建标签、编写wiki

Master(管理者)- 创建项目、写留言薄、拉项目、下载项目、创建代码片段、创建合并请求、创建新分支、推送不受保护的分支、移除不受保护的分支 、创建标签、编写wiki、增加团队成员、推送受保护的分支、移除受保护的分支、编辑项目、添加部署密钥、配置项目钩子

Owner(所有者)- 创建项目、写留言薄、拉项目、下载项目、创建代码片段、创建合并请求、创建新分支、推送不受保护的分支、移除不受保护的分支 、创建标签、编写wiki、增加团队成员、推送受保护的分支、移除受保护的分支、编辑项目、添加部署密钥、配置项目钩子、开关公有模式、将项目转移到另一个名称空间、删除项目

令牌名称:可以随意填写,建议与项目或者用途有关,用于区分不同令牌

6.3 Jenkins添加Gitlab令牌

6.3.1 Gitlab配置

Connection name: 可以随便填,有实际意义就行例如 CI、CI_192.168.1.1

Gitlab host URL:填写实际的即可

Credential :选择Gitlab API token

API token 输入gitlab定义的个人令牌

ID留空或自定义,用于排序或别名

6.3.2 Gitlab API连接测试

配置完成后,点击Test Connection测试Gitlab api读取是否正常,如果提示信息为Success表示Token添加成功

  • 1
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
### 回答1: Windows系统下Jenkins安装配置如下: 1. 下载Jenkins安装包,可以从官网下载最新版本的Jenkins安装包。 2. 安装Jenkins,双击下载的Jenkins安装包,按照提示完成安装。 3. 启动Jenkins安装完成后,打开浏览器,输入http://localhost:808/,进入Jenkins的首页。 4. 配置Jenkins,首次启动Jenkins需要进行一些基本配置,如选择安装插件、创建管理员账号等。 5. 安装插件,Jenkins的插件是其功能的核心,可以根据需要选择安装不同的插件。 6. 创建任务,Jenkins的任务是指需要自动化执行的工作,可以根据需要创建不同的任务。 7. 配置任务,对于每个任务,需要配置其执行的脚本、触发条件、构建参数等。 8. 运行任务,配置完成后,可以手动运行任务,也可以设置自动触发条件,让Jenkins自动执行任务。 以上是Windows系统下Jenkins安装配置步骤,希望对您有所帮助。 ### 回答2: Jenkins是一款用Java编写的开源自动化构建工具。它具有可扩展性、灵活性、高度配置的特点,可以与各种编程语言和开发工具集成,支持自动化构建、测试和部署等工作的完成。 下面是Windows Jenkins安装配置的详细步骤: 1. 下载Jenkins:打开Jenkins的官方网站(https://jenkins.io/),选择Windows版本,然后下载最新的Jenkins.war文件。 2. 安装Jenkins:将Jenkins.war文件复制到某个目录下,然后在命令行中进入该目录执行"java -jar jenkins.war"命令,等待Jenkins启动成功。 3. 进入Jenkins:将浏览器访问"localhost:8080",将会看到Jenkins的欢迎界面,按照提示,选择插件和创建管理员用户。 4. 添加工具:在Jenkins中,工具是指构建所需的软件、工具或SDK。为了添加工具,需要转到"管理Jenkins"->"全局工具配置"中,然后添加所需的工具。 5. 创建项目:Jenkins中的项目是指使用开发语言或工具的特定任务。对于每个项目,需要定义一个构建任务。首先创建一个新项目,然后在项目中进行相应的设置。 6. 配置Jenkins配置Jenkins的方式有多种方式,包括添加全局设置、构建设置、环境变量、启动脚本等。配置的方式取决于使用的构建器和插件。 以上是Windows Jenkins安装配置的详细步骤。为了最大限度地利用Jenkins的自动化功能,需要深入研究Jenkins和各种插件的文档和使用场景。当您熟悉了Jenkins之后,可以使用Jenkins轻松管理、构建和自动化部署代码。 ### 回答3: Jenkins是一个流行的自动化构建和持续集成工具,它可用于自动构建、测试和部署软件,从而提高软件开发过程的效率。Windows系统是许多团队常用的开发操作系统之一,本文将介绍如何在Windows系统中安装配置Jenkins。 一、安装Jenkins 1.下载Jenkins安装程序:在Jenkins的官网下载选项中选择Windows版本的Jenkins,下载后保存到本地磁盘上。 2.安装Jenkins:双击下载的Jenkins安装程序,按照提示一步一步进行安装安装完毕后会出现Jenkins安装向导。 3.启动Jenkins服务:在安装向导最后一步中勾选“启动Jenkins”选项,然后点击“结束”以启动Jenkins服务。 二、访问Jenkins 1.访问Jenkins:在浏览器中输入“localhost:8080”,然后按回车键。如果看到Jenkins的首页,说明Jenkins已经安装成功。 2.设置Jenkins密码:访问Jenkins首页后,会提示设置Jenkins密码。请按照提示输入密码,并保存好。 三、配置Jenkins 1.安装构建工具:在Jenkins首页中,选择“系统管理”-“全局工具配置”,然后在相应的构建工具栏目中安装所需要的构建工具。 2.配置Jenkins插件:在Jenkins首页中,选择“系统管理”-“插件管理”,在插件管理页面中选择需要安装的插件,然后点击“安装”。 3.创建Jenkins Job:在Jenkins首页中,选择“新建项”,在“自由风格项目”中创建Jenkins Job。在创建Job时需要设置Job的名称、构建源代码的库、构建步骤、构建参数等。 4.执行构建:创建完Jenkins Job后,需要进行构建。选择Jenkins Job,在右侧菜单中选择“构建”,然后等待构建完成。 以上是Windows系统下Jenkins安装配置方法,总的来说,Jenkins是一款非常适合自动化构建和持续集成的工具。Jenkins安装配置需要注意一些细节,但只要按照上述步骤进行操作,便可以顺利完成安装配置。同时使用Jenkins还可以提高软件开发的效率,避免出现错误,减少人工干预。

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值