@lonely9/deploy

前端部署系统 知识点小记

停止更新声明

本项目将在0.4.4版本之后停止外网更新，转为公司内部项目。

介绍

包含6个流程：

• 初始化。包含参数校验，本次程序运行参数，全局变量初始化等
• 环境信息。展示当前环境信息。
• 打包。包含依赖安装，文件打包，打包结果分析等。
• 分拣。包含将.map 文件移到到指定目录，移除js文件中对map文件的引用。
• 上传。将打包好的静态资源文件及map文件上传到七牛CDN。将index.html发送到指定服务器。
• 预热。对CDN上的静态资源进行请求。

使用

安装

npm i @lonely9/deploy@latest -g --registry https://registry.npmjs.org

全局安装deploy，使用npm官方源地址。其他镜像地址可能更新不及时。

使用

进入项目根目录，在命令行执行：

deploy [env]

• deploy是命令。指向@lonely9/deploy/bin/deploy.js。
• env <string> 是环境值。可以是env、test、stable、production。 对应关系见下表。

环境	环境名称
开发环境	dev
测试环境	test
预发环境	stable
正式环境	production

打包

打包其实是执行了npm scripts 里对应的四个命令，这四个命令对应四个环境，所以这四个命令一定得先在npm scripts 里面配置好。

{
  "scripts": {
    "build:dev": "",
    "build:test": "",
    "build:stable": "",
    "build:production": ""
  }
}

更多信息，可在命令行执行：

deploy help

回滚

支持简单回滚：只能回滚到上上次（相对于本次发布）成功发布的版本，此过程不可逆。

deploy [dev] --backup

例如：

1. 我发布了测试环境版本【index.html - 1.0.0】，此时会在发布机本地存储一个备份【index.html - 1.0.0】。 deploy test
2. 我又发布了测试环境版本【index.html - 2.0.0】，此时本地有两个备份【index.html - 1.0.0】、【index.html - 2.0.0】。deploy test
3. 我发现【index.html - 2.0.0】有重大错误，需要回滚到版本【index.html - 1.0.0】。deploy test --backup
4. 回滚成功，我又回到了步骤1的状态。

在步骤1时，不能回滚，因为该功能是回滚到上上次发布成功的版本，而本地没有这个备份。 步骤4时，本地存储文件只有一个【index.html - 1.0.0】。即此时无论服务器，还是本地状态都与步骤1时一模一样。所以，此过程不可逆——无法回到步骤2的状态。

配置文件

优先级。命令行参数 > 配置文件 > 默认值

在项目根目录配置.deploy.json。如下：

{
  "name": "项目名",
  "uploadDomain": "",
  "uploadBucket": "",
  "buildFileSizeLimit": 100,
  "verbose": false,
  "server": {
    "dev": [{
      "account": "admin",
      "domain": "192.168.1.2",
      "path": "/data/www/index/",
      "port": "8080"
    }]
  }
}

参数

参数名	必填	说明
name	是	项目名称
uploadDomain	是	上传七牛时对应的域名
uploadBucket	是	上传七牛时对应的bucket
server	是	服务器配置，格式见示例。
buildFileSizeLimit	否	打包后，超过多大体积（KB）的文件进行警告，默认100KB，值类型为number
verbose	否	是否展示流程细节，默认为false，不展示。
path	否	设置配置文件路径。默认值为'.deploy.json'。
registry	否	设置npm包安装源地址。默认值为'https://registry.npm.taobao.org'
skipWarmUp	否	设置是否跳过预热流程，默认为false，不跳过。
backup	否	设置是否回滚到上个版本，默认为false，不跳过。

也可以在命令行中执行：

deploy help

获取这些参数信息

特殊说明

• 默认只有test/production环境会生成sourcemap。可以在业务项目中的vue.config.js配置。 本项目只有检测到dist/static/js文件夹中有.map文件才会进行相应操作。