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 了,哈哈,我也有这种感觉,但其实还差得很常远的,不过自己简单使用是肯定没啥问题了。

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

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

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

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

玫瑰已然到了花期

目录
相关文章
|
3月前
|
关系型数据库 MySQL Java
【Docker最新版教程】一文带你快速入门Docker常见用法,实现容器编排和自动化部署上线项目
Docker快速入门到项目部署,MySQL部署+Nginx部署+docker自定义镜像+docker网络+DockerCompose项目实战一文搞定!
|
4月前
|
测试技术
自动化测试项目学习笔记(五):Pytest结合allure生成测试报告以及重构项目
本文介绍了如何使用Pytest和Allure生成自动化测试报告。通过安装allure-pytest和配置环境,可以生成包含用例描述、步骤、等级等详细信息的美观报告。文章还提供了代码示例和运行指南,以及重构项目时的注意事项。
407 1
自动化测试项目学习笔记(五):Pytest结合allure生成测试报告以及重构项目
|
4月前
|
自然语言处理 jenkins 测试技术
Jenkins适合什么样的项目
【10月更文挑战第18天】Jenkins适合什么样的项目
55 3
|
4月前
|
测试技术 Python
自动化测试项目学习笔记(四):Pytest介绍和使用
本文是关于自动化测试框架Pytest的介绍和使用。Pytest是一个功能丰富的Python测试工具,支持参数化、多种测试类型,并拥有众多第三方插件。文章讲解了Pytest的编写规则、命令行参数、执行测试、参数化处理以及如何使用fixture实现测试用例间的调用。此外,还提供了pytest.ini配置文件示例。
102 2
|
4月前
|
测试技术 Python
自动化测试项目学习笔记(二):学习各种setup、tearDown、断言方法
本文主要介绍了自动化测试中setup、teardown、断言方法的使用,以及unittest框架中setUp、tearDown、setUpClass和tearDownClass的区别和应用。
133 0
自动化测试项目学习笔记(二):学习各种setup、tearDown、断言方法
|
4月前
|
jenkins Shell 持续交付
Jenkins持续集成GitLab项目 GitLab提交分支后触发Jenkis任务 持续集成 CI/CD 超级详细 超多图(二)
Jenkins持续集成GitLab项目 GitLab提交分支后触发Jenkis任务 持续集成 CI/CD 超级详细 超多图(二)
126 0
|
4月前
|
jenkins Shell 持续交付
Jenkins持续集成GitLab项目 GitLab提交分支后触发Jenkis任务 持续集成 CI/CD 超级详细 超多图(一)
Jenkins持续集成GitLab项目 GitLab提交分支后触发Jenkis任务 持续集成 CI/CD 超级详细 超多图(一)
326 0
|
6月前
|
持续交付 C# 敏捷开发
“敏捷之道:揭秘WPF项目中的快速迭代与持续交付——从需求管理到自动化测试,打造高效开发流程的全方位指南”
【8月更文挑战第31天】敏捷开发是一种注重快速迭代和持续交付的软件开发方法,通过短周期开发提高产品质量并快速响应变化。本文通过问题解答形式,探讨在Windows Presentation Foundation(WPF)项目中应用敏捷开发的最佳实践,涵盖需求管理、版本控制、自动化测试及持续集成等方面,并通过具体示例代码展示其实施过程,帮助团队提升代码质量和开发效率。
98 0
|
6月前
|
Java Spring UED
Spring框架的异常处理秘籍:打造不败之身的应用!
【8月更文挑战第31天】在软件开发中,异常处理对应用的稳定性和健壮性至关重要。Spring框架提供了一套完善的异常处理机制,包括使用`@ExceptionHandler`注解和配置`@ControllerAdvice`。本文将详细介绍这两种方式,并通过示例代码展示其具体应用。`@ExceptionHandler`可用于控制器类中的方法,处理特定异常;而`@ControllerAdvice`则允许定义全局异常处理器,捕获多个控制器中的异常。
76 0
|
3月前
|
jenkins Devops Java
DevOps实践:Jenkins在持续集成与持续部署中的价值
【10月更文挑战第27天】在快速发展的软件开发领域,DevOps实践日益重要。Jenkins作为一款流行的开源自动化服务器,在持续集成(CI)和持续部署(CD)中扮演关键角色。本文通过案例分析,探讨Jenkins在Java项目中的应用,展示其自动化构建、测试和部署的能力,提高开发效率和软件质量。
114 2