jenkins配置笔记

这两天因工作需要捣鼓了一下jenkins，实现了项目的自动抓取和发布，现在记录一下具体的操作流程。

首先需要下载jenkins，这个去官网下载就可以了，我是windows系统所以我下的是下面这个版本，直接双击安装就行了。

安装完成后程序会自动打开浏览器访问地址http://localhost:8080/，这是jenkins的默认地址，当然可能打开后浏览器会显示无法访问的情况，不要慌这是因为jenkins启动比较慢，稍等两分钟刷新一下基本就可以访问了。

当前jenkins的端口是8080与我tomcat的端口冲突了，所以需要修改一下jenkins的端口，否则tomcat无法启动，我修改时只改了安装路径下的jenkins.xml文件，将其中的端口指定改为8088，然后重启jenkins服务即可，如下下图。

修改完成后在浏览器中访问http://localhost:8088/进入初始化页面，初始第一次登录时输入的密码在安装路径下的secret目录下的initialAdminPassword文件中，将文件中的密码复制到输入框中就可以进入系统了。第一次登录系统jenkins会引导你安装一些必要的插件，我这里直接选了默认安装，结果很后悔因为很慢，这里建议大家手动选择，并且全部都去掉，然后进入系统后在安装需要的插件。另外jenkins默认的插件源比较慢，可以切一下源，方法是在 Manage Jenkins-》Manage Plugins中选择高级这个tag，然后修改升级站点的url内容即可，如下图。

其实在我这次的配置中只要有以下几个插件就可以了，分别是maven plugin、git plugin、gitee plugin、publish over ssh这几个插件。

插件安装完成后需要进行系统配置，在 Manage Jenkins-》Configure System中配置，包括gitee的配置和ssh的配置，如下图。

gitee主要配置的是你码云的相关信息，链接名无关紧要随便输入，域名url直接就是码云的地址，在添加凭据这里我发现账号密码的凭据是不行的，只能用api令牌这凭据类型，而码云的api令牌需要去这个地址下获取https://gitee.com/profile/personal_access_tokens，配置完成后可点击一下测试链接按钮测试一下是否可以访问码云了。

SSH配置的是你的项目将要发布的服务器的远程访问信息，包括主机名（这个随便起）、主机的ip、登录的用户名、项目发布的根路径（一般就是指定web容器的根路径，我这里指定的是tomcat的根路径）。密码需要点击高级按钮后可以输入，如下图。

勾选上use password那个复选项就可以输入密码了，全部完成后可以点击Test Configuration按钮测试是否可以成功访问服务器。

配置完系统信息还需要配置一下插件信息，在 Manage Jenkins-》Global Tool Configuration中设置，如下图

配置主要就是配置jdk、git、maven的信息，name项都是可以随便输入的，name下面一项都是输入你的程序路径。

配置完成后就可以创建我们的项目了，在首页中选择新建item，输入项目名称并选择maven项目类型，如下图所示。

然后完成配置保存就可以创建完成一个自动抓取发布的项目了，如下图。

这里补充说明一下，源码管理选择git，然后在url中输入你码云的仓库地址，在认证中选择，没有可以添加，这里可以用用户名密码的方式来添加认证。而build项指定pom文件地址，这个一般就是pom.xml，Goals and options项是指定项目获取完成后要执行的maven命令，这里是clean install -Dmaven.test.skip=true表示清空maven的target并且重新生成，同时跳过test。Post Steps项中Run only if build succeeds表示只有在build成功的情况下才会执行发布项目，而下面的Send files or execute commands over SSH指定项目build完成后需要把那个文件放到服务器上的哪个位置，并且执行什么命令。

保存完成后项目就部署好了，可以通过码云的更新情况自动获取新的代码并且重新发布项目。