0.0.17 • Published 8 years ago
page-version-control v0.0.17
pvc
Page Version Control with redis 页面版本控制(通过redis)
解决了什么问题
webpack 打包后的页面里面包含css/js的地址和版本hash值, 我们通过相应的key把这个模板存入到redis里面, 后端通过指定的key从redis中读取这个模板信息渲染页面, 我们通过管理这些key达到前端自由管理版本的目的, 前端发布版本不需要后端做任何变更, 还可以即时切换/回退版本
注意事项
- 初始配置的参数prefix必须是唯一的, 是作为区分不同页面的id存在的
- 连接redis 只能在部署redis的机器上链接
版本控制原理
以初始设置prefix为icefire为例 1. 在redis里存储一个key为current_icefire_version的set 2. 每次发版本都会往redis里存一个hash, 把当前版本内容对应的hash的key作为第一步里的set的value存储起来 3. 版本的更新和回退都是通过直接修改第一步里的set的value来完成
如何从redis中读取当前版本的模板
以初始设置prefix为icefire为例 1. 当前版本的key为current_icefire_version 2. current_icefire_version对应的value就是 存取当前版本内容的hash的key 3. 通过第二步里的value 读取hash的值 里面就包含了当前版本对应的详细信息, 包括模板内容等
需要的redis配置格式
通过json配置来读写redis, 格式如下:
// 默认端口 6379
// 默认数据库 6
// $link: redis连接地址
// $name: redis实例名称
// $key: redis密码
// hz, us 为区域名称示例, 1个或多个都可以
{
"dbeta": {
"hz": {
"url": "$link",
"secret": "$name:$key",
"port": 6379,
"database": 6
},
"us": {
"url": "$link",
"secret": "$name:$key",
"port": 6379,
"database": 6
}
},
"release": {
"hz": {
"url": "$link",
"secret": "$name:$key",
"port": 6379,
"database": 6
},
"us": {
"url": "$link",
"secret": "$name:$key",
"port": 6379,
"database": 6
}
}
}
安装
全局安装(可直接使用命令行)
$ npm install -g page-version-control
直接使用命令行的话 就不需要书写调用代码, 直接在与node_modules平级的目录下放置下面这个配置文件即可: pvc.config.js
var path = require('path')
module.exports = {
redisPath: path.resolve(__dirname, './redis.json'),
htmlPath: path.resolve(__dirname, './dist/index.html'),
prefix: 'your custom name'
}
局部安装
$ npm install --save-dev page-version-control
通过命令行调用
pvc -h 帮助信息 pvc -v 当前版本 pvc publish pvc history pvc prev pvc rollback
通过API调用
引入
// cjs
var pvc = require('page-version-control')
// es6
import pvc from 'page-version-control'
创建实例
let env = 'dbeta'
let redisPath = path.resolve(__dirname, './redis.json')
let htmlPath = path.resolve(__dirname, './index.html')
var pvc = new Pvc({
htmlPath,
redisPath,
env,
prefix: 'icefire'
})
查看历史
// 只取当前版本之前的50条数据
pvc.showHistory()
获取当前版本的详细信息(模板内容等)
pvc.getCurrentDetail().then(rs => {
console.log(rs)
})
发布版本
// comment参数为必须
pvc.publish('comment.....')
回退到上一版本
pvc.prev()
回退到指定版本
// 48为版本索引
pvc.rollback(48)
基础API
基础redis操作
- exists
- keys
- get
- set
- hmget
- hmset
- hgetall
队列化后执行
- exec
// 例子
pvc.create()
pvc.set('key1', '001')
pvc.set('key2', '002')
pvc.set('key3', '003')
pvc.getAllKeys()
pvc.get('key1')
pvc.get('key2')
pvc.get('key3')
pvc.hmset('key4', {
name: 'yoyo',
gender: 2
})
pvc.hgetall('key4')
pvc.exec().then(rs => {
console.log(rs)
})