文档开发者中心
我的

nodejs原理and源码赏析(9)用node-ssh实现轻量级自动化部署

一. 需求描述

前端工程出包后实现简易的自动化部署。

二. 预备知识

网站的建设可以使用任何自己熟悉的框架,三大框架都有自己的官方Cli工具,从代码编写到生成可用于生产环境部署的包基本都有自动化命令,各个打包工具也在零配置的追求上做了很多工作。本篇中从得到一个生产环境的包以后开始,对站点部署的相关知识进行一些介绍。

首先你需要一个Web服务器,常见的有:

  • Nginx

  • Tomcat

  • Apache或相关集成环境

    • XAMMP【Apache+MySQL+PHP+PERL 】

    • LAMP【Linux+Apache+MySQL+PHP】

  • nodejs或相关框架+守护进程

    • Express

    • Koa2

以上任何一种在服务器上运行起来后都可以担任Web服务器的角色,只是具备的扩展功能和应用场景有区别,Nginx基本上是正式环境部署的首选方案。常见的基本部署方案如下:

IP+端口访问

使用访问,可直接访问对应端口的服务,部署方式相对简单:

域名访问

使用域名访问时,通常会使用A记录进行解析,它只能映射到80端口(https时映射到443),这时就需要使用反向代理将80端口的请求分发到本地不同的内部端口来访问对应服务:

本例中使用域名+IP的方式进行部署。

三. Nodejs应用的手动部署

以Express为例,步骤如下:

  1. 首先通过yarn global add express-generator或npm install express-generator -g全局安装脚手架

  2. 完成后在工作目录通过命令行express mydemo --ejs生成一个使用ejs作为模板渲染引擎的express工程

  3. 命令行输入cd mydemo && yarn或cd mydemo && npm install安装依赖

  4. 在/bin/www文件中修改端口号为期望的端口号(自动生成的是80端口),例如3001

  5. 将前端工程build出的包整体复制粘贴到/public目录中

  6. 此时在本地工程根目录下输入npm start后,在浏览器中http://localhost:3001就可以访问到网站了

  7. 使用FTP工具(如FlashFxp或FileZilla Client等)连接到部署机器,将mydemo目录压缩为zip包后上传到服务器指定目录。

  8. 使用SSH工具(如Xshell或MobaXter)登录远程机器,假设为linux系统,输入unzip mydemo.zip解压压缩包,然后cd mydemo进入服务端工程,输入npm start即可在服务器上开启Web服务,通过ip地址:3001就可以访问到网站。

  9. 但是如果此时SSH工具断开连接,就会发现express应用无法继续访问了,所以还需要一个守护进程来维持应用的启动状态,在服务端通过npm install pm2 -g来安装nodejs应用的部署管理模块,它可以实现多应用管理、Hook更新、自动重启等等许多常用功能,详细信息可以访问 【PM2官方网站】。

  10. 最后,在工程根目录输入pm2 start ./bin/www即可以后台模式运行应用。

四. 基于nodejs的自动部署

4.1 package.json中的scripts

了解了手动部署的过程后,就可以通过自动化脚本来实现后续的更新和部署。nodejs工程的自动化是依赖于package.json文件中的scripts配置项来实现的,例如使用vue-cli搭建的工程中就会带有:

{    ...          'scripts': {              'serve': 'vue-cli-service serve',                        'build': 'vue-cli-service build',                        'lint': 'vue-cli-service lint'             },            ...}

在项目根目录下打开命令行,输入npm run [script-key]或者yarn [script-key]([script-key]指上面示例中的serve,build,lint这些键名),就会执行对应的scripts[key]对应的命令。我们先添加一条用于自动部署的脚本指令:

{         ...             'scripts': {                      'build': 'vue-cli-service build',                         'deploy' 'node ./scripts/deploy/deploy.js'              },             ...}

当输入npm run deploy或yarn deploy时,实际上就相当于用node去执行./scripts/deploy/deploy.js这个脚本,其中就编写了自动化发布的指令。scripts还提供了生命周期钩子,比如你对接的是一个测试环境,希望每次build后自动发布,就可以使用post钩子来实现:

