# 实现目标

本地 push 代码到 GitHub,Webhook 自动触发 jenkins 上的构建动作,完成安装 node 插件并且打包,然后通过 Publish Over SSH 插件,将打包出来的文件,部署到目标服务器上。

# 前期准备

  1. github 账号和项目
  2. centos 服务器;
  3. 服务器安装 Java SDK;
  4. 服务器安装 nginx + 启动;
  5. 服务器安装 jenkins + 启动;

# jenkins 介绍

Jenkins 是开源的,使用 Java 编写的持续集成的工具,在 Centos 上可以通过 yum 命令行直接安装。Jenkins 只是一个平台,真正运作的都是插件。这就是 jenkins 流行的原因,因为 jenkins 什么插件都有。

# 首先登录服务器更新系统软件

$ yum update

# 安装 Java 和 git

$ yum install java
$ yum install git

# 安装 nginx

$ yum install nginx //安装
$ service nginx start //启动

出现 Redirecting to /bin/systemctl start nginx.service

说明 nginx 已经启动成功了,访问http://你的ip/,如果成功安装会出来nginx默认的欢迎界面

章节配图

# 安装 Jenkins

$ wget -O /etc/yum.repos.d/jenkins.repo http://pkg.jenkins-ci.org/redhat/jenkins.repo
rpm --import https://jenkins-ci.org/redhat/jenkins-ci.org.key
$ yum install jenkins //完成之后直接使用 yum 命令安装 Jenkins
$ service jenkins restart  //启动 jenkins

jenkins 启动成功后默认的是 8080 端口,浏览器输入你的服务器 ip 地址加 8080 端口就可以访问了。

章节配图

输入 cat /var/lib/jenkins/secrets/initialAdminPassword 查看初始密码

这里我们选择推荐通用插件安装即可,选择后等待完成插件安装以及初始化账户

章节配图
章节配图
章节配图

然后安装两个推荐的插件 Rebuilder SafeRestart

# 在 jenkins 中安装 nodeJs 插件

因为我们的项目是要用到 node 打包的,所以先在 jenkins 中安装 nodeJs 插件,安装后进入全局工具配置,配置一个我们要用到的 node 版本。

章节配图
章节配图

# 创建任务

点击创建一个新任务

章节配图
章节配图

jenkins 关联 GitHub 项目地址

章节配图

选择构建环境并编写 shell 命令

章节配图

配置完成后点击立即构建,等待构建完,点击工作空间,可以发现已经多出一个打包后的 dist 目录。点击控制台输出可以查看详细构建 log

章节配图
章节配图
章节配图

到这里已经实现了本地代码提交到 github,然后在 jenkins 上点击构建,可以拉取代码并且打包,下一步实现打包后的 dist 目录放到目标服务器上。

# 安装 Publish Over SSH 插件

我们将通过这个工具实现服务器部署功能。

安装完成后在 系统管理 -> 系统设置 -> Publish over SSH 里设置服务器信息

Passphrase:密码(key的密码,没设置就是空)
Path to key:key文件(私钥)的路径
Key:将私钥复制到这个框中(path to key和key写一个即可)
SSH Servers的配置:
SSH Server Name:标识的名字(随便你取什么)
Hostname:需要连接ssh的主机名或ip地址(建议ip)
Username:用户名
Remote Directory:远程目录(上面第二步建的testjenkins文件夹的路径)
高级配置:
Use password authentication, or use a different key:勾选这个可以使用密码登录,不想配ssh的可以用这个先试试
Passphrase / Password:密码登录模式的密码
Port:端口(默认22)
Timeout (ms):超时时间(毫秒)默认300000

这里配置的是账号密码登录,填写完后点击 test,出现 Success 说明配置成功

章节配图

在刚才的 testJenkins 工程中配置构建后操作,选择 send build artificial over SSH, 参数说明:

Name:选择一个你配好的ssh服务器
Source files :写你要传输的文件路径
Remove prefix :要去掉的前缀,不写远程服务器的目录结构将和Source files写的一致
Remote directory :写你要部署在远程服务器的那个目录地址下,不写就是SSH Servers配置里默认远程目录
Exec command :传输完了要执行的命令,我这里执行了进入test目录,解压缩,解压缩完成后删除压缩包三个命令

注意在构建中添加压缩 dist 目录命令

章节配图

填完后执行构建。成功后登录我们目标服务器发现 test 目录下有了要运行的文件

章节配图

访问域名发现项目可以访问了

章节配图

接下来实现开发本地 push 代码到 github 上后,触发 Webhook,jenkins 自动执行构建。

jenkins 安装 Generic Webhook Trigger 插件 github 添加触发器

# 配置方法

1.在刚才的 testJenkins 工程中点击构建触发器中选择 Generic Webhook Trigger,填写 token

章节配图

2.github 配置 Webhook 选择 github 项目中的 Settings->Webhooks>add webhook 配置方式按上图红框中的格式,选择在 push 代码时触发 webhook,成功后会在下方出现一个绿色的小勾勾

章节配图

测试一下,把 vue 项目首页的 9900 去了,然后 push 代码去 github,发现 Jenkins 中的构建已经自动执行,

章节配图

查看页面也是 ok 的

章节配图

一套简单的前端自动化工作流就搭建完成,是选择代码 push 后在 Jenkins 中手动构建,还是 push 后自动构建,看公司情况使用

让 Jenkins 帮你自动布署 Vue 项目 (opens new window)