Jenkins使用手册
本文介绍Jenkins的安装与使用。
下载
windows就下载for windows版本的(这里以windows环境安装为例)。
安装
安装完毕后会自动进入登陆页面:
配置与使用
第一次启动你可能会有这样的问题:它会一直在这个登录页面自动刷新。
主要原因是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服务,点击重启即可(可自行百度怎么进入服务管理页面,这里直接用搜索工具进入)
重启后再进入登陆页面就可以正常进入了:
登陆
第一次登陆时需要修改密码,密码在页面上有提示其文件地址(在安装目录下 \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 按钮(或者启动代理)即可连接。
节点配置好了,现在开始新建一个任务吧!
任务创建与构建
在Jenkins主页,新建一个任务 > 构建一个自由风格的软件项目 > OK。
在General标签页,勾选 Restrict where this project can be run,在 Label Expression中输入刚才创建的Linux环境的名称(只允许在指定环境上运行)。
在构建标签页,增加构建步骤,excute shell,输入要执行的命令(如 ifconfig)。
保存。
回到Jenkins主页,点击立即构建。
执行完毕后,点击下方的执行记录的任务名(如#1),进入任务详情页,点击 console output ,就可以看到刚才的命令(ifconfig)输出了。
本次分享中的构建脚本示例
另外,Jenkins也可以实现定时任务自动构建(已演示)。
写在最后
本次分享中未涉及Jenkins与git持续集成,如果有类似“在提交代码到服务器后能够自动构建“的需求,可网上自行搜索解决方案,这里可以提供一个方案参考:webhook。