grunt-git2upyun
grunt plugin for uploading files managed by git to UPYUN.
用于将 git 仓库中管理的文件同步到又拍云。
Getting Started
This plugin requires Grunt ~0.4.4
If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:
npm install grunt-git2upyun --save-devOnce the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:
grunt.loadNpmTasks('grunt-git2upyun');The "git2upyun" task
Overview
In your project's Gruntfile, add a section named git2upyun to the data object passed into grunt.initConfig().
grunt.initConfig({
git2upyun: {
your_target: {
options: {
// Target-specific file lists and/or options go here.
}
},
},
});Options
options.bucketname
Type: String
Default value: ''
空间名称。请参考又拍云对此术语的定义。
options.username
Type: String
Default value: ''
操作员名称。请参考又拍云对此术语的定义。
options.password
Type: String
Default value: ''
操作员密码。请参考又拍云对此术语的定义。
options.root
Type: String
Default value: ''
文件在云存储服务器上存储的根目录。可以是/，表示空间的根目录。所有上传的文件最终路径是：
path.join(options.root, '文件在仓库中的相对路径')options.repository
Type: String
Default value: ./
本地仓库路径，此仓库中所管理的文件都将上传至又拍云。
options.ignore
Type: String || array
Default value: []
忽略哪些文件。采用 grunt.file.expand 函数对传入的参数进行解析。请参考：http://gruntjs.com/api/grunt.file#grunt.file.expand
options.cleanpath
Type: function
Default value: false
Function paramter: fullpath
在文件将要上传到又拍云或需要在又拍云上删除之前，又拍云上所存储的文件的路径都会经过此函数进行处理，也就是说可以通过此函数修改文件最终在又拍云上存储的路径。
Usage Examples
我们假设本地git仓库路径为 /data/git/repo ，配置信息如下：
grunt.initConfig({
git2upyun: {
options: {
bucketname: 'my-first-bucket', //空间名称
username: 'somebody', //操作员名称
password: 'secret', //密码
root: '/images/', //文件存储的目录，可以是 '/'
repository: '/data/git/repo', //本地仓库路径
ignore:['.*', 'README.md'], //忽略哪些文件
cleanpath: false //上传文件之前会调用此函数处理目标存储路径
}
},
});cleanpath 的用法
举例来说，本地仓库中的文件存放路径为（相对于仓库目录的路径） ajax/lig/bootstrap/bootstrap.js，root 配置为 /3rd ，如果按照默认的生成路径的方式，最终在服务器上的文件路径为 /3rd/ajax/lib/bootstrap/bootstrap.js ，但是我们希望存储的路径是 /3rd/bootstrap/bootstrap.js ，那么，就需要将 ajax/lib/ 删除掉，这是，cleanpath就能派上用场了：
cleanpath:function(fullpath) {return fullpath.replace('ajax/lib/', '');}这样就能将默认路径修改为我们需要的结果了！
实际使用案例
Bootstrap中文网所维护的开放CDN服务就是采用此Grunt插件将 cdnjs.com 的github仓库镜像到又拍云上，从而为国内用户提供更好的加速服务。
问题和解决办法
本插件采用 gift 执行对 git 仓库的操作，例如，列出仓库内管理的所有文件 git ls-files。
存在的问题
gift 在执行 git 指令时采用的是 child_process.exec api，这个api依赖 stdout 获取指令的所有输出，麻烦的是，stdout 对于输出缓存有一个 200k 的限制，比如，执行 git ls-files 时，如果仓库中的文件数量非常巨大的话（在 cdnjs 项目中就出现了这个问题，对 cdnjs 仓库执行 git ls-files 时输出的文件列表超过了 7M ，因此每次都会报错）就会超出最大缓存的限制，这个问题通过用 child_process.spawn 替代 child_process.exec 即可解决。目前已经向 gift 项目反映了此问题，应该很快可以解决。
当前的解决办法
一般项目中包含的文件不会太多，上面的问题一般不会出现。而我们在 开放CDN 中遇到的问题目前是这样解决的：第一次向云服务器上传 cdnjs 中的文件时采用的是 FTP 方式，后续在每次与 cdnjs 同步的时候，新增/删除文件的数量比较小，不会超出缓存。这样就规避了上述问题。并且，FTP 工具会有队列、续传机制。
版权和协议
本插件所有代码版权归 Bootstrap中文网 所有，遵循 MIT 开源协议。
其中，lib/upyun.js 文件中的代码归又拍云所有。