Jenkins部署SpringBoot(十三)
本篇文章主要介绍Jenkins搭建和SpringBoot项目部署。搭建和部署主要分为四个步骤:
- 第一步:Jenkins安装
- 第二步:插件安装和配置
- 第三步:设置SSH
- 第四步:Jenkins项目部署
一、Jenkins安装
从官网下载最新的版本(一个WAR文件),Jenkins 官方网址: http://Jenkins-ci.org/。
运行命令nohup java -jar jenkins.war &,输入http://ip:8080访问。注意:Jenkins 需要运行 Java 5 以及以上的版本。
也可把war 包文件部署到Tomcat容器,把jenkins.war放在 Tomcat解压目录/webapps 目录下,然后启动tomcat,在浏览器输入类似 http://localhost:8080/jenkins/这样的地址即可。
-
启动
第一次启动jenkins时,它会自动生成一个随机的口令。
我们可以依照提示,在服务器上进入文件地址/root/.jenkins/secrets/initialAdminPassword下获取密码,填入如下文本框。
进入用户自定义安装界面,建议选择安装官方推荐插件。选择哪种方式都不会对后续操作有太大影响。因为有需要的插件我们可以在后续有针对性的安装。
接下来是进入插件安装进度界面;
插件一次可能不会完全安装成功,可以点击Retry再次安装。直到全部安装成功。
-
创建用户
插件安装成功后,新建账号或以管理员身份继续。可以选择使用admin 账户继续,后面有需要仍然有机会注册新账户。
出现Jenkins安装已完成提示,然后我们就可以开始使用Jenkins了。
二、插件安装和配置
-
插件安装
系统管理 -->插件管理 -->可选插件,勾选需要的插件,然后点击直接安装或者下载待重启后安装。
为了方便操作,建议大家把Jenkins汉化。在这里就不介绍怎么汉化了,小伙伴们可以去找度娘。
-
全局安全设置
系统管理-->全局安全配置-->启用安全,勾选允许用户注册以及选择授权策略。
-
全局工具配置
系统管理-->全局工具配置-->配置Maven、JDK和Git实例,在每一节下面单击Add(新增)按钮,然后添加实例的名称和绝对路径。
1、配置Maven的setting.xml文件
2. JDK配置,去掉勾选自动安装
3、Git配置,去掉勾选自动安装
4、maven配置,去掉勾选自动安装****
保存并退出。
三、设置SSH
-
配置SSH
系统管理 -->系统设置-->选择Publish over SSH
Passphrase 不用设置
Path to key 写上生成的ssh路径:/root/.ssh/id_rsa
SSH Servers:
- Name ssh连接的名字
- Hostname ssh连接部署主机的IP(即应用服务器的地址)
- Username linux 登陆用户名
- Remote Directory 指定Jenkins在部署服务器上的部署目录
-
配置SSH的登陆密码
点击高级展开配置,勾上授权并添加服务器密码。
配置完成后可点击“Test Configuration”测试到目标主机的连接,出现”success“则成功连接,如果有多台应用服务器,可以点击”增加“,配置多个“SSH Servers” 点击“保存”以保存配置。
四、Jenkins项目部署
-
新建项目
首页点击新建(New Item),输入项目名称,选择构建一个自由风格的软件项目。然后点击OK。
- 源码管理
配置构建代码的下载地址,由于我用的是码云所以选择Git ,输入代码路径、选择证书,不存在的话点击“添加”,选择username with password,输入码云的用户名密码进行设置,然后选择设置完的证书Branches to build 设置构建的分支路径,如果为空的话默认构建所有分支,其他设置默认即可。
Repository UR: 远程git仓库代码地址
Credentials:远程git仓库可以拉取代码的用户名和密码
Branch Specifier (blank for 'any'):本地仓库分支名称,比如我这为master
- 触发构建
这里可以设置触发构建的策略,设置在什么情况下触发构建。由于我们当前构建为手动,所以这里不设置触发选项。
- 构建环境
构建环境是设置构建之前的环境配置,具体含义如下:
1、Delete workspace before build starts :设置构建之前删除当前任务的工作空间,即先删除所有之前的代码在进行构建
2、Use secret text(s) or file(s):设置构建过程中要使用的凭证,选中后需要设置对应的凭证
3、Provide Configuration files:使全局配置的文件在本地工作区中可用。需要通过config-file-provider插件配置的文件才可以选则,并且可以引用。
4、Send files or execute commands over SSH before the build starts :在构建启动之前,通过SSH发送文件或执行命令
5、Send files or execute commands over SSH after the build runs:在构建运行之后,通过SSH发送文件或执行命令
6、Abort the build if it's stuck:如果构建阻塞了,就中止它
7、Add timestamps to the Console Output:向控制台输出添加时间戳
8、Inspect build log for published Gradle build scans:检查已发布的Gradle构建扫描的构建日志
9、Provide Node & npm bin/ folder to PATH:提供节点和npm bin/文件夹到PATH
10、With Ant:为Jenkins准备一个使用Apache Ant运行构建的环境。注释特定于ant的输出,以显示执行的目标。可选地设置Ant和/或JDK安装。
- 构建
设置构建的方式和执行的命令,当前设置为使用maven构建,构建的命令参数为 clean install。
注意:如果maven版本不存在则需要在系统管理-->全局工具配置中设置。
- 构建后操作
构建后操作:代码下载并编译打包完成后执行的操作,用来执行重启项目的操作。
点击增加构建步骤,选择Send files or execute commands over SSH。当前设置的操作是构建完成后把打好的jar包放到目标路径下并执行远程shell脚本 bash /usr/local/up-admin/restart.sh。然后点击并保存。
参数说明:
Name:在Jenkins的全局配置中配置的SSH服务器,对应的是要构建项目的服务器。
Transfers:设置传输规则,配置构建项目中的那些文件要上传到服务器的那个位置,上传完成后执行那些操作
Source files:设置要上传的jenkins服务器任务的根路径下那个文件 例如:
jenkins项目存放路径为/root/.jenkins/workspace/
新建的任务名称为Jenkins-test,所以新建的任务工作空间路径为/root/.jenkins/workspace/Jenkins-test/
打好包的项目存放在 /root/.jenkins/workspace/Jenkins-test/up-admin/target/up-admin.jar
所以Source files指的是 /root/.jenkins/workspace/Jenkins-test/ 路径下的文件
Remove prefix:指的是保存的文件去除掉Source files中的前缀信息 例如保存为up-admin.jar 所以需要去除前缀up-admin/target/
Remote directory:上传到Name中选择的服务器中的那个路径下
Exec command:上传完成后需要执行的脚本或者命令,脚本命令如下:
PID=$(cat /usr/local/up-admin/up-admin.pid)
kill -9 $PID
source /etc/profile
nohup java -jar /usr/local/up-admin/up-admin.jar >>/usr/local/up-admin/catalina.out 2>&1 &
echo "service started....."
echo $! > /usr/local/up-admin/up-admin.pid
if [ -f /usr/local/up-admin/up-admin.pid ]; then
PID=$(cat /usr/local/ssp-admin/ssp-admin.pid)
echo "start service success!"
echo "PID is $PID"
else
echo "start service fail!"
fi
脚本命令含义:构建的时候先kill掉老项目,然后再重启新项目。
- 测试
进入主页可以看到刚才新增的任务Jenkins-test,点击名称进入任务
点击立即构建执行构建操作,构建的开始后可以点击对应的构建任务查看日志信息来定位问题或查看构建流程是否正确。
至此,Jenkins部署完成。