Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
PaddlePaddle
FluidDoc
提交
c93fe539
F
FluidDoc
项目概览
PaddlePaddle
/
FluidDoc
通知
5
Star
2
Fork
0
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
23
列表
看板
标记
里程碑
合并请求
111
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
F
FluidDoc
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
23
Issue
23
列表
看板
标记
里程碑
合并请求
111
合并请求
111
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
未验证
提交
c93fe539
编写于
11月 19, 2018
作者:
C
Cheerego
提交者:
GitHub
11月 19, 2018
浏览文件
操作
浏览文件
下载
差异文件
Merge pull request #354 from PaddlePaddle/shanyi15-patch-2
upload releasing_process.md
上级
9bc35101
a7a77cc1
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
68 addition
and
0 deletion
+68
-0
doc/fluid/design/others/releasing_process.md
doc/fluid/design/others/releasing_process.md
+68
-0
未找到文件。
doc/fluid/design/others/releasing_process.md
0 → 100644
浏览文件 @
c93fe539
# PaddlePaddle发行规范
PaddlePaddle使用git-flow branching model做分支管理,使用
[
Semantic Versioning
](
http://semver.org/
)
标准表示PaddlePaddle版本号。
PaddlePaddle每次发新的版本,遵循以下流程:
1.
从
`develop`
分支派生出新的分支,分支名为
`release/版本号`
。例如,
`release/0.10.0`
1.
将新分支的版本打上tag,tag为
`版本号rc.Patch号`
。第一个tag为
`0.10.0rc1`
,第二个为
`0.10.0rc2`
,依次类推。
1.
对这个版本的提交,做如下几个操作:
*
修改
`python/setup.py.in`
中的版本信息,并将
`istaged`
字段设为
`True`
。
*
编译这个版本的Docker发行镜像,发布到dockerhub。如果失败,修复Docker编译镜像问题,Patch号加一,返回第二步
*
编译这个版本的Ubuntu Deb包。如果失败,修复Ubuntu Deb包编译问题,Patch号加一,返回第二步。
*
使用Regression Test List作为检查列表,测试Docker镜像/ubuntu安装包的功能正确性
*
如果失败,记录下所有失败的例子,在这个
`release/版本号`
分支中,修复所有bug后,Patch号加一,返回第二步
*
编译这个版本的python wheel包,并发布到pypi。
*
由于pypi.python.org目前遵循
[
严格的命名规范PEP 513
](
https://www.python.org/dev/peps/pep-0513
)
,在使用twine上传之前,需要重命名wheel包中platform相关的后缀,比如将
`linux_x86_64`
修改成
`manylinux1_x86_64`
。
*
pypi上的package名称为paddlepaddle和paddlepaddle_gpu,如果要上传GPU版本的包,需要修改build/python/setup.py中,name: "paddlepaddle_gpu"并重新打包wheel包:
`python setup.py bdist_wheel`
。
*
上传方法:
```
cd build/python
pip install twine
twine upload dist/[package to upload]
```
1.
第三步完成后,将
`release/版本号`
分支合入master分支,并删除
`release/版本号`
分支。将master分支的合入commit打上tag,tag为
`版本号`
。同时再将
`master`
分支合入
`develop`
分支。最后删除
`release/版本号`
分支。
1.
编译master分支的Docker发行镜像,发布到dockerhub。编译ubuntu的deb包,发布到github release页面
1.
协同完成Release Note的书写
需要注意的是:
*
`release/版本号`
分支一旦建立,一般不允许再从
`develop`
分支合入
`release/版本号`
。这样保证
`release/版本号`
分支功能的封闭,方便测试人员测试PaddlePaddle的行为。
*
在
`release/版本号`
分支存在的时候,如果有bugfix的行为,需要将bugfix的分支同时merge到
`master`
,
`develop`
和
`release/版本号`
这三个分支。
## PaddlePaddle 分支规范
PaddlePaddle开发过程使用
[
git-flow
](
http://nvie.com/posts/a-successful-git-branching-model/
)
分支规范,并适应github的特性做了一些区别。
*
PaddlePaddle的主版本库遵循
[
git-flow
](
http://nvie.com/posts/a-successful-git-branching-model/
)
分支规范。其中:
*
`master`
分支为稳定(stable branch)版本分支。每一个
`master`
分支的版本都是经过单元测试和回归测试的版本。
*
`develop`
分支为开发(develop branch)版本分支。每一个
`develop`
分支的版本都经过单元测试,但并没有经过回归测试。
*
`release/版本号`
分支为每一次Release时建立的临时分支。在这个阶段的代码正在经历回归测试。
*
其他用户的fork版本库并不需要严格遵守
[
git-flow
](
http://nvie.com/posts/a-successful-git-branching-model/
)
分支规范,但所有fork的版本库的所有分支都相当于特性分支。
*
建议,开发者fork的版本库使用
`develop`
分支同步主版本库的
`develop`
分支
*
建议,开发者fork的版本库中,再基于
`develop`
版本fork出自己的功能分支。
*
当功能分支开发完毕后,向PaddlePaddle的主版本库提交
`Pull Reuqest`
,进而进行代码评审。
*
在评审过程中,开发者修改自己的代码,可以继续在自己的功能分支提交代码。
*
BugFix分支也是在开发者自己的fork版本库维护,与功能分支不同的是,BugFix分支需要分别给主版本库的
`master`
、
`develop`
与可能有的
`release/版本号`
分支,同时提起
`Pull Request`
。
## PaddlePaddle回归测试列表
本列表说明PaddlePaddle发版之前需要测试的功能点。
### PaddlePaddle Book中所有章节
PaddlePaddle每次发版本首先要保证PaddlePaddle Book中所有章节功能的正确性。功能的正确性包括验证PaddlePaddle目前的
`paddle_trainer`
训练和纯使用
`Python`
训练模型正确性。
| | 新手入门章节 | 识别数字 | 图像分类 | 词向量 | 情感分析 | 语意角色标注 | 机器翻译 | 个性化推荐 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| API.V2 + Docker + GPU | | | | | | | | |
| API.V2 + Docker + CPU | | | | | | | | |
|
`paddle_trainer`
+ Docker + GPU | | | | | | | | |
|
`paddle_trainer`
+ Docker + CPU | | | | | | | | |
| API.V2 + Ubuntu + GPU | | | | | | | | |
| API.V2 + Ubuntu + CPU | | | | | | | | |
|
`paddle_trainer`
+ Ubuntu + GPU | | | | | | | | |
|
`paddle_trainer`
+ Ubuntu + CPU | | | | | | | | |
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录