sl-express/01-讲义/其他文档/Jenkins使用手册.md

14 KiB
Raw Blame History

1、Jenkins介绍

image.png Jenkins 是一款流行的开源持续集成Continuous Integration工具广泛用于项目开发具有自动化构建、测试和部署等功能。官网 http://jenkins-ci.org/。 Jenkins的特征

  • 开源的 Java语言开发持续集成工具支持持续集成持续部署。
  • 易于安装部署配置:可通过 yum安装,或下载war包以及通过docker容器等快速实现安装部署可方便web界面配置管理。
  • 消息通知及测试报告:集成 RSS/E-mail通过RSS发布构建结果或当构建完成时通过e-mail通知生成JUnit/TestNG测试报告。
  • 分布式构建:支持 Jenkins能够让多台计算机一起构建/测试。
  • 文件识别: Jenkins能够跟踪哪次构建生成哪些jar哪次构建使用哪个版本的jar等。
  • 丰富的插件支持:支持扩展插件,你可以开发适合自己团队使用的工具,如 gitsvnmavendocker等。

Jenkins安装和持续集成环境配置 image.png

  • 首先开发人员每天进行代码提交提交到Git仓库
  • 然后Jenkins作为持续集成工具使用Git工具到Git仓库拉取代码到集成服务器再配合JDKMaven等软件完成代码编译代码测试与审查测试打包等工作在这个过程中每一步出错都重新再执行一次整个流程。
  • 最后Jenkins把生成的jar或war包分发到测试服务器或者生产服务器测试人员或用户就可以访问应用。

2、部署安装

在神领物流项目中采用Docker方式部署Jenkins部署脚本如下

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/ 用户名密码为root/123

3、系统配置

Jenkins安装完成后需要进行一些配置才能正常使用。

3.1、配置Maven

image.png image.png 在【系统管理】中的【全局工具配置】中进行配置。 指定Maven配置文件 image.png 配置文件内容如下:

<?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

image.png

3.3、安装Gogs插件

我们使用的Git管理工具是Gogs需要在用户提交代码之后触发自动构建需要安装Gogs插件。 image.png 搜索Gogs安装即可。 image.png 在Gogs中的仓库设置钩子例如 image.png 格式:http://jenkins.sl-express.com/gogs-webhook/?job=xxxx

4、构建任务

在提供的虚拟机环境中虽然已经创建好了构建任务,如果不满足需求,可以执行创建任务,可以通过复制的方式完成。 首先点击【新建任务】: image.png 输入任务的名称,建议名称就是微服务的名字。 image.png 选择已有的构建任务: image.png 输入任务的名称: image.png 设置Gogs钩子 image.png 设置构建参数,主要用于构建时的脚本使用: image.png 设置git地址每个项目都不一样一定要修改 image.png 设置构建开始前将workspace删除确保没有之前编译产物的干扰 image.png 设置ssh执行命令主要是宿主机安装的docker服务具备权限可以在容器内执行 image.png 设置maven打包命令 image.png 设置部署的ssh脚本主要是完成微服务打包成docker镜像进行部署 image.png 执行命令如下:

#!/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

最后,保存即可。