linux(centos)下使用jenkins + maven + git码云(或github) 实现自动化构建项目

1.下载jenkins 官网下载地址,自己选取对应系统 https://jenkins.io/download/

下载rpm或者直接下载war包 https://pkg.jenkins.io/redhat/jenkins-2.9-1.1.noarch.rpm

系统环境要求: jdk, tomcat, git, maven (没有就安装先)

rpm -ivh jenkins-2.9-1.1.noarch.rpm 我的安装到 /usr/lib/jenkins目录

Jenkins主目录是用户目录下的.jenkins目录  /root/.jenkins

复制文件夹内的jenkins.war到tomcat目录下的webapps目录下 并启动tomcat (./startup.sh)

进入: cd ~/.jenkins/

目录介绍:
jobs: 项目配置目录(新建的job,即一个个项目 的配置存放在这里)
logs: 日志目录
workspaces: 默认的工作空间(每个项目会存放在这里)
users: 创建的用户目录
secrets: 初始的设置(包括初始化的密码, 在创建了用户以后会自动删除里面的初始化密码文件)

tomcat启动以后 访问网页 http://127.0.0.1/jenkins 提示输入初始化密码, 密码在secrets目录下的initialAdminPassword文件内

进入后先创建一个用户(以后就用这个用户登录), 然后提示下载插件(可以下载推荐的也可以自定义)

按照提示新建一个项目 如图:这里测试从码云获取项目,so选择第一个, 设置完后 保存

(如果是maven项目 需要下载个maven插件-> Maven Integration plugin 在设置里下载 安装重启 下面介绍)

填写内容:
项目名称: 最好和真正的项目名相同
描述: 随意

源码管理: 选择 git (当遇到 401, 没权限, 读取远程key失败请看下面错误解决)
构建触发器: 设置什么时候触发构建功能(可以用脚本,或者有人提交代码到码云时候构建,或者定时构建都可以)

(jenkins有各种提示, 都介绍的很详细了)

如果项目是私有的项目(如码云中的), 则需要设置用户名密码–在 Credentials 中配置 Add 一个





点击左侧 立即构建

到主面板查看项目构建情况: 红色代表失败, 蓝色表示成功

可以再面板的 系统管理/系统设置 中修改设置

系统设置:
1.点击高级设置: 可以修改 工作空间根目录,构建记录根目录
2.可以修改时间格式
3.可以修改ssh端口,管理员邮件地址,Jenkins URL等等
Global Tool Configuration:
1.设置maven路径
2.设置jdk路径
3.设置git文件路径

对于maven项目 配置如图一,可自行更改

下图是点击构建以后打印的日志信息(正在下载依赖) (but有个问题 下载的jar包并没有按照我maven中配置的仓库地址,而是下载到了.jenkins目录下)

发布war到tomcat: 由于这里编译就和自己电脑打包项目一样,会把war包放在target目录下, 我们需要一个插件把其发送到tomcat的webapps中

(下载插件 Deploy to container Plugin)

安装插件以后进入项目的配置界面 设置”构建后操作”,里面就会多一个 “Deploy war/ear to a container” 选项

配置:
WAR/EAR files: target/*.war  (war包的相对路径,相对工作空间)
Context path: MeetCode (发布到tomcat的路径,这里我用项目名,到时候访问就用http://127.0.0.1:80/MeetCode)

Containers: 配置一个tomcat容器(我用的tomcat8,但是我的版本没有 只能用7x)
Manager user name: (tomcat用户名: 进入tomcat/conf/tomcat-users.xml设置)
Manager password: 密码
Tomcat URL: http://127.0.0.1:80 (设置远程tomcat访问路径)

设置完毕 保存 构建 可看日志观察构建过程 (进入tomcat/webapps下 发现war包正在传入), success之后访问网页可用

其实也可以不发送war包, 可以在Post Steps中配置maven运行命令*

要求: 1. 在pom文件中加入tomcat插件
2. 如下图配置,则构建最后会直接通过maven运行启动项目

其他问题: 运行其实依然处于正在构建状态(可以自己查看项目构建状态),
所以需要在项目配置中勾选"丢弃旧的构建",保持构建的最大个数填写"1",(也可以设置构建最大时间);

设置邮件消息

1.进入 系统管理 / 系统设置 / 邮件通知

设置选项: (这里用qq邮箱测试)
SMTP服务器: smtp.qq.com
用户默认邮件后缀: @qq.com
使用SMTP认证: true
用户名: (作为发件箱的qq邮箱,可以带或不带后缀)
密码: (一般是邮箱密码,qq邮箱特殊,需要进入qq邮箱/设置/账户设置, 发送短信生成一个smtp密码)
使用SSL协议: false
SMTP端口: 587
Reply-To Address: 我没写
字符集: UTF-8

测试: 写另一个邮箱地址进行测试
注意: 如果失败, 提示com.sun.mail.smtp.SMTPSendFailedException: 501 mail from address must be sam
需要设置    系统管理员邮件地址, 在本页面上面,必须与发件箱一致

错误解决:

问题: 设置git地址时候 遇到401错误 或者 fatal: Could not read from remote repository

原因: 本地git没有配置SSH公钥

这个配置在github中在右上角 Settings/SSH keys and GPG keys 中

在码云中在右上角 修改资料/SSH公钥 中(二者命令不同)

github生成公钥 命令:
git config --global user.name "XXXXX"
git config --global user.email "XXXXXXX@gmail.com"
1.查看是否已经有了ssh密钥：cd ~/.ssh
如果没有密钥则不会有此文件夹，有则备份删除
2.生存密钥：
ssh-keygen -t rsa -C "XXXXXXX@gmail.com"
按3个回车，密码为空。
此时生成两个文件:id_rsa和id_rsa.pub 公钥在id_rsa.pub中,查看并复制粘贴到上面github的配公钥的地方,添加一个公钥
并且在本地也添加公钥
ssh-add id_rsa.pub

码云生成公钥 命令: 见 http://git.mydoc.io/?t=154712