{          ...              'scripts': {                      'build': 'vue-cli-service build',                          'postbuild':'npm run deploy',                          'deploy' 'node ./scripts/deploy/deploy.js'               },              ...}

这样每次build执行完毕后,就会自动执行npm run deploy,也就是运行发布的脚本。

4.2 自动化发布脚本deploy.js

自动化发布脚本需要完成这样几个任务:

  • 将打包出的dist压缩为zip包

  • 使用SSH连接部署服务器,将zip包发上去

  • 上传完毕后,启动事先写好后续任务并放在服务器上的shell脚本来完成剩余的工作

涉及的几个模块包括实现SSH连接的node-ssh模块(底层是ssh2模块,这个模块是一个Promise封装),用于制作zip压缩包的archiver模块。node-ssh提供了上传本地目录的方法,但实际使用过程中发现并不稳定,从告警信息来看是node-stream模块在传送时将不同格式的文件转换为流时可能会出现异常,实测大约有一半概率触发,尝试修改了一些配置参数并未解决,所以采用archiver模块先压缩为单个文件后再进行上传。

参考代码如下:

4.3 远端脚本deploy.sh

当发布包上传至远程服务器后,剩余的工作在远端来完成就可以了,你只需要将后续的工作写进shell脚本并放在对应的目录里就可以了,本例中deploy.sh放在了服务端项目目录/mydemo中。示例如下(由于是自用系统,不考虑灰度发布等,直接暴力删除静态目录public,然后替换为新的包):

#!/bin/bashcd /usr1/AAA/mydemo#删除原静态资源目录rm -rf publiccd /usr1/AAA#解压新的包unzip public.zip#将解压出的public目录移动到服务端程序目录BBB中mv public ./mydemo

提示:

如果脚本文件是在windows下编写的,请注意将编辑器中的回车换行改为LF,windows下通常默认是CRLF,这可能会导致脚本在linux机器上无法正常执行。

至此,一个简易的自动化部署就做完了。你只需要在本地输入npm run deploy,后续的工作就会自动执行。

五. 小结

本篇只是一个简易的自动化部署流程,由于部署环境没有外网所以暂时无法借助通用的自动化流水线实现全自动的DevOps流程。PM2实际上还有非常多实用的功能,可以管理多个不同的应用实例,以集群模式运行实例,或者预设发布流程,可以直接响应Web Hook并对接指定的代码仓,在根目录下建立ecosystem.config.js配置文件就可以添加更多配置来指定pm2的表现,感兴趣的读者可以研究一下。

________________________________


BY:HW-SWQ

点赞
收藏
回复
9
分享
举报
浏览1845 编辑于2019-11-11 18:41未知归属地
全部评论
最多点赞
最新发布
最早发布

关联阅读:nodejs原理and源码杂记(8)Timer模块与基于二叉堆的定时器

9楼回复于2019-11-12 02:47 未知归属地

关联阅读: nodejs原理and源码赏析(7)

8楼回复于2019-11-12 02:46 未知归属地

关联阅读: nodejs原理and源码赏析(6)

7楼回复于2019-11-12 02:43 未知归属地

关联阅读:nodejs原理and源码赏析(5)

6楼回复于2019-11-12 02:43 未知归属地

关联阅读:nodejs原理and源码赏析(4)

5楼回复于2019-11-12 02:43 未知归属地

关联阅读:nodejs原理and源码赏析(3)

4楼回复于2019-11-12 02:43 未知归属地

关联阅读:nodejs原理and源码赏析(2)

3楼回复于2019-11-12 02:43 未知归属地

关联阅读:nodejs原理and源码赏析(1)

2楼回复于2019-11-12 02:42 未知归属地

第九篇的内容来啦!

1楼回复于2019-11-12 02:42 未知归属地
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要发帖子

目录 收起
一. 需求描述
二. 预备知识
IP+端口访问
域名访问
三. Nodejs应用的手动部署
四. 基于nodejs的自动部署
4.1 package.json中的scripts
4.2 自动化发布脚本deploy.js
4.3 远端脚本deploy.sh
五. 小结
了解社区公约,与您携手共创和谐专业的开发者社区。