01.how_to_release_paddle.md 1.7 KB
Newer Older
Y
Yu Yang 已提交
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22
# Paddle发行规范

Paddle使用[git-flow](./02.paddle_branching_model.md) branching model做分支管理,使用[Semantic Versioning](http://semver.org/)标准表示Paddle版本号。

Paddle每次发新的版本,遵循以下流程:

1.`develop`分支派生出新的分支,分支名为`版本号rc`。例如,`0.10.0rc`
2. 将新分支的版本打上tag,tag为`版本号rc.Patch号`。第一个tag为`0.10.0rc0`,第二个为`0.10.0rc1`,依次类推。
3. 对这个版本的提交,做如下几个操作:
	* 编译这个版本的Docker发行镜像,发布到dockerhub。如果失败,Patch号加一,返回第二步
	* 编译这个版本的Ubuntu Deb包。如果失败,Patch号加一,返回第二步。
	* 使用[Regression Test List](./03.regression_test_list.md)作为检查列表,测试Docker镜像/ubuntu安装包的功能正确性
		* 如果失败,记录下所有失败的例子,在这个`rc`分支中,修复所有bug后,Patch号加一,返回第二步
4. 第三步完成后,将`rc`分支合入master分支,并删除`rc`分支。将master分支的合入commit打上tag,tag为`版本号`。同时再将`master`分支合入`develop`分支。最后删除`rc`分支。
5. 编译master分支的Docker发行镜像,发布到dockerhub。编译ubuntu的deb包,发布到github release页面
6. 协同完成Release Note的书写


需要注意的是:

* `rc`分支一旦建立,一般不允许再从`develop`分支合入`rc`。这样保证`rc`分支功能的封闭,方便测试人员测试Paddle的行为。
*`rc`分支存在的时候,如果有bugfix的行为,需要将bugfix的分支同时merge到`master`, `develop``rc`这三个分支。