Jenkins + Github + Nginx 自动化部署 Vue 项目

简介: Jenkins + Github + Nginx 自动化部署 Vue 项目

前言

看起来好像 Jenkins 非常复杂,但其实只要自己多实操几次,一次又一次的去想如何偷懒,你就可以一步一步发现更多的知识点,要相信好奇永远是你的第一老师。

关于如何使用 Docker 安装 Jenkins,Jenkins 插件安装配置、系统配置等,都已在 关于 Docker + Jenkins +Github 实现自动化 中全部陈述。

先说说本文最后做出来的效果:

  1. 本地开发,push 到 github 仓库后
  2. 触发 Github 的钩子函数,通知 Jenkins ,进行重新构建
  3. Jenkins 构建完成后,将前端打包出来的 dist 目录,发送到部署的服务器上的 Nginx 容器挂载的部署目录下
  4. 进行访问测试

除了第一步是需要自己动手外,其余部分实现自动化。

前一篇文章主要介绍了 Jenkins 如何构建一个 Maven 项目,但其实大家可以看到 Jenkisn 还有其他几钟不同的构建项目的方式。

1704465780949.jpg

本篇文章用到的是自由风格式(Freestyle project)部署前端项目。也很简单的哈。

一、初始化项目

如果需要跟着文章实操,大致需要以下环境:

  • 一台云服务器或本地虚拟机
  • 服务器或虚拟机上需要联网、Docker 环境
  • 一个 Github 账号
  • 开发机器上需要有 Git 和 开发环境

1、初始化 Vue 项目

其实我也不知道这一步该不该写......

重点就是大家准备一个可以运行和打包的 Vue 项目。

如果有小伙伴,没的话,我有~,给你指路: jenkins-vue-demo

拉下来之后,把 .git 文件删除掉,然后重新关联你的github 仓库就好~

2、推送至 Github 仓库

  • 在 github 建立一个仓库 (默认大家都会哈~ 不会可以留言的,摸鱼的时候会回复的,别慌)
  • 然后在本地项目目录下执行下面的命令,其实不写,在你创建仓库的时候也会给出这些提示命令
git init 
  git add .
  git commit -m "init"
  git branch -M main
  git remote add  远程仓库地址
  git push origin main

二、设置 Github

1、设置通知 WebHook

在github 上点击仓库,按下图顺序

1704465796780.jpg

1704465807190.jpg

之后点击创建即可

2、创建一个 Personal access tokens

1704465828341.jpg

1704465830769.jpg

1704465858641.jpg

1704465860516.jpg

三 、Jenkins 部署 Vue 项目

1、安装 Nodejs 插件

1704465875038.jpg1704465877119.jpg

等待完成即可

1704465890640.jpg

2、配置 Nodejs

1704465896826.jpg

本地机器查看 node 版本 命令为 node -v

1704465904356.jpg

3、系统配置

之前我们在第四小节,只是在Jenkins中进行了打包,并未发布在服务器上。

如果要发布在服务器上,我们还需要配置一下 远程服务器信息。

此处还需要下载两个插件

稍详细的描述在我上一篇文章:Docker + Jenkins + GitHub 自动化部署 Maven 项目

1704465912480.jpg

找到两个配置:

1、SSH remote hosts

2、SSH Servers

1704465919657.jpg

1704465935882.jpg

1704465929713.jpg

对了记得点击保存哈,不然又得重现填写。

4、创建一个自由风格式任务

1704465943054.jpg

1704465945082.jpg

1704465947421.jpg

(图片说明:指定分支应为 main,图中有误)

1704465961464.jpg

1704465975112.jpg

1704465977804.jpg

1704465980871.jpg

1704466000655.jpg

(图片说明:变量无需填写)

1704466007244.jpg

(图片说明:选择 secret text)

1704466017060.jpg

(图片说明:描述就是取一个名称)

1704466022599.jpg

(图片说明:选择自己添加的那个 凭据)

1704466029464.jpg

1704466036478.jpg

npm cache clear --force # 清理 npm 缓存,之前我一直报错,第一次之后大家可以修改修改 ~
  npm --registry https://registry.npm.taobao.org install cluster # 配置淘宝镜像
  npm install --force 
  npm run build
  echo "打包完成"

执行到这一步时,我们已经可以测试我们当前的这个自由风格的任务了。

点击立即构建,看看git有没有成功拉取,有没有打包成功。

第一次构建的时间也会稍长,需要拉取项目,下载Nodejs,下载依赖等,这些信息都会在控制台上可查看:

1704466044499.jpg

1704466047366.jpg

成功的输出应该如下:

1704466057376.jpg

1704466062296.jpg

5、浅提一下Nginx

谈到部署前端项目时,大部分情况下我们不可避免的会谈到Nginx服务器。

