Jenkins持续集成与部署
阅读原文时间:2021年10月03日阅读:1

一、Jenkins简介

在阅读此文章之前,你需要对Linux、Docker、Git有一定的了解和使用,如果还未学习,请阅读我前面发布的相关文章进行学习。

1、概念了解:CI/CD模型

CI全名Continuous Integration,啥意思?就是我们经常听到的持续集成概念。 当开发每天会提交多次代码到主干上,会做一些重复性的动作时,就可以用持续集成环境来操作。有集成了,就肯定少不了它的好基友,没错就是CD。
CD全名是Continuous Deployment,是持续部署。CD还有个小号,交持续交付,英文全称是Continuous delivery,缩写也是CD。
CI/CD优点是,重复的工作用自动化来代替、减少时间成本、版本发布时间减短了。现在很多公司都有做持续集成,Jenkins就是一个持续集成的工具,开源的,基于 JAVA语言的。

2、首先咱们先了解下为什么要使用Jenkins??

未使用 Jenkins 部署项目流程

coding -> 代码管理器(git、svn) -> 编译 -> 拷贝到目标服务器 -> 构建镜像 -> 容器化部署 -> 上线成功、访问

使用 Jenkins 之后 部署项目流程

coding -> Jenkins 自动化部署 -> 上线成功、访问

看到这里,好处显而易见,真香系列~~

3、工作流程

ok,看到这里我们步入正题,开始进入正式的学习吧

二、安装Jenkins与插件

1、拉取jenkins镜像

[root@hw-81969 ~]# docker pull jenkins/jenkins

2、查看镜像

[root@hw-81969 ~]# docker images

REPOSITORY        TAG       IMAGE ID       CREATED      SIZE
jenkins/jenkins   latest    93d377dce516   2 days ago   441MB

3、运行docker镜像

[root@hw-81969 ~]# docker run -d -u root  -p 1000:8080  -v /jenkins:/var/jenkins_home --name jenkins1 镜像id

# 然后查看镜像是否运行起来

4、访问jenkins http://ip地址:1000/ 开端口别忘了!

5、获取密码,根据它的提示到指定目录寻找,或者通过查看日志获取,妥善保存

[root@hw-81969 ~]# docker logs  镜像id

获取密码的第二种方法

## 进入容器
docker exec -it  [容器名称] /bin/bash

## 查看密码
cat /var/jenkins_mount/secrets/initialAdminPassword

## 退出
exit

6、输入密码后进入插件选择的界面,推荐安装就行

7、设定管理员账号,这里我们直接用admin账号

8、我们进入系统管理-->插件管理来安装我们下方用到的插件

Localization:Chinese(Simplified)  汉化插件
Gitee Plugin  对接gitee的插件
Publish Over SSH   远程连接访问的插件
Email Extension    发送邮件插件
NodeJS          构建Vue等项目
Docker   Docker插件
Generic Webhook Trigger  触发构建任务
thinbackup   数据定期备份

等待其安装完毕,就可以开始使用,默认的站点比较慢,在【高级页面】更换为这个

https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json

安装完成,开始使用!

9、扩展一些会用到的链接

# 停止jenkins
url/stop
# 重启
url/restart
# 重新加载配置文件
url/reload

三、新建任务与配置

进入【新建任务】页面,输入名称选择【构建一个自由风格的软件项目】,保存。保存之后配置先不用配,进入下一步

1、到【系统管理】->【系统配置】配置我们的gitee插件,因为使用的为gitee,用其他的也行,自己选择。

生成令牌

路径:在gitee个人页面->【设置】->【私人令牌】->【生成新令牌】即可。生成完成后记得及时保存,后面不在展示

填充令牌

2、在Jenkins面板点击【添加】,选择下图选项:成功之后记得保存

3、进入【我的视图】,找到刚新建的任务,进入配置页面

4、对这个任务的构建进行配置

设置镜像名称参数

设置版本

然后点击【保存】 查看构建

源码管理

1、进入我们的gitee要部署的仓库项目的页面,把地址复制下来,比如:

触发构建器

