Jenkins 系统管理与配置
1. Jenkins 安装插件的两种方式
方式一:通过插件管理下载指定的插件
进入 Jenkins 首页-->系统管理-->插件管理-->可选插件页面,在右上角的过滤框中输入插件部分或全部名称并回车,在搜索出的内容中查找待安装的插件。
按照以下步骤在 filter 中输入想要安装的插件部分命名,比如我们想安装 GitHub Branch Source,输入 github 后回车,在筛选后的页面中找到想要的插件,勾选左侧的方框后,选择 install without restart 或者 Download now and install after restart。
(若已经安装过该插件,则显示不出来 github 的插件)如下提示表示安装成功:
方式二:上传已下载好的 .hpi 文件
进入 Jenkins 首页-->系统管理-->插件管理-->高级,将页面拉到最后,按如下操作:
如下提示表示安装成功:
2. 添加凭据(Credentials)
Jenkins 访问 tomcat 或者 github 是有可能会需要这些工具能够识别的凭证才能访问,Jenkins 也提供了设置 Credentials 的功能,有 2 种方法添加凭据:
方法一:在 Jenkins 首页的凭据中进行添加
进入 Jenkins 首页-->单击凭据:
如果之前添加过的话会显示所有添加的凭据,类似于以下内容:
添加新的凭据
凭据类型说明
- Secret text:例如 API token(例如 GitHub 的个人 access token)。
- Username with password:用户名和密码 ,可以作为单独的组件处理,也可以作为 username:password 格式的冒号分隔字符串来处理(请参阅处理凭据中的更多信息)。
- Secret file:包含密钥的文件 SSH Username with private key:一个 SSH 密钥对。注意:直接选择回车可以复制私钥的文本并将其粘贴到生成的密钥文本框中。
- Certificate:一个 PKCS#12 证书文件 和可选的密码。
为 github 添加 Username with password 类型的凭据
- 用户名和密码:如果该凭证是为 Jenkins 访问 github 使用的话,那么用户名和密码就是 github 登录的用户名和密码。
- ID:在 Jenkins 中使用的一个变量名。
方法二:新建任务后,配置过程中出现类似的操作按钮
直接单击 Add 添加凭据即可,出现如下的对话框,和方法一的一致:
3. 系统管理——全局工具配置
以上工具都有自动安装的选项,不过建议手动安装。
以上配置完成后,将页面拉到最后,单击 Save 保存即可。
4. 系统管理——系统设置
主目录
默认的主目录如下,可以点开右上角的问号,按照提示信息修改,一般不用改。
系统消息
可以点开右侧的问号,看到系统消息的作用就是显示在首页顶部的一些公告信息,比如输入内容如下:
单击保存后,回到 Jenkins 首页,可以看到如下内容:
该内容默认是纯文本形式的,如果想要更高级的可以使用 HTML 格式控制显示内容的格式,但是需要切换到设置-->Configure Global Security 中,标记格式器,选择 Safe HTML,如下:
再进入到系统管理-->系统设置,输入 HTML 格式的文本,保存。
在 Jenkins 首页显示的内容如下:
Maven 项目配置
执行者数量
默认值为 2,表示最多可以同时跑 2 个 job(有的版本叫 item)。
用法
有两个选项:
当 Jenkins 有多个执行节点情况下的使用规则:
- 尽可能的使用这个节点:这是默认和常用的设置。在这种模式下,Jenkins 会尽可能地使用这个节点。任何时候如果一个构建能使用这个节点构建,那么 Jenkins 就会使用它。
- 只允许运行绑定到这台机器的 Job:这种模式下,Jenkins 只会构建哪些分配到这台机器的 Job。这允许一个节点专门保留给某种类型的 Job。例如,在 Jenkins 上连续的执行测试,你可以设置执行者数量为 1,那么同一时间就只会有一个构建,一个实行者不会阻止其它构建,其它构建会在另外的节点运行。
生成等待时间
默认值是 5 秒,表示创建一个 job 或 item 中的构建在开始之前需要等待的秒数,一般不做修改。
SCM 签出重试次数
默认为 0,表示 Jenkins 从 git 或者其他源代码管理工具中拉取代码失败时的尝试次数,也可以在具体的项目中进行设置。
工程命名限制
如果勾选了此项,并且选择的是 Pattern,那么创建 job(或者 item)时要满足此规则才能创建成功。如下:
创建项目时不满足以上规则会提示以下信息:
Jenkins Location
- Jenkins URL: