Spring Boot入门教程(四十七): 使用Jenkins部署Spring Boot项目

1. 简介

Jenkins是一个开源软件项目，是基于Java开发的一种持续集成工具，用于监控持续重复的工作，旨在提供一个开放易用的软件平台，使软件的持续集成变成可能。

Jenkins是一款能提高效率的软件，它能帮你把软件开发过程形成工作流，典型的工作流包括以下几个步骤：1. 开发、2.提交、3.编译、4.测试、5.发布。有了Jenkins的帮助，在这5步中，除了第1步，后续的4步都是自动化完成的，具体的，当你完成了提交，Jenkins会自动运行你的编译脚本，编译成功后，再运行你的测试脚本，这一步成功后，接着它会帮你把新程序发布出去，特别的，在最后一步，你可以选择手动发布，或自动发布，毕竟发布这件事情，还是需要人为的确认一下比较好，简而言之：Jenkins可以帮你在写完代码后，一键完成开发过程中的一系列工作，使用Jenkins的好处显而易见，它减少了你的重复劳动。更重要的是，一个团队的开发流程一开始是不一致的，不一致往往会带来各种各样的问题，最终体现在软件的质量或开发效率不够高，而Jenkins会帮你规范大家的行为，从而避免一系列的问题。

Jenkins功能包括：

• 持续的软件版本发布/测试项目。
• 监控外部调用执行的工作。

2. 安装

mac安装brew install jenkins

3. 启动

• 切换到jenkins.jar存放的目录，输入如下命令：java -jar jenkins.war --httpPort=8888 端口默认是8080，在浏览器中访问localhost:8888

• 将jenkins.war文件放入tomcat下的webapps目录下，启动tomcat时，会自动在webapps目录下建立jenkins目录，在地址栏上需要输入localhost:8081/jenkins

查看密码： cat /Users/xxx/.jenkins/secrets/initialAdminPassword

这里选择了 安装推荐的插件，会安装多个插件，可能有些插件安装成功了，有些安装失败了，如果有安装失败了就多重试几次，直到所有插件都安装成功(我重试了3次)

安装成功跳转到创建管理员界面，这里没有创建而是【使用admin账户继续】

4. 设置

1. 修改admin的默认密码

用户–> admin–> 设置 –> 密码, 可以将密码修改成简单的便于输入，如111111

2. jdk、maven设置

系统管理–> 全局工具配置–> JDK

3. Push SSH

系统管理 > 系统设置 选择 Publish over SSH

Message [Auth fail]或者ssh 用户名@IP 连接失败（ssh_exchange_identification: Connection closed by remote host）
参考文章: https://blog.csdn.net/u010947098/article/details/61922969

cd ~/.ssh
cat id_rsa.pub >> authorized_keys
chmod 600 authorized_keys

注意：确保 ssh Username@Hostname 在命令行中验证一下是否能访问成功

4. 安装可选插件

有很多插件都是选择的默认的安装的，所以现在需要我们安装的插件不多

系统管理—> 管理插件 —> 可选插件 —> 勾选需要安装的插件(Maven Integration plugin，publish over SSH、PowerShell plugin)—> 点击直接安装或者下载重启后安装，可以选择安装完成后重启Jenkins

当查看 系统管理 时可能会出现一些 插件没有加载出来的错误：Some plugins could not be loaded due to unsatisfied dependencies. Fix these issues and restart Jenkins to restore the functionality provided by these plugins.
，这可能是因为安装插件时没有一次安装成功的原因，如果你所有插件都安装成功了，只需重启Jenkins即可，因为使用javar -jar启动的所以只需Ctrl + C停止服务，然后再重新启动即可，正常效果如下图：

---

Git 集成

1. 配置git的用户名和密码

可以通过如下命令来查看是否已经设置了，配置了则跳过该步骤

git config --global user.name
git config --global user.email

设置git用户名和密码

git config --global user.name [username] 
git config --global user.email [email]

2. 生成 ssh key

git秘钥一般生成在~/.ssh目录下，可以查看一下该目录中是否已经生成

➜  cd ~/.ssh
➜  .ssh ls
id_rsa      id_rsa.pub  known_hosts

如果已经生成了则跳过该步骤
如果没有生成则使用命令ssh-keygen -t rsa -C 你的邮箱生成，输入该命令回车后提示输入密码, 此处密码可以不填, 直接回车提示再次输入密码, 直接回车，这样就生成了。

3. 将公钥id_rsa.pub添加到git服务器(github, gitlab)

如果已经添加了则忽略该步骤

点击用户头像–> Settings–> SSH and GPG keys–> New SSH key–> 将公钥id_rsa.pub文件中的内容粘贴到Key中–> Add SSH Key

4. Add Credentials

系统管理–> 管理用户–> admin –> Credentials–> User:admin(global)–> Global credentials –>Add Credentials–> Username with password

git的用户名和密码

---

新建任务newJob

任务的最右边就是 立即构建 按钮。

Jenkins中的【立即构建】大概做的事情，具体执行过程可以通过构建历史的控制台输出来查看

1. 从svn或者git代码仓库中下载最新的代码到本地
2. 对最新的代码进行编译、打包（mvn clean install -Dmaven.test.skip=true -Ptest）-P 用于指定环境
3. 执行一些预先配置好的脚本shell命令(一般先杀死进程，然后启动项目，对于spring boot项目来说一般会执行 java -jar xxxx.jar 或者其它更复杂的发布脚本，如将项目拷贝到tomcat中，然后执行tomcat的startup.sh)

传统发布代码步骤

1. 使用ftp软件将代码上传到服务器
2. 使用ssh连接到服务器然后启动tomcat

Jenkins发布代码：

1. 只需要点击一下 [立即构建] 这个按钮即可

使用Jenkins发布减少了传统方式重复的工作量，避免手工部署出错

常见错误：

• 超时 https://stackoverflow.com/questions/11290540/jenkins-text-finder-unable-to-success-my-build
• Not working scp command: Connection closed by remote host (Mac OS X) https://my.oschina.net/u/1024107/blog/1610664

参考文章：http://www.ityouknow.com/springboot/2017/11/11/springboot-jenkins.html