0
0

【微服务部署】四、Jenkins一键打包部署NodeJS（Vue）前端项目步骤详解

  本文介绍使用Jenkins一键将NodeJS（Vue）前端项目打包并上传到生产环境服务器，这里使用的是直接打包静态页面，发送到远程服务器Nginx配置目录的方式，首先确保服务器环境配置好，安装Nginx，运行目录，日志存放目录等。

一、服务器环境配置

  Nginx安装也有多种方式，源码安装、yum安装、Docker安装等，安装并不复杂，我们这里采用Docker安装的方式，由于习惯于标准化及存档，方便在不同服务器部署相同的环境，我们这里使用了Docker Compose来定义Nginx容器配置信息。

1. Nginx的docker-compose-nginx.yml定义文件编写

  Docker及Docker Compose安装配置，前面有详细介绍，这里不再赘述，以下是Nginx容器的Docker Compose定义文件内容：

  1. version: '3'
  2. services:
  3.     ##nginx配置
  4.     nginx:
  5.       image: nginx:latest
  6.       restart: always
  7.       container_name: nginx
  8.       environment:
  9.         - TZ=Asia/Shanghai
  10.       ports:
  11.          #端口映射，前面是宿主机端口，后面是服务端口
  12.         - 80:80
  13.         - 443:443
  14.       volumes:
  15.         - /data/container/nginx/html:/nginx/html
  16.         - /data/container/nginx/www:/var/www
  17.         - /data/container/nginx/logs:/var/log/nginx
  18.         - /data/container/nginx/etc:/etc/nginx
  19.         - /data/container/nginx/etc/nginx.conf:/etc/nginx/nginx.conf
  20.         - "/etc/localtime:/etc/localtime"
  21.         - "/usr/share/zoneinfo/Asia/Shanghai:/etc/timezone"
  22.         #若用到ssl，可以引入
  23.         - /bxl/container/nginx/ssl:/nginx/ssl

部分参数说明：

  • ports：端口映射，前面是宿主机端口，后面是容器内部服务端口
  • volumes：目录映射，前面是宿主机目录，后面是容器内部目录
2. 部署及备份目录准备
  • 新建 /opt/tmp 目录，用于Jenkins打包后，通过 Publish Over SSH插件将包传输到服务器的临时目录（如果前面创建过，这里无需再创建）。
  • 新建 /opt/bak 目录，用于存储所有部署过的包备份，方便后续版本回滚。此目录可能会占用很大空间，所以需要选择一个磁盘空间大的挂载目录（如果前面创建过，这里无需再创建）。
  • 新建 /opt/script 目录，用于Jenkins将包传输完成之后，执行安装、备份操作的相关命令脚本（如果前面创建过，这里无需再创建）。
  • 新建 /data/container/nginx/html，用与存放发布后的静态页面。
  • 新建 /data/container/nginx/www，映射Nginx容器内的/var/www目录。
  • 新建 /data/container/nginx/logs，映射Nginx容器内的/var/log/nginx目录，存放nginx运行日志。
  • 新建 /data/container/nginx/etc，映射Nginx容器内的/etc/nginx目录
  • 新建 /data/container/nginx/etc/nginx.conf，映射Nginx容器内的/etc/nginx/nginx.conf配置文件
  • 新建 /bxl/container/nginx/ssl，映射Nginx容器内的/nginx/ssl目录
  1. mkdir -p /opt/tmp /opt/bak /opt/script /data/container/nginx/html /data/container/nginx/www /data/container/nginx/logs  /data/container/nginx/etc  /bxl/container/nginx/ssl
  2. chmod -R 777 /opt/tmp /opt/bak /opt/script /data/container/nginx/html /data/container/nginx/www /data/container/nginx/logs  /data/container/nginx/etc  /bxl/container/nginx/ssl
