使用 Webpack 为单页面应用发布新版本

简介

现在单页面网站开发一般会用 npm run build 执行 webpack 打包程序用来压缩 js css 之类。
某一天,跟同事交流时发现可以这样搞:

  1. 服务器上跑一个 nodejs 进程,如 http://yoursite.com:8080

  2. 在 Webpack 打包结束时自动 request.get 一下服务器 http://yousite.com:8080/?newhash=xxx

  3. 服务器接收到 get 请求后有 nodejs 脚本将单页面应用的 index.html 中引用的版本号替换成这个新的版本

实现最简便高效的发布新版本

详细步骤

服务器环节

用到三个文件:

  1. index.html 单页面应用入口

  2. tpl.html 作为 index.html 的母版,引用的 js 地址为 http://__CDN_URL__/site-assets/xxx.__VERSION__.js,其中 VERSION 是版本号的 placeholder

  3. index.js 跑 nodejs 服务器和替换版本号程序的脚本

index.js 代码示例

var startCopyHtml = function(newhash) {
var tplContent = fs.readFileSync('./tpl.html').toString()
tplContent = tplContent.replace('VERSION', newhash)
fs.writeFileSync('./index.html', tplContent)
}
require("http").createServer(function(req, res) {
var parsedUrl = require("url").parse(req.url, true);
var queryAsObject = parsedUrl.query;
if(queryAsObject.newhash) {
startCopyHtml(queryAsObject.newhash)
}
res.end('ok');
}).listen(8080);
以上代码只是示范,不要用于生产环境。

推荐可以做以下安全措施

  1. 本地设置特殊的请求头,服务器检查请求头。如特殊的 user agent

  2. 校验 newhash 参数

  3. 检查传入的 newhash 对应的 js 和 css 的 cdn 地址是否已生效(cdn 回源有延时)

  4. 白名单限制 IP 来源

  5. 本地和服务器做一个密文对照表,访问时带上密文进行验证

服务器环节配置可以参考:webpack-deploy-markdown-site-server

Webpack 配置环节

在 Webpack 中的 output.publicPath 配置为 CDN 的绝对地址。如:

config.output.publicPath = "http://__CDN_URL__/site-assets/"
config.output.filename = "build.[hash].js"
在 Webpack config.plugins 配置中,添加监听 done 事件的回调。在回调中执行以下任务:

  1. 同步 Webpack 打包好的静态资源到 CDN 的脚本

  2. 通过访问 http://yoursite.com:8080/?new-deploy-hash=xxx 来更新网站的静态资源引用地址。

config.plugins = [
function() {
this.plugin('done', function(stats) {
require('./upload-qiniu')
require('./update-assets-version')(stats.hash)
})
},
// 其他插件 ...
}
./upload-qiniu.js 代码

var qiniu = require('gulp-qiniu');
var cdnConfig = {
accessKey: "QINIU_KEY",
secretKey: "
QINIU_SECRET
",
bucket: "__QINIU_BUCKET__",
private: false
}

var uploadCdn = function (src, cdnDest) {
if(!src || !cdnDest)
return
cdnConfig.dest = cdnDest
require('vinyl-fs').src(src)
.pipe(qiniu(cdnConfig, {
dir: cdnDest,
versioning: false,
concurrent: 10
}))
}

uploadCdn(/webpack打包产生的 build 地址/'./build/ ', 'site-assets/')
./update-assets-version.js

module.exports = function(hash) {
var deployHashUrl = 'http://yoursite.com:8080/?newhash=' + hash
require('http').get(deployHashUrl);
}

Demo

我的博客(http://zaishanda.com/)就是用这种方法部署的

这个博客的代码在此:webpack-deploy-markdown-site

Q&A

安全吗?

服务器环节,替换 index.html 中的版本之前要检查传入的 newhash 对应的 cdn 地址是真实存在的才去替换。
再在服务器上加上 IP 白名单限制访问 http://yoursite.com:8080/ 这样就足够安全了。

跟 git 发布有什么优势啊?

比 git 发布门槛低很多。这个方案只要服务器上有 nodejs 就可以处理所有事情了。不用在服务器建 git repo,也不需要配置 hook 操作。

跟运行 ssh 命令把修改后的 index.html 上传比有何优势?

scp rsync 之类的部署方案得在 Webpack 中运行 ssh 脚本,这要每台本地机器都有 ssh 权限。还会在每台本地机器暴露服务器上的地址。

原文链接:http://zaishanda.com/post/3

关键字:webpack, node.js, git, npm

版权声明

本文来自互联网用户投稿,文章观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处。如若内容有涉嫌抄袭侵权/违法违规/事实不符,请点击 举报 进行投诉反馈!

立即
投稿

微信公众账号

微信扫一扫加关注

返回
顶部