179 lines
14 KiB
Markdown
179 lines
14 KiB
Markdown
|
# 1、Jenkins介绍
|
|||
|
|
|
|||
|
|
Jenkins 是一款流行的开源持续集成（Continuous Integration）工具，广泛用于项目开发，具有自动化构建、测试和部署等功能。官网： [http://jenkins-ci.org/](http://jenkins-ci.org/)。
|
|||
|
|
Jenkins的特征：
|
|||
|
|
|
|||
|
|
- 开源的 Java语言开发持续集成工具，支持持续集成，持续部署。
|
|||
|
|
- 易于安装部署配置：可通过 yum安装,或下载war包以及通过docker容器等快速实现安装部署，可方便web界面配置管理。
|
|||
|
|
- 消息通知及测试报告：集成 RSS/E-mail通过RSS发布构建结果或当构建完成时通过e-mail通知，生成JUnit/TestNG测试报告。
|
|||
|
|
- 分布式构建：支持 Jenkins能够让多台计算机一起构建/测试。
|
|||
|
|
- 文件识别： Jenkins能够跟踪哪次构建生成哪些jar，哪次构建使用哪个版本的jar等。
|
|||
|
|
- 丰富的插件支持：支持扩展插件，你可以开发适合自己团队使用的工具，如 git，svn，maven，docker等。
|
|||
|
|
|
|||
|
|
Jenkins安装和持续集成环境配置
|
|||
|
|
|
|||
|
|
|
|||
|
|
- 首先，开发人员每天进行代码提交，提交到Git仓库
|
|||
|
|
- 然后，Jenkins作为持续集成工具，使用Git工具到Git仓库拉取代码到集成服务器，再配合JDK，Maven等软件完成代码编译，代码测试与审查，测试，打包等工作，在这个过程中每一步出错，都重新再执行一次整个流程。
|
|||
|
|
- 最后，Jenkins把生成的jar或war包分发到测试服务器或者生产服务器，测试人员或用户就可以访问应用。
|
|||
|
|
# 2、部署安装
|
|||
|
|
在神领物流项目中采用Docker方式部署Jenkins，部署脚本如下：
|
|||
|
|
```shell
|
|||
|
|
docker run -d \
|
|||
|
|
-p 8090:8080 \
|
|||
|
|
-p 50000:50000 \
|
|||
|
|
-v /usr/local/src/jenkins:/var/jenkins_home \
|
|||
|
|
-v /maven:/maven \
|
|||
|
|
-v /etc/localtime:/etc/localtime \
|
|||
|
|
-v /usr/bin/docker:/usr/bin/docker \
|
|||
|
|
-v /var/run/docker.sock:/var/run/docker.sock \
|
|||
|
|
--privileged \
|
|||
|
|
--name jenkins \
|
|||
|
|
-e TZ=Asia/Shanghai \
|
|||
|
|
--restart=always \
|
|||
|
|
--add-host=git.sl-express.com:192.168.150.101 \
|
|||
|
|
--add-host=maven.sl-express.com:192.168.150.101 \
|
|||
|
|
jenkins/jenkins:lts-jdk11
|
|||
|
|
```
|
|||
|
|
在部署脚本中指定了时区、hosts并且将宿主机的docker服务映射到容器内部。
|
|||
|
|
访问地址：[http://jenkins.sl-express.com/](http://jenkins.sl-express.com/) 用户名密码为：root/123
|
|||
|
|
# 3、系统配置
|
|||
|
|
Jenkins安装完成后，需要进行一些配置才能正常使用。
|
|||
|
|
## 3.1、配置Maven
|
|||
|
|
|
|||
|
|
|
|||
|
|
在【系统管理】中的【全局工具配置】中进行配置。
|
|||
|
|
指定Maven配置文件：
|
|||
|
|
|
|||
|
|
配置文件内容如下：
|
|||
|
|
```xml
|
|||
|
|
<?xml version="1.0" encoding="UTF-8"?>
|
|||
|
|
<settings
|
|||
|
|
xmlns="http://maven.apache.org/SETTINGS/1.0.0"
|
|||
|
|
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
|||
|
|
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
|
|||
|
|
|
|||
|
|
<localRepository>/maven/repository</localRepository>
|
|||
|
|
|
|||
|
|
<pluginGroups></pluginGroups>
|
|||
|
|
<proxies></proxies>
|
|||
|
|
|
|||
|
|
<servers>
|
|||
|
|
<server>
|
|||
|
|
<id>sl-releases</id>
|
|||
|
|
<username>deployment</username>
|
|||
|
|
<password>deployment123</password>
|
|||
|
|
</server>
|
|||
|
|
<server>
|
|||
|
|
<id>sl-snapshots</id>
|
|||
|
|
<username>deployment</username>
|
|||
|
|
<password>deployment123</password>
|
|||
|
|
</server>
|
|||
|
|
</servers>
|
|||
|
|
|
|||
|
|
<mirrors>
|
|||
|
|
<mirror>
|
|||
|
|
<id>mirror</id>
|
|||
|
|
<mirrorOf>central,jcenter,!sl-releases,!sl-snapshots</mirrorOf>
|
|||
|
|
<name>mirror</name>
|
|||
|
|
<url>https://maven.aliyun.com/nexus/content/groups/public</url>
|
|||
|
|
</mirror>
|
|||
|
|
</mirrors>
|
|||
|
|
|
|||
|
|
<profiles>
|
|||
|
|
<profile>
|
|||
|
|
<id>sl</id>
|
|||
|
|
<properties>
|
|||
|
|
<altReleaseDeploymentRepository>
|
|||
|
|
sl-releases::default::http://maven.sl-express.com/nexus/content/repositories/releases/
|
|||
|
|
</altReleaseDeploymentRepository>
|
|||
|
|
<altSnapshotDeploymentRepository>
|
|||
|
|
sl-snapshots::default::http://maven.sl-express.com/nexus/content/repositories/snapshots/
|
|||
|
|
</altSnapshotDeploymentRepository>
|
|||
|
|
</properties>
|
|||
|
|
</profile>
|
|||
|
|
</profiles>
|
|||
|
|
|
|||
|
|
<activeProfiles>
|
|||
|
|
<activeProfile>sl</activeProfile>
|
|||
|
|
</activeProfiles>
|
|||
|
|
|
|||
|
|
</settings>
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
## 3.2、配置Git
|
|||
|
|
|
|||
|
|
## 3.3、安装Gogs插件
|
|||
|
|
我们使用的Git管理工具是Gogs，需要在用户提交代码之后触发自动构建，需要安装Gogs插件。
|
|||
|
|
|
|||
|
|
搜索Gogs安装即可。
|
|||
|
|
|
|||
|
|
在Gogs中的仓库设置钩子，例如：
|
|||
|
|
|
|||
|
|
格式：`http://jenkins.sl-express.com/gogs-webhook/?job=xxxx`
|
|||
|
|
# 4、构建任务
|
|||
|
|
在提供的虚拟机环境中虽然已经创建好了构建任务，如果不满足需求，可以执行创建任务，可以通过复制的方式完成。
|
|||
|
|
首先点击【新建任务】：
|
|||
|
|
|
|||
|
|
输入任务的名称，建议名称就是微服务的名字。
|
|||
|
|
|
|||
|
|
选择已有的构建任务：
|
|||
|
|
|
|||
|
|
输入任务的名称：
|
|||
|
|
|
|||
|
|
设置Gogs钩子：
|
|||
|
|
|
|||
|
|
设置构建参数，主要用于构建时的脚本使用：
|
|||
|
|
|
|||
|
|
设置git地址，每个项目都不一样，一定要修改！
|
|||
|
|
|
|||
|
|
设置构建开始前将workspace删除，确保没有之前编译产物的干扰：
|
|||
|
|
|
|||
|
|
设置ssh执行命令，主要是宿主机安装的docker服务具备权限，可以在容器内执行：
|
|||
|
|
|
|||
|
|
设置maven打包命令：
|
|||
|
|
|
|||
|
|
设置部署的ssh脚本，主要是完成微服务打包成docker镜像进行部署：
|
|||
|
|
|
|||
|
|
执行命令如下：
|
|||
|
|
```shell
|
|||
|
|
#!/bin/bash
|
|||
|
|
# 微服务名称
|
|||
|
|
SERVER_NAME=${serverName}
|
|||
|
|
|
|||
|
|
# 服务版本
|
|||
|
|
SERVER_VERSION=${version}
|
|||
|
|
|
|||
|
|
# 服务版本
|
|||
|
|
SERVER_PORT=${port}
|
|||
|
|
|
|||
|
|
# 源jar名称，mvn打包之后，target目录下的jar包名称
|
|||
|
|
JAR_NAME=$SERVER_NAME-$SERVER_VERSION
|
|||
|
|
|
|||
|
|
# jenkins下的目录
|
|||
|
|
JENKINS_HOME=/var/jenkins_home/workspace/$SERVER_NAME
|
|||
|
|
|
|||
|
|
cd $JENKINS_HOME
|
|||
|
|
|
|||
|
|
# 修改文件权限
|
|||
|
|
chmod 755 target/$JAR_NAME.jar
|
|||
|
|
|
|||
|
|
docker -v
|
|||
|
|
|
|||
|
|
echo "---------停止容器（$SERVER_NAME）---------"
|
|||
|
|
docker stop $SERVER_NAME
|
|||
|
|
|
|||
|
|
echo "---------删除容器（$SERVER_NAME）---------"
|
|||
|
|
docker rm $SERVER_NAME
|
|||
|
|
|
|||
|
|
echo "---------删除镜像（$SERVER_NAME:$SERVER_VERSION）---------"
|
|||
|
|
docker rmi $SERVER_NAME:$SERVER_VERSION
|
|||
|
|
|
|||
|
|
echo "---------打包镜像（$SERVER_NAME:$SERVER_VERSION）---------"
|
|||
|
|
docker build -t $SERVER_NAME:$SERVER_VERSION .
|
|||
|
|
|
|||
|
|
echo "---------运行服务---------"
|
|||
|
|
docker run -d -p $SERVER_PORT:8080 --name $SERVER_NAME -e SERVER_PORT=8080 -e SPRING_CLOUD_NACOS_DISCOVERY_IP=${SPRING_CLOUD_NACOS_DISCOVERY_IP} -e SPRING_CLOUD_NACOS_DISCOVERY_PORT=${port} -e SPRING_PROFILES_ACTIVE=stu $SERVER_NAME:$SERVER_VERSION
|
|||
|
|
```
|
|||
|
|
最后，保存即可。
|