Nginx 这个中间件,不管是对于后端还是前端,都是需要了解的一个服务器。

想要深入的了解它,可能还需要你好好的花费一些时间。

关于Docker 安装 Nginx 部署 前端项目 ,我之前已经写好,链接:Docker 安装 Nginx


后面的小节,都是默认大家已经安装好了Nginx~

我的Nginx 的 server配置如下:

location /hello {
      alias    /usr/share/nginx/html/www/hello/dist;
      try_files $uri $uri/ /hello/index.html;
      index  index.html index.htm;
  }

我们部署成功访问的路径是:IP : Port/hello/ ,例如:192.168.1.100/hello/ 就是访问此项目的的地址。

详细的还是得大家去了解一下。

6、修改Jenkins 任务配置

打开任务配置,直接划到最下面

1704466096969.jpg

1704466099274.jpg

然后选中之前配置的服务器

1704466110204.jpg

#/bin/bash
 # 其实在这里执行的命令,就是在你选择的那台服务器上执行的命令
  echo ">>>>>>>>>>>>>开始执行   此处的 /home/nginx/html/web 是我 nginx 容器 挂载的目录 >>>>>>>>>>>>>"
  cd /home/nginx/html/www/hello/dist/
  rm -rf  dist
  echo ">>>>>>>>>>>>>cd到Jenkins工作挂载目录下>>>>>>>>>>>>>"
  cd /home/jenkins/workspace/jenkins-vue-demo
  echo ">>>>>>>>>>>> 将dist文件夹复制到 nginx 的挂载目录下 >>>>>>>>>>>>>"
  cp -r dist /home/nginx/html/www/hello/
  echo ">>>>>>>>>>>>复制成功  启动成功>>>>>>>>>>>>>"

注意:此处我是直接采取将 dist 目录直接放在了 Nginx 部署的目录下的,请注意:我这里并非是一个合格的方式,只能说是用来写Demo倒也无妨。请大家不要照抄~.

7、最佳实践

看过上一篇文章的读者可能知道,真正的应用场景中这样的部署并不安全,一旦出现bug,甚至都没法立马回退版本,或者出现意外情况没法快速横向扩容.

所以大概率下,最佳实践应当是

  1. 在 vue 项目中增加 Dockerfile 文件 和 nginx.conf 配置文件
  2. 部署时,首先将 dist + Dockerfile + nginx.conf 打成镜像 (docker build 相关明令)
  3. 将打包出来的镜像上传至存储应用的服务器或DockerHub(私服仓库)
  4. 最后在部署服务器上从存储镜像的那台服务器上拉取镜像,执行 docker run 相关命令进行发布.
  5. 测试

原本是没有这一小节的,但是读了一遍,感觉有点遗漏,就新增了这一段。

当时在写的时候,前期的Nginx环境已经搭好,一定程度上少了一些思考,所以就补了这一小节。

关于 Vue 项目利用 Dockerfile 打包成镜像部署,以往也写过一篇不成熟的博客,如果有想改造成镜像发布的小伙伴,可以参考一下。链接:Docker 部署 vue项目

8、测试自动构建

我们在本地修改文件,然后推送到远程仓库中,你刷新jenkins页面,就会发现它已经开始在构建啦。

1704466152864.jpg1704466116388.jpg

(图片说明:此处我放上的是刚写文的测试)

请注意:Github 因为是公用资源,有一定程度延迟,这一点在自己搭建的GitLab的私有仓库上是没有的。

看看我滴测试结果~

1704466126846.jpg

后记

写到这里本文也算是结束了,感觉这篇文章的质量比起上一篇的质量略低,可能里面带有一些重复性的内容,导致写起来有些懈怠了,望各位见谅。

看完这两篇文章,可能会有小伙伴产生一种感觉自己会用 Jenkins 了,哈哈,我也有这种感觉,但其实还差得很常远的,不过自己简单使用是肯定没啥问题了。

这个专栏还在继续更新,两篇入门文章总算是搞定了~

希望让你有所收获~,很开心你读到这里,听我讲完废话

如果今天的你也没有收到情书的话,那就让我送一封情书给你吧💌,

你不是一个人,你还有我。

玫瑰已然到了花期

