Jenkins使用手册

本文介绍Jenkins的安装与使用。

下载

👉Jenkins官网下载页面

windows就下载for windows版本的(这里以windows环境安装为例)。

安装

Jenkins安装

安装完毕后会自动进入登陆页面:

Jenkins登陆页面

配置与使用

第一次启动你可能会有这样的问题:它会一直在这个登录页面自动刷新。

主要原因是Jenkins在启动的时候会去加载相关镜像文件,默认的镜像文件配置地址对我们比较不友好(你懂的),这就需要我们手动修改这个文件。

镜像配置

在Jenkins安装目录下,找到 hudson.model.UpdateCenter.xml 文件,打开并修改url为:https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json

镜像配置

镜像配置

修改后需要重启Jenkins服务。

当然你也有可能遇到端口冲突的问题,那么来修改一下端口吧。

修改端口

在安装目录下找到 Jenkins.xml 文件,这个就是端口配置的文件了。

启动Jenkins服务

如果是通过msi方式安装Jenkins的话(比如本安装教程),需要在系统的“服务”中找到Jenkins服务,点击重启即可(可自行百度怎么进入服务管理页面,这里直接用搜索工具进入)

windows启动Jenkins服务

windows启动Jenkins服务

重启后再进入登陆页面就可以正常进入了:

Jenkins首次登录页面

登陆

第一次登陆时需要修改密码,密码在页面上有提示其文件地址(在安装目录下 \secrets\initialAdminPassword 文件中),打开这个文件就能看到初始化密码了。

初始化密码

将其复制进页面的输入框即可进入自定义Jenkins页面,这里选择第一个“安装推荐的插件”。

首次插件安装

首次插件安装

若有部分插件安装失败,可以点“重试”,或者点击“继续”以后再安装。

首次插件安装

点击继续后就进入了初始化账户的页面:

初始化账户

最后一步可能会提示你部分插件重启,那我们就点击重启,也可以手动重启服务。

重启后的登陆页面就变了:

登录页面

输入刚才配置的账户密码即可进入功能页面了:

工作台

添加插件(自选)

管理Jenkins > 插件管理 > 可选插件 > 搜索框

插件安装

插件安装

插件安装

插件安装

这里我安装了:

  • 常用插件:Rebuilder、safe restart
  • Git相关插件:GitLab、GitLab API
  • SSH相关插件:SSH Agent、SSH

用户及权限配置

添加自定义用户

管理Jenkins > Security > 用户管理 > 新建用户

新建用户后需要给该用户授权。

(这里我创建了一个test01用户)

配置全局安全属性(授权)

管理Jenkins > Security > Configure Global Security

在“授权策略”中选择“安全矩阵” > 添加用户/组,添加用户后,可以在表格中进行勾选,勾选后点击保存(表格最后面有个全选按钮)。例如:如果不想要给予用户访问系统管理的权限,全勾选后去掉第一项。

配置全局安全属性(授权)

将Linux注册到Jenkins上

新建节点

进入Jenkins,管理Jenkins > 管理节点 > 新建节点

输入name

远程工作目录:/root/.jenkins

​ 启动方法:launch slave agents via SSH

​ 主机:linux 的ip地址,

点击 credentials 下的 add 按钮,添加用户名和密码(linux的账户密码),添加完成后通过下拉框选择

​ 保存

管理节点

新建节点

(新版本的启动方式是 launch agents via SSH,需要将 Host Key Verification Strategy 修改为 Non verifying Verification Strategy)

测试节点

在jenkins的节点页面,选择上一步新增的节点,点击节点名,进入页面后点击 launch agent 按钮(或者启动代理)即可连接。

测试节点

测试节点

节点配置好了,现在开始新建一个任务吧!

任务创建与构建

  1. 在Jenkins主页,新建一个任务 > 构建一个自由风格的软件项目 > OK。

  2. 在General标签页,勾选 Restrict where this project can be run,在 Label Expression中输入刚才创建的Linux环境的名称(只允许在指定环境上运行)。

  3. 在构建标签页,增加构建步骤,excute shell,输入要执行的命令(如 ifconfig)。

  4. 保存。

  5. 回到Jenkins主页,点击立即构建。

  6. 执行完毕后,点击下方的执行记录的任务名(如#1),进入任务详情页,点击 console output ,就可以看到刚才的命令(ifconfig)输出了。

任务创建与构建

任务创建与构建

任务创建与构建

任务创建与构建

任务创建与构建

任务创建与构建

任务创建与构建

任务创建与构建

任务创建与构建

本次分享中的构建脚本示例

构建脚本示例

另外,Jenkins也可以实现定时任务自动构建(已演示)。

构建触发器

写在最后

本次分享中未涉及Jenkins与git持续集成,如果有类似“在提交代码到服务器后能够自动构建“的需求,可网上自行搜索解决方案,这里可以提供一个方案参考:webhook。


Jenkins使用手册
https://binbiubiu.github.io/20200723120000/
作者
Binbiubiu
发布于
2020年7月23日