3.根据系统部署要求编写Nginx配置文件nginx.conf，以下是简单的配置方法，正常情况下https请求还需要配置ssl证书，还有ipv6配置等，后面详细讲解Nginx配置。一定要将修改后的nginx.conf文件放到/data/container/nginx/etc/目录下，否则nginx启动时会报错找不到配置文件。
  1.     server {
  2.         listen 80;
  3.         server_name  域名;
  5.         gzip on;
  6.         gzip_buffers 32 4K;
  7.         gzip_comp_level 6;
  8.         gzip_min_length 100;
  9.         gzip_types application/javascript text/css text/xml text/plain application/x-javascript image/jpeg image/gif image/png;
  10.         gzip_disable "MSIE [1-6]\."; 
  11.         gzip_vary on;
  13.         #charset koi8-r;
  15.         access_log  /var/log/nginx/portal.access.log  main;
  17.         location / {
  18.                 root /nginx/html/gitegg_portal;
  19.                 try_files $uri $uri/ /index.html;
  20.                 index  index.html index.htm;
  21.         }
  23.         location /gitegg-api/ {
  24.             proxy_set_header Host $http_host;               
  25.             proxy_set_header X-Real-Ip $remote_addr;
  26.             proxy_set_header REMOTE-HOST $remote_addr;
  27.             proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  28.             proxy_pass http://172.17.0.1:8080/;
  29.         }
  30.     }