在Gitee官网进入你的项目 -> 右上管理 -> WebHooks -> 添加WebHook

查看

此处应该有鲜花 6️⃣ 6️⃣6️⃣

四、配置远程服务器连接

我们要用 Pushlish over SSH: 用来连接远程服务器,作为仓库服务器。下面开始配置

1、首先进入【系统管理】-> 【系统配置】,往下滑找到【Publish over SSH】,然后点击新增

成功之后,连接服务器的配置就完成了。

至此,这些是下面各种项目的基础,需要完成后面项目的部署前四步必不可少!!!


五、配置邮箱通知信息

必要的配置

1、选择要通知的邮箱,开启smtp服务,我用的QQ邮箱,点击生成授权码保存下来。

2、到【系统管理】->【系统配置】配置我们的邮箱信息,共有3个地方需要填写

测试!

需要填写的信息

SMTP服务器:    smtp.qq.com
用户默认邮件后缀    @qq.com
勾选【使用SSL协议】
SMTP端口    465

邮箱整合项目

1、首先呢先在具体任务的【构建后操作】去配置

通用主题模板

${PROJECT_NAME}项目第${BUILD_NUMBER}次构建通知

通用内容模板

<!DOCTYPE html>
<html>

<head>
    <meta charset="UTF-8">
    <title>${ENV, var="JOB_NAME"}-第${BUILD_NUMBER}次构建日志</title>
</head>

<body leftmargin="8" marginwidth="0" topmargin="8" marginheight="4" offset="0">
    <table width="95%" cellpadding="0" cellspacing="0" style="font-size: 11pt; font-family: Tahoma, Arial, Helvetica, sansserif">
        <tr>
            <td>(本邮件是程序自动下发的,请勿回复!)</td>
        </tr>
        <tr>
            <td>
                <h2>
                    <font color="#0000FF">构建结果 - ${BUILD_STATUS}</font>
                </h2>
            </td>
        </tr>
        <tr>
            <td><br />
                <b><font color="#0B610B">构建信息</font></b>
                <hr size="2" width="100%" align="center" />
            </td>
        </tr>
        <tr>
            <td>
                <ul>
                    <li>项目名称&nbsp;:&nbsp;${PROJECT_NAME}</li>
                    <li>构建编号&nbsp;:&nbsp;第${BUILD_NUMBER}次构建</li>
                    <li>Git版本&nbsp;:&nbsp;${GIT_REVISION}</li>
                    <li>触发原因:&nbsp;${CAUSE}</li>
                    <li>构建日志:&nbsp;<a href="${BUILD_URL}console">${BUILD_URL}console</a></li>
                    <li>构建&nbsp;&nbsp;Url&nbsp;:&nbsp;<a href="${BUILD_URL}">${BUILD_URL}</a></li>
                    <li>工作目录&nbsp;:&nbsp;<a href="${PROJECT_URL}ws">${PROJECT_URL}ws</a></li>
                    <li>项目&nbsp;&nbsp;Url&nbsp;:&nbsp;<a href="${PROJECT_URL}">${PROJECT_URL}</a></li>
                </ul>
            </td>
        </tr>
        <tr>
            <td><br />
                <b><font color="#0B610B">构建之后的变化</font></b>
                <hr size="2" width="100%" align="center" />
            </td>
        </tr>
        <tr>
            <td>
                <ul>
                    <li>历史变更记录 : <a href="${PROJECT_URL}changes">${PROJECT_URL}changes</a></li>
                </ul> ${CHANGES_SINCE_LAST_SUCCESS,reverse=true,format="Changes for Build #%n\n%c\n",showPaths=true,changesFormat="%a%m",pathFormat="\\t%p\\n"}
            </td>
        </tr>
        <tr>
            <td>
                <br />
                <b><font color="#0B610B">失败的测试结果</font></b></b>
                <hr size="2" width="100%" align="center" />
            </td>
        </tr>
        <tr>
            <td><pre style="font-size: 11pt; font-family: Tahoma, Arial, Helvetica,
                    sans-serif">${FAILED_TESTS}</pre>
                <br /></td>
        </tr>
        <tr>
            <td><br />
                <b><font color="#0B610B">构建日志</font></b>
                <hr size="2" width="100%" align="center" />
            </td>
        </tr>
        <tr>
            <td><textarea cols="80" rows="30" readonly="readonly" style="font-family: Courier New">${BUILD_LOG}</textarea>
            </td>
        </tr>
    </table>
