You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@dubbo.apache.org by mi...@apache.org on 2019/03/08 08:44:29 UTC
[incubator-dubbo-website] branch asf-site updated: add release
announce template & download verify
This is an automated email from the ASF dual-hosted git repository.
min pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/incubator-dubbo-website.git
The following commit(s) were added to refs/heads/asf-site by this push:
new d104ede add release announce template & download verify
d104ede is described below
commit d104ede7bbaa24df35f2bb7d017b3460fb6dc4c5
Author: nzomkxia <z8...@gmail.com>
AuthorDate: Fri Mar 8 16:44:32 2019 +0800
add release announce template & download verify
---
blog/en-us/download.md | 3 ++
blog/en-us/prepare-an-apache-release.md | 38 ++++++++++++++++-
blog/zh-cn/download.md | 4 ++
blog/zh-cn/prepare-an-apache-release.md | 39 +++++++++++++++++-
.../committer-guide/release-guide_dev.md | 42 +++++++++++++++++--
.../committer-guide/release-guide_dev.md | 47 ++++++++++++++++++++--
6 files changed, 163 insertions(+), 10 deletions(-)
diff --git a/blog/en-us/download.md b/blog/en-us/download.md
index 8f39a8b..3163a03 100644
--- a/blog/en-us/download.md
+++ b/blog/en-us/download.md
@@ -1,5 +1,8 @@
# Downloads
+## Verification
+
+you can follow these [procedures](https://www.apache.org/info/verification) and the [KEYS](https://dist.apache.org/repos/dist/release/incubator/dubbo/KEYS) file to verify the download files
## [Dubbo-RPC](https://github.com/apache/incubator-dubbo)
diff --git a/blog/en-us/prepare-an-apache-release.md b/blog/en-us/prepare-an-apache-release.md
index 80f032a..b3ca9ee 100644
--- a/blog/en-us/prepare-an-apache-release.md
+++ b/blog/en-us/prepare-an-apache-release.md
@@ -184,7 +184,6 @@ modifications and taggings related to ${release_version} Release Candidates are
```
> If you are promted to input password for pushing to GitHub (basically including adding new commits and tags), do not input your login password of GitHub. Use `Personal access tokens` instead. You can go to https://github.com/settings/profile, click `Developer settings` -> `Personal access tokens`, and generate a new token if not. Please refer to this [guide](https://help.github.com/articles/creating-a-personal-access-token-for-the-command-line/) for more infomation.
- > 这里有一点要注意的是tag， 在执行过程中，需要选择发布的artifactId, 下一个版本artifactId以及发布版本的tag, tag默认的是dubbo-parent-xxxx，需要改成dubbo-xxxx
> you need to choose the release artifactId, next artifactId and the release tag, the default tag is dubbo-parent-xxxx, you need to change it to dubbo-xxxx
@@ -462,7 +461,42 @@ When the release vote has passed,
6. Update the recommend dependency on [Github](https://github.com/apache/incubator-dubbo#maven-dependency) to the latest version, also update the version in other place if necessary.
7. Add the download link to official website http://dubbo.apache.org/en-us/blog/download.html, using the ASF mirror system. The latest release download link should be something like [this](https://www.apache.org/dyn/closer.cgi?path=incubator/dubbo/$VERSION/apache-dubbo-incubating-$VERSION-source-release.zip). The download link for the previous release version should be changed like [this](https://archive.apache.org/dist/incubator/dubbo/$VERSION/apache-dubbo-incubating-$VERSION-bin-releas [...]
8. Make sure all the commits in the release branch are merged into master branch, and then remove the remote release branch. For example: `git push origin --delete 2.7.0-release`
-9. Send mail to dev@dubbo.apache.org and general@incubator.apache.org, notify the community that the release is completed, you need to add disclaimer part at the end of announce email, the content is the project DISCLAIMER file.
+9. Send mail to dev@dubbo.apache.org and general@incubator.apache.org, notify the community that the release is completed.
+The mail template to announce release:
+```text
+Hello Community,
+
+The Apache Dubbo(incubating) team is pleased to announce that the
+2.6.6 has just been released.
+
+Apache Dubbo™ (incubating) is a high-performance, java based, open source
+RPC framework. Dubbo offers three key functionalities, which include
+interface based remote call, fault tolerance & load balancing, and
+automatic service registration & discovery.
+
+Both the source release[1] and the maven binary release[2] are available
+now, you can also find the detailed release notes in here[3].
+
+
+If you have any usage questions, or have problems when upgrading or find
+any problems about enhancements included in this release, please don’t
+hesitate to let us know by sending feedback to this mailing list or filing
+an issue on GitHub[4].
+
+
+
+=====
+*Disclaimer*
+
+Apache Dubbo is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet [...]
+
+
+[1] http://dubbo.apache.org/en-us/blog/download.html
+[2] http://central.maven.org/maven2/com/alibaba/dubbo
+[3] https://github.com/apache/incubator-dubbo/releases
+[4] https://github.com/apache/incubator-dubbo/issues
+
+```
## Complete Maven Convenient Binary release
diff --git a/blog/zh-cn/download.md b/blog/zh-cn/download.md
index 65d1915..8013c39 100644
--- a/blog/zh-cn/download.md
+++ b/blog/zh-cn/download.md
@@ -1,5 +1,9 @@
# 下载中心
+## 验证
+
+可以按照这里的[步骤](https://www.apache.org/info/verification), 利用[KEYS](https://dist.apache.org/repos/dist/release/incubator/dubbo/KEYS)文件来验证下载。
+
## 版本与升级
请点击了解各[版本详情和升级注意事项](http://dubbo.apache.org/zh-cn/docs/user/versions/index.html)
diff --git a/blog/zh-cn/prepare-an-apache-release.md b/blog/zh-cn/prepare-an-apache-release.md
index e2c64bf..2ef23a6 100644
--- a/blog/zh-cn/prepare-an-apache-release.md
+++ b/blog/zh-cn/prepare-an-apache-release.md
@@ -439,7 +439,44 @@ The Apache Dubbo (Incubating) Team
5. 修改GitHub的Readme文件，将版本号更新到最新发布的版本
6. 在官网下载[页面](http://dubbo.apache.org/en-us/blog/download.html)上添加最新版本的下载链接。最新的下载链接应该类似[这样](https://www.apache.org/dyn/closer.cgi?path=incubator/dubbo/$VERSION/apache-dubbo-incubating-$VERSION-source-release.zip). 同时更新以前版本的下载链接，改为类似[这样](https://archive.apache.org/dist/incubator/dubbo/$VERSION/apache-dubbo-incubating-$VERSION-bin-release.zip). 具体可以参考过往的[下载链接](https://github.com/apache/incubator-dubbo-website/blob/asf-site/blog/en-us/download.md)
7. 合并`${release-version}-release`分支到对应的主干分支， 然后删除相应的release分支，例如: `git push origin --delete 2.7.0-release`
-8. 发邮件到 `dev@dubbo.apache.org` 和 `general@incubator.apache.org`，通知社区发布完成, 邮件的最后要加上一段Disclaimer,内容就是发布项目的DISCLAIMEWR文件。
+8. 发邮件到 `dev@dubbo.apache.org` 和 `general@incubator.apache.org`
+宣布release邮件模板：
+
+```text
+Hello Community,
+
+The Apache Dubbo(incubating) team is pleased to announce that the
+2.6.6 has just been released.
+
+Apache Dubbo™ (incubating) is a high-performance, java based, open source
+RPC framework. Dubbo offers three key functionalities, which include
+interface based remote call, fault tolerance & load balancing, and
+automatic service registration & discovery.
+
+Both the source release[1] and the maven binary release[2] are available
+now, you can also find the detailed release notes in here[3].
+
+
+If you have any usage questions, or have problems when upgrading or find
+any problems about enhancements included in this release, please don’t
+hesitate to let us know by sending feedback to this mailing list or filing
+an issue on GitHub[4].
+
+
+
+=====
+*Disclaimer*
+
+Apache Dubbo is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet [...]
+
+
+[1] http://dubbo.apache.org/en-us/blog/download.html
+[2] http://central.maven.org/maven2/com/alibaba/dubbo
+[3] https://github.com/apache/incubator-dubbo/releases
+[4] https://github.com/apache/incubator-dubbo/issues
+
+```
+
## 完成Maven Convenient Binary发布（可选）
diff --git a/docs/en-us/developers/committer-guide/release-guide_dev.md b/docs/en-us/developers/committer-guide/release-guide_dev.md
index 754aa5a..b3ca9ee 100644
--- a/docs/en-us/developers/committer-guide/release-guide_dev.md
+++ b/docs/en-us/developers/committer-guide/release-guide_dev.md
@@ -1,9 +1,9 @@
---
-title: Release Guide
+title: Understanding the Apache Release Cycle
keywords: Dubbo, Apache, Release
---
-## Release Guide
+## Understanding the Apache Release Cycle
In general, Source Release is the key and the required content of Apache. But Binary Release is optional, Dubbo can choose whether to release binary packages to the Apache repository or to the Maven central repository.
@@ -184,6 +184,7 @@ modifications and taggings related to ${release_version} Release Candidates are
```
> If you are promted to input password for pushing to GitHub (basically including adding new commits and tags), do not input your login password of GitHub. Use `Personal access tokens` instead. You can go to https://github.com/settings/profile, click `Developer settings` -> `Personal access tokens`, and generate a new token if not. Please refer to this [guide](https://help.github.com/articles/creating-a-personal-access-token-for-the-command-line/) for more infomation.
+ > you need to choose the release artifactId, next artifactId and the release tag, the default tag is dubbo-parent-xxxx, you need to change it to dubbo-xxxx
After executing the above commands, you will find that:
@@ -460,7 +461,42 @@ When the release vote has passed,
6. Update the recommend dependency on [Github](https://github.com/apache/incubator-dubbo#maven-dependency) to the latest version, also update the version in other place if necessary.
7. Add the download link to official website http://dubbo.apache.org/en-us/blog/download.html, using the ASF mirror system. The latest release download link should be something like [this](https://www.apache.org/dyn/closer.cgi?path=incubator/dubbo/$VERSION/apache-dubbo-incubating-$VERSION-source-release.zip). The download link for the previous release version should be changed like [this](https://archive.apache.org/dist/incubator/dubbo/$VERSION/apache-dubbo-incubating-$VERSION-bin-releas [...]
8. Make sure all the commits in the release branch are merged into master branch, and then remove the remote release branch. For example: `git push origin --delete 2.7.0-release`
-9. Send mail to dev@dubbo.apache.org and general@incubator.apache.org, notify the community that the release is completed.
+9. Send mail to dev@dubbo.apache.org and general@incubator.apache.org, notify the community that the release is completed.
+The mail template to announce release:
+```text
+Hello Community,
+
+The Apache Dubbo(incubating) team is pleased to announce that the
+2.6.6 has just been released.
+
+Apache Dubbo™ (incubating) is a high-performance, java based, open source
+RPC framework. Dubbo offers three key functionalities, which include
+interface based remote call, fault tolerance & load balancing, and
+automatic service registration & discovery.
+
+Both the source release[1] and the maven binary release[2] are available
+now, you can also find the detailed release notes in here[3].
+
+
+If you have any usage questions, or have problems when upgrading or find
+any problems about enhancements included in this release, please don’t
+hesitate to let us know by sending feedback to this mailing list or filing
+an issue on GitHub[4].
+
+
+
+=====
+*Disclaimer*
+
+Apache Dubbo is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet [...]
+
+
+[1] http://dubbo.apache.org/en-us/blog/download.html
+[2] http://central.maven.org/maven2/com/alibaba/dubbo
+[3] https://github.com/apache/incubator-dubbo/releases
+[4] https://github.com/apache/incubator-dubbo/issues
+
+```
## Complete Maven Convenient Binary release
diff --git a/docs/zh-cn/developers/committer-guide/release-guide_dev.md b/docs/zh-cn/developers/committer-guide/release-guide_dev.md
index b4768a9..2ef23a6 100644
--- a/docs/zh-cn/developers/committer-guide/release-guide_dev.md
+++ b/docs/zh-cn/developers/committer-guide/release-guide_dev.md
@@ -1,9 +1,9 @@
---
-title: 版本发布向导
+title: 如何准备Apache Release
keywords: Dubbo, Apache, Release
---
-# 版本发布向导
+# 如何准备Apache Release
## 理解Apache发布的内容和流程
@@ -172,6 +172,8 @@ $ mvn release:prepare -Prelease -Darguments="-DskipTests" -DautoVersionSubmodule
> 执行release插件时，如果指定了`-DpushChanges=true`, 插件会自动提交到远端的GitHub仓库中，此时就需要输入GitHub的密码，注意不是输入web页面的登录密码，而是一个`Personal access tokens`，获取方式详见[这里](https://help.github.com/articles/creating-a-personal-access-token-for-the-command-line)
+> 这里有一点要注意的是tag， 在执行过程中，需要选择发布的artifactId, 下一个版本artifactId以及发布版本的tag, tag默认的是dubbo-parent-xxxx，需要改成dubbo-xxxx
+
执行完上述步骤后，你会发现：
1. `source-release.zip` 和 `bin-release.zip`包已经生成在`dubbo-distribution`目录下，请解压并检查文件是否完整
2. 本地已经打出相应的tag，同时新增一个commit，名叫`[maven-release-plugin] prepare release dubbo-x.x.x`
@@ -303,7 +305,7 @@ gpg --verify apache-dubbo-incubating-2.6.3-bin-release.zip.asc apache-dubbo-incu
```
- Release candidates match with corresponding tags, you can find tag link and hash in vote email.
- check the version number in pom.xml are the same
- - check there are no extra files or directories in the source package, for example, no empty directories or useless log files.
+ - check there are no extra files or directories in the source package, for example, no empty directories or useless log files，这里需要注意换行符是否一致
`diff -r a rc_dir tag_dir`
- check the top n tag commits, dive into the related files and check if the source package has the same changes
@@ -437,7 +439,44 @@ The Apache Dubbo (Incubating) Team
5. 修改GitHub的Readme文件，将版本号更新到最新发布的版本
6. 在官网下载[页面](http://dubbo.apache.org/en-us/blog/download.html)上添加最新版本的下载链接。最新的下载链接应该类似[这样](https://www.apache.org/dyn/closer.cgi?path=incubator/dubbo/$VERSION/apache-dubbo-incubating-$VERSION-source-release.zip). 同时更新以前版本的下载链接，改为类似[这样](https://archive.apache.org/dist/incubator/dubbo/$VERSION/apache-dubbo-incubating-$VERSION-bin-release.zip). 具体可以参考过往的[下载链接](https://github.com/apache/incubator-dubbo-website/blob/asf-site/blog/en-us/download.md)
7. 合并`${release-version}-release`分支到对应的主干分支， 然后删除相应的release分支，例如: `git push origin --delete 2.7.0-release`
-8. 发邮件到 `dev@dubbo.apache.org` 和 `general@incubator.apache.org`，通知社区发布完成。
+8. 发邮件到 `dev@dubbo.apache.org` 和 `general@incubator.apache.org`
+宣布release邮件模板：
+
+```text
+Hello Community,
+
+The Apache Dubbo(incubating) team is pleased to announce that the
+2.6.6 has just been released.
+
+Apache Dubbo™ (incubating) is a high-performance, java based, open source
+RPC framework. Dubbo offers three key functionalities, which include
+interface based remote call, fault tolerance & load balancing, and
+automatic service registration & discovery.
+
+Both the source release[1] and the maven binary release[2] are available
+now, you can also find the detailed release notes in here[3].
+
+
+If you have any usage questions, or have problems when upgrading or find
+any problems about enhancements included in this release, please don’t
+hesitate to let us know by sending feedback to this mailing list or filing
+an issue on GitHub[4].
+
+
+
+=====
+*Disclaimer*
+
+Apache Dubbo is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet [...]
+
+
+[1] http://dubbo.apache.org/en-us/blog/download.html
+[2] http://central.maven.org/maven2/com/alibaba/dubbo
+[3] https://github.com/apache/incubator-dubbo/releases
+[4] https://github.com/apache/incubator-dubbo/issues
+
+```
+
## 完成Maven Convenient Binary发布（可选）