4. 部署脚本编写说明
  • 定义入参，可以通过Jenkins任务将参数传入脚本中，我们定义了下面2个参数： project_name=“portal” ： 服务名称 portal_home=“/data/container/nginx/html” ： 静态页面路径
  • 对参数进行检查，是否未传入参数，这里根据自己的实际情况判断，比如必须传入哪些参数，就设置参数的个数不能小于几。
  1. #param validate
  2. if [ $# -lt 1 ]; then  
  3.   echo "you must use like this : ./publish_portal.sh <project_namename> [portal home dir]"  
  4.   exit  
  5. fi
  • 入参赋值，如果有参数传入，则取服务参数，如果没有参数传入则取默认值
  1. if [ "$1" != "" ]; then
  2.    project_name="$1"
  3. fi
  4. if [ "$2" != "" ]; then
  5.    portal_home="$2"
  6. fi
  • 删除原部署的静态文件，解压当前发布包
  1. # 删除
  2. rm -rf "$portal_home"/index.html "$portal_home"/favicon.ico "$portal_home"/_app.config.js "$portal_home"/logo.png "$portal_home"/resource/ "$portal_home"/assets/
  3. # 解压
  4. cd /opt/tmp/portal
  5. tar -zxvf portal.tar.gz
  • 备份当前发布的静态文件包
  1. #bak project_name
  2. BAK_DIR=/opt/bak/portal/$project_name/`date +%Y%m%d`
  3. mkdir -p "$BAK_DIR"
  4. cp /opt/tmp/portal/portal.tar.gz "$BAK_DIR"/"$project_name"_`date +%H%M%S`.tar.gz
  5. #remove tmp
  6. rm -rf portal.tar.gz
  • 将解压的静态文件copy到Nginx目录下
  1. #copy portal code
  2. cp -r * "$portal_home"
  • 删除临时文件
  1. #remove tmp
  2. rm -rf index.html favicon.ico _app.config.js logo.png resource assets
  • 打印执行完成的命令
  1. echo "Portal is starting,please try to access $project_name conslone url"
  • 完整的安装部署脚本
  1. project_name="portal"
  2. portal_home="/data/container/nginx/html"
  3. #param validate
  4. if [ $# -lt 1 ]; then  
  5.   echo "you must use like this : ./publish_portal.sh <project_namename> [portal home dir]"  
  6.   exit  
  7. fi
  8. if [ "$1" != "" ]; then
  9.    project_name="$1"
  10. fi
  11. if [ "$2" != "" ]; then
  12.    portal_home="$2"
  13. fi
  15. echo "portal code copy"
  16. #publish project_name
  17. echo "$project_name publishing"
  18. rm -rf "$portal_home"/index.html "$portal_home"/favicon.ico "$portal_home"/_app.config.js "$portal_home"/logo.png "$portal_home"/resource/ "$portal_home"/assets/
  19. cd /opt/tmp/portal
  20. tar -zxvf portal.tar.gz
  21. #bak project_name
  22. BAK_DIR=/opt/bak/portal/$project_name/`date +%Y%m%d`
  23. mkdir -p "$BAK_DIR"
  24. cp /opt/tmp/portal/portal.tar.gz "$BAK_DIR"/"$project_name"_`date +%H%M%S`.tar.gz
  25. #remove tmp
  26. rm -rf portal.tar.gz
  27. #copy portal code
  28. cp -r * "$portal_home"
  29. #remove tmp
  30. rm -rf index.html favicon.ico _app.config.js logo.png resource assets
  31. #start portal
  32. echo "Portal is starting,please try to access $project_name conslone url"
  • 将部署脚本上传到服务器的/opt/script目录下，并赋予可执行权限
  1. chmod 755 publish_portal.sh
二、新建Jenkins配置打包任务，部署打包后的Vue页面
1. Dashboard > 新建任务，输入任务名称，选择“构建一个自由风格的软件项目”，点击确定。

Dashboard
新建任务

2. 项目配置，进入到任务配置页
  • 丢弃旧的构建 ：这里在保持构建的最大个数填写5，当然可以根据自己情况填写，否则旧的构建包会一直存在占用磁盘空间。丢弃旧的构建
  • 源码管理：配置git代码地址、用户名密码和版本分支，如果是需要用户名密码的git库，那么下面需要选择访问的用户名密码，这里一定要使用用户名密码方式，使用token的方式无法选中。可以在下方add，也可以在Jenkins全局Credentials 中添加，方便其它任务使用。

源码管理

访问凭证

  • 构建触发器：可选可不选，这个根据自己的需求选择，任务在什么情况下出发构建。构建触发器
  • 构建环境：这里选择Provide Node & npm bin/ folder to PATH，选择我们在系统配置中配置的Node版本。

构建环境

  • Build Steps：选择执行shell，在shell窗口中输入需要执行的打包命令。

Build Steps

shell脚本

  • shell脚本完整内容：
  1. echo $PATH
  2. node -v
  3. pnpm -v
  4. pnpm install
  5. pnpm run build
  6. cd dist
  7. rm -rf portal.tar.gz
  8. tar -zcvf portal.tar.gz *
  9. cd ../
  • 构建后操作：选择构建后将包发送到服务器构建后操作
  • Post Steps：将打包后的文件发送到服务器，并执行设置好的脚本，这里选择Run only if build succeeds，当构建成功时Post。

Post Steps1

  • Exec command：将打好的包发布到环境之后，在环境上执行的部署脚本命令。/opt/script/publish_portal.sh 是脚本文件、portal 是项目名称、/data/container/portal 是前端代码存放路径。
  1. /opt/script/publish_portal.sh portal /data/container/portal

Post Steps2

3. 运行构建任务
  • 立即构建

立即构建

  • 查看构建日志：点击立即构建之后，下方会出现进度条，点击进度条就可以进入构建日志界面。

查看构建日志

日志

4. 构建成功后，下方会给出构建成功提示，此时登录远程服务器查看文件是否部署成功即可。

部署成功

标签： 前端 微服务 jenkins
本文转载自: https://blog.csdn.net/wmz1932/article/details/132662528
版权归原作者 全栈程序猿 所有， 如有侵权，请联系我们删除。
登录后发布评论

“【微服务部署】四、Jenkins一键打包部署NodeJS（Vue）前端项目步骤详解”的评论:

还没有评论
关于作者
...
overfit同步小助手
文章同步
相关阅读

网络安全法-网络运行安全

使用selenium/drissionpage时如何阻止chrome自动跳转http到https

docker desktop 里部署的Open WebUI 管理员密码忘记了的处理方法

在ubuntu20.04中搭建onsite比赛运行环境

利用开源的低代码表单设计器FcDesigner高效管理和渲染复杂表单结构

Kafka学习笔记

【前端】浏览器输入url到页面呈现发生了什么？

文章导航
没有找到文章内容分段。。。