</body>

</html>

全局使用模板

修改【系统配置】中默认的邮箱设置可以达到复用效果

六、定期备份数据

Jenkins的所有数据文件都存在文件中,Jenkins备份就是备份JENKINS_HOME目录。其中 workspace, builds 和 fingerprints目录是不需要备份的。

1、安装插件,在【系统管理】下方有【thinbackup】选项

2、内容从至下为备份、恢复、设置。需要设置的地方:

时间缩写

等价写法

描述

@daily@midnight

0 0 * * *

每天午夜0点执行

@hourly

0 * * * *

每个整点0分执行

@monthly

0 0 1 * *

每月1号的午夜执行

@weekly

0 0 * * 0

每周日午夜执行

3、设定完成后点击save,保存,回到上一界面点击Backup Now。需要的时候点击还原备份,点击restore

七、部署web前端项目

部署web项目有两种类型,一种是传统的未工程化构建的html页面,另一种为使用Vue脚手架等构建的工程化项目,以下的这些都需要把之前的步骤全部完成(第五步看自己情况)咱们先讲第一种。

1、新建我们的任务,这里步骤几乎与第三章节一致。

2、然后把html文件拷贝到目标服务器即可。

开启Nginx或者Tomcat服务,就可以运行了。

1、需安装插件,所有用到的插件均在第二步有所介绍

2、然后在【全局工具配置】配置node版本,

3、接下来也需要配置SSH连接远程服务器,这个方法在第四章节专门讲到,请移步

4、配置完毕后,开始新建我们的任务,这里步骤几乎与第三章节一致,请移步

5、然后我们继续在这个页面继续配置【构建环境】

6、接着开始【构建】,配置项目自动化打包,执行shell命令

cd /var/jenkins_home/workspace/文件目录  #进入test项目目录
npm install chromedriver --chromedriver_cdnurl=http://cdn.npm.taobao.org/dist/chromedriver
npm install
npm run build
cd dist
rm -rf 文件名.tar.gz #删除上次打包生成的压缩文件
tar -zcvf 文件名.tar.gz * #把生成的项目打包成test方便传输到远程服务器
cd ../

7、最后一步,把文件发到远程服务器上,在【构建】或者【构建后操作】选择【send * over ssh】(因为效果是一样的,二者都可以),类似于部署传统web项目

SSH相关配置