目录
相关文章
|
1月前
|
编解码 Oracle Java
java9到java17的新特性学习--github新项目
本文宣布了一个名为"JavaLearnNote"的新GitHub项目,该项目旨在帮助Java开发者深入理解和掌握从Java 9到Java 17的每个版本的关键新特性,并通过实战演示、社区支持和持续更新来促进学习。
79 3
|
1月前
|
JSON JavaScript 前端开发
《进阶篇第7章》学习vue中的ajax之后,练习vue案例-github用户搜索案例
《进阶篇第7章》学习vue中的ajax之后,练习vue案例-github用户搜索案例
16 0
|
3月前
|
SQL JavaScript 前端开发
Github 2024-08-05 开源项目周报 Top15
根据 Github Trendings 的统计,本周(2024年8月5日统计)共有15个项目上榜。以下是根据开发语言汇总的项目数量: - Go 项目:4个 - JavaScript 项目:3个 - Python 项目:3个 - Java 项目:2个 - TypeScript 项目:2个 - C 项目:1个 - Shell 项目:1个 - Dockerfile 项目:1个 - 非开发语言项目:1个
121 2
|
3月前
|
人工智能 Rust JavaScript
Github 2024-08-26 开源项目周报Top15
根据Github Trendings的统计,本周共有15个项目上榜。以下是按开发语言汇总的项目数量:Python项目8个,TypeScript、C++ 和 Rust 项目各2个,Jupyter Notebook、Shell、Swift 和 Dart 项目各1个。其中,RustDesk 是一款用 Rust 编写的开源远程桌面软件,可作为 TeamViewer 的替代品;Whisper 是一个通用的语音识别模型,基于大规模音频数据集训练而成;初学者的生成式人工智能(第2版)则是由微软提供的18门课程,教授构建生成式AI应用所需的知识。
132 1
|
3月前
|
Rust Dart 前端开发
Github 2024-08-19 开源项目周报Top15
根据Github Trendings的统计,本周(2024年8月19日统计)共有15个项目上榜。按开发语言分类,上榜项目数量如下:Python项目最多,有7项;其次是JavaScript和TypeScript,各有3项;Dart有2项;HTML、PowerShell、Clojure和C++各1项。此外,还介绍了多个热门项目,包括Bootstrap 5、RustDesk、ComfyUI、易采集、Penpot等,涵盖了Web开发、远程桌面、自动化测试、设计工具等多个领域。
110 1
|
3月前
|
JavaScript 前端开发 Go
Github 2024-08-12 开源项目周报 Top14
本周Github Trendings共有14个项目上榜,按开发语言汇总如下:Python项目7个,TypeScript项目5个,C项目2个,JavaScript项目2个,Go和Batchfile项目各1个。其中亮点包括开发者职业成长指南、Windows激活工具、ComfyUI图形界面、AFFiNE知识库、易采集可视化爬虫等项目,涵盖多种实用工具和开源平台。
131 1
|
3月前
|
存储 JavaScript 前端开发
Github 2024-07-29 开源项目周报Top15
根据 Github Trendings 的统计,本周(2024年7月29日统计)共有15个项目上榜。按开发语言分类,项目数量如下:Python、Java、HTML 和 C 项目各有2项;TypeScript、JavaScript、Vue 和 Go 各有1项;另有1项非特定语言项目、1项 Dart 项目、1项 C++ 项目、1项 Rust 项目及1项 Jupyter Notebook 项目。这些项目涵盖了多种领域,如API开发、照片管理、PDF处理、AI技术等。
63 1
|
3月前
|
Rust JavaScript 前端开发
Github 2024-07-15 开源项目周报 Top15
根据 Github Trendings 的统计,2024年7月15日当周共有15个项目上榜。以下是按开发语言分类的项目数量汇总:Python项目5个,非开发语言项目4个,JavaScript项目3个,TypeScript项目2个,Go、Solidity和Java项目各1个,Rust项目1个。此外,介绍了多个值得关注的项目,包括免费编程学习平台 freeCodeCamp.org、免费编程书籍和学习资源清单、免费 API 集合等,涵盖了不同编程语言和技术领域。
56 1
|
3月前
|
人工智能 JavaScript API
Github 2024-07-08 开源项目周报 Top15
根据Github Trendings的统计,本周(2024年7月8日统计)共有15个项目上榜。按开发语言分类,Python项目最多,有6项;其次是C++和TypeScript,各有3项;Jupyter Notebook和JavaScript各2项;QML、非开发语言项目、Rust则各有1项。这些项目涵盖了多种领域,包括编程教育、API集合、语言模型、十六进制编辑器等。
52 1
|
3月前
|
存储 安全 Java
【事故】记一次意外把公司项目放到GitHub并被fork,如何使用DMCA下架政策保障隐私
在一次意外中,作者因三年前将测试代码遗忘在GitHub上而遭遇了代码被他人fork的问题。为解决这一危机,作者详细介绍了如何通过GitHub的DMCA下架通知流程安全删除敏感代码,包括处理私人信息和商标侵权的具体步骤。本文不仅提供了实用的操作指南,还强调了及时响应的重要性,帮助读者避免类似风险
42 0
【事故】记一次意外把公司项目放到GitHub并被fork,如何使用DMCA下架政策保障隐私
下一篇
无影云桌面