软件工程项目构建阶段分为:本地开发阶段>>开发环境自测阶段>>测试环境>>预发布环境>>正式环境
研发只应该关心代码阶段,所以构建和部署直接一体自动化触发能够节省我们的手动打包产生的问题:节省时间、容易出错、环境不一致、打包环境不固定、运行环境不统一、等等
所以我们项目要用代码管理器去管理代码,自动化流水线去管理我们的多环境构建和版本发布
以下配置为本地部署,也可以使用云服务器代替,但是
准备工作:
git管理器:gogs/gitlab/github/gitee
服务器1:Ubuntu(服务器类型不重要,下列服务器默认都这个),用于docker运行我们的gogs,registry(私有镜像仓库)。——为了确保服务器的安全性可以不用连接互联网,保证私有化
服务器2:用于运行Jenkins
服务器3:构建节点机:用于运行docker构建或者其他远程节点
服务器4:部署机
以上为个人观点,也可以使用一台主机,docker运行所有内容(但是不推荐,因为Jenkins能控制自己的宿主机是不安全的,哪个不长眼的脚本里面把自己干掉就不美丽了)
安装
所有开发服务均用docker部署,所有主机都安装docker
gogs:10300端口
registry:5000端口
jenkins:8080端口
docker远程api:2375端口(可以走CA认证,更安全一些)国内教程1 官方教程
工程准备
新建一个项目(真实项目自己去写构建脚本,也可以全量用docker进行build,也可以用Jenkins的流水线去写构建),我只是演示,所以只创建一个index.html,然后用nginx镜像进行构建,让外部能够看到网页就行了
项目名:jenkinstest(将项目推到我们的gogs服务器上)
index.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>我是jekins自动集成的网站</title>
</head>
<body>
<h1 style="color: red;">
你好,我是网站
</h1>
</body>
</html>
Dockerfile
FROM nginx:alpine
COPY . /usr/share/nginx/html/
Jenkins流水线开发环境和测试环境集成部署
由于开发环境和测试环境都是单个环境,所以我们固定集成指定的分支就行了,也就是这个分支发生任何变动都应该触发集成(如果觉得合并和推送太频繁也可以取消触发式集成,改成手动触发)
Jenkins插件准备:Docker plugin、Generic Webhook Trigger Plugin、Publish Over SSH
Docker plugin配置: 在系统管理->节点和云管理中配置docker服务(走CA要把证书在这儿配置)
Publish Over SSH: 在系统管理->系统管理中->新增SSH Server
新建一个自定义风格流水线
1.设置git源码来源(认证可以用账号也可以用ssl)2.勾选Generic Webhook Trigger触发器并且设置Token(Token要用于gogs的webhook发送关联,也就是一个Token对应触发相应的流水线,也可以触发多个流水线)
3.新增构建步骤Build / Publish Image(这个是使用我们刚才配置的docker云节点,这儿的认证是给镜像仓库的认证,没有就不配置认证)
4.新增构建后的操作(也可以是构建步骤,这个只是关系到流水线是否构建成功的这个状态,随意),也就是我们的部署阶段,新增一个Send files or execute commands over SSH
流水线就配置完了,保存后尝试点一下Build Now,成功后,然后去部署主机的9000端口去看就部署好了
设置webhook的运行关联
进入gogs的jenkinstest项目->项目设置->管理Web钩子->新增gogs推送地址
jenkins地址/generic-webhook-trigger/invoke?token=你之前在插件里设置的Token
这儿由于gogs不支持单个分支的webhook触发,我设置的推送事件(也就是全部推送事件都能触发)
点一下测试推送(单机部署——自己推送自己,有可能出现推送禁用地址,去gogs的app.init修改一下安全地址,重启容器就能推送了),推送成功后,这边Jenkins就触发开始构建了
现在可以去本地随便写点代码,然后推送到gogs这个仓库,Jenkins就会自动帮你构建好了
备注:这儿设置push事件会导致所有gitpush事件都会触发这个,后续在按照tag进行构建的事件讲解过滤,让这个钩子只接收某个分支的事件进行构建,如果是用gitlab的小伙伴应该可以按分支进行配置webhook
基于gogs的tag进行构建
这个其实我在最开始也想了很多,去写多分支流水线巴拉巴拉的,我后来想到一个低成本的方法去写按照tag进行构建触发的形式
只需要一个自定义流水线就可以实现手动指定构建和gogs webhook触发tag构建
设置一个自定义风格的流水线用于构建tag
1.勾选结构化参数构建,命名为tag_name(不是必然的,自己随便定义,我是为了方便后续,因为这个变量后续会被其他触发器覆盖)2.设置git仓库,重点来了,这儿的分支按照文档这样写动态的,这样就会用我们前面构建的参数进行指定某个tag进行构建(我知道可以用shell写什么check out 巴拉巴拉的,我的配置是为了让大家简单易懂,因为写流水线脚本是要学习成本的)
3.重点来了(前面的push事件构建的时候没有过滤,这儿一块讲插件的过滤使用),构建触发器,还是我们的Generic Webhook Trigger也设置一个Token(最好是一个事件对应一个流水线),勾选他的Print post content,Print contributed variables(用于显示我们的webhook推送的内容和我们这个触发器通过这个webhook解析出来的变量)
4.构建环境勾选上Delete workspace before build starts(构建tag保证工作空间是干净的)
5.创建构建步骤Build / Publish Image(这儿的版本号就用刚刚识别到的变量)
6.gogs设置webhook,这次的钩子只设置版本发布的时候进行触发
7.去发布一个版本,然后Jenkins就会自动触发拉取相应的tag的代码进行构建,并推送到你的私有仓库里面
8.如果要线上发布,就追加上面一个开发环境和测试环境的部署阶段(不建议随便整,上线还是手动上的好)
钉钉推送
其实自动集成和交付都写完了,最后锦上添花,设置钉钉 简单教程 官方教程