dist/*.tar.gz
dist
usr/local/nginx/html/

## shell脚本
cd /usr/local/nginx/html   # 打开目标文件地址
rm -rf 文件夹名    # 删除包含目标文件的文件夹
mkdir 文件夹名 # 新建同名文件夹
tar -zxvf 文件名.tar.gz -C 文件夹名/   # 解压文件到这个文件夹的目录下
rm -rf 文件名.tar.gz  # 删除压缩文件

8、这些完成后可以配置邮箱通知功能,看自己的需求~

八、部署SpringBoot项目

因为是java项目,所以我们首先要配置java环境,且用maven打包还要配置maven环境,当然你用其他的打包也行

1、点击【系统管理】-> 【全局工具配置】即可进入配置面板

点击链接去输入账号与密码,且用且珍惜~

oracle-02@qq.com
1211WaN!

修改maven镜像源,改成阿里云镜像

    <mirror>
      <id>alimaven</id>
      <name>aliyun maven</name>
      <url>http://maven.aliyun.com/nexus/content/groups/public</url>
      <mirrorOf>central</mirrorOf>
    </mirror>

完成后点击保存即可,这样我们的jdk与maven就构建完成。 接下来就是连接我们的服务器让Jenkins能够做出一些操作,这一步我们第四步已经做过了,[四、配置远程服务器连接](# 四、配置远程服务器连接)

1、新建任务、对gitee链接进行设置,前文有讲到,在 [三、新建任务与配置](# 三、新建任务与配置) 这里查看

2、设置maven相关配置,然后保存

需要输入的命令 保姆级教程……

clean package
pom.xml

3、增加shell命令,自动部署运行

4、填入命令 注意这分为直接运行jar包与运行Docker容器运行两种类型,分别说明一下

jar包运行方式的脚本

sudo fuser -k -n tcp 项目端口号
cd 生成的jar包目录
nohup java -jar 文件名 > 日志目录文件地址 &

Docker容器运行的脚本

使用Docker运行首先需要制作Docker容器,在项目根目录编写Dockerfile文件,然后上传到代码仓库

#FROM openjdk:8-jdk-alpine
FROM hub.c.163.com/dwyane/openjdk:8
MAINTAINER qinadu<邮箱地址>
EXPOSE 8080   # 对外暴露的端口
CMD ["--server.port:8080"]  # 映射端口
CMD echo "---Docker容器环境配置成功,即将运行---"
copy *.jar /app.jar
ENTRYPOINT ["java","-jar","/app.jar"]
CMD echo "---服务开启成功,访问端口:8080---"

接着设置maven相关配置,这里与上方不同

clean install -Dmaven.test.skip=true

最后在构建项目中执行shell脚本,保存。

mvn docker:build -t 镜像别名
echo "当前docker 镜像:"
docker images | grep 镜像别名
echo "启动容器----->"
docker run -d -p --name 容器名  镜像别名
echo "启动服务成功!"

5、然后开始构建我们的项目,返回上一步,进入如下页面开始构建 (Build with Parameters)。

6、改造shell脚本,如果下次构建该项目的时候,docker镜像和服务已存在,需要先删除镜像和服务。

# 先删除之前的容器
echo "移除之前的容器>>>"
docker ps -a | grep 容器名 | awk '{print $1}'| xargs docker rm -f
# 删除之前的镜像
echo "移除之前的镜像>>>"
docker rmi 镜像别名
# 构建镜像
mvn docker:build -t 镜像别名
# 打印当前镜像
echo "当前镜像>>>"
docker images | grep 镜像别名
# 启动容器
echo "容器启动中>>>"
docker run -d -p --name 容器名  镜像别名
# 打印当前容器
echo "当前容器>>>"
docker images | grep 容器名
echo "启动服务成功!"

ps:这里的镜像名之类需要我们设置的也可以使用字符参数代替,字符参数在第三步中的gitee链接中就已经设置,怎么用看你自己。格式:

$ImageName:$Version

九、 配置镜像容器服务

这一步如果项目中不需要搭建自己的镜像仓库可以忽略,一般为自己搭建的Harbor私服,这里我使用 阿里云容器镜像服务

创建仓库

1、创建命名空间

2、创建镜像仓库

创建完成后我们就得到了一个仓库

为仓库添加 访问凭证

使用jenkins构建

IMAGE_NAME='registry.cn-beijing.aliyuncs.com/{命名空间}/{仓库名称}:web-demo-0.0.1-SNAPSHOT'
echo IMAGE_NAME=$IMAGE_NAME
echo '================当前docker版本=============='
echo `docker -v`

echo '================开始创建镜像================'
docker build -t $IMAGE_NAME .

echo '================开始推送镜像================'
docker login --username={阿里云Registry登录名} --password={阿里云Registry登录密码} registry.cn-beijing.aliyuncs.com
docker push $IMAGE_NAME
echo '====================OK!================'

拉取镜像也是同样操作

IMAGE_NAME='registry.cn-beijing.aliyuncs.com/{命名空间}/{仓库名称}:web-demo-0.0.1-SNAPSHOT'
docker pull $IMAGE_NAME
echo '====================OK!================'

参考:


至此,Jenkins集成部署的介绍就告一段落,以上所写,对于单体 项目而言,足够日常使用。微服务项目与集成k8s集成请前往视频学习

相关视频教程:微服务持续集成与持续部署 基于Docker+Jenkins+Git 实现企业持续