You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@shardingsphere.apache.org by do...@apache.org on 2020/07/21 06:08:43 UTC
[shardingsphere] branch master updated: Release guide for
ElasticJob (#6382)
This is an automated email from the ASF dual-hosted git repository.
dongzonglei pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/shardingsphere.git
The following commit(s) were added to refs/heads/master by this push:
new 12c141c Release guide for ElasticJob (#6382)
12c141c is described below
commit 12c141cd718a5f12d2fe62418dde49e9842fe3ed
Author: Zhang Yonglun <zh...@apache.org>
AuthorDate: Tue Jul 21 14:08:28 2020 +0800
Release guide for ElasticJob (#6382)
* add elasticjob release guide
* add elasticjob release guide
---
docs/community/content/contribute/2FA.cn.md | 2 +-
docs/community/content/contribute/2FA.en.md | 2 +-
.../{release_ui.cn.md => release-elasticjob.cn.md} | 139 ++++++++++----------
.../{release_ui.en.md => release-elasticjob.en.md} | 140 +++++++++++----------
docs/community/content/contribute/release.cn.md | 3 +-
docs/community/content/contribute/release.en.md | 2 +-
docs/community/content/contribute/release_ui.cn.md | 2 +-
docs/community/content/contribute/release_ui.en.md | 4 +-
8 files changed, 158 insertions(+), 136 deletions(-)
diff --git a/docs/community/content/contribute/2FA.cn.md b/docs/community/content/contribute/2FA.cn.md
index 77fca84..586a89f 100644
--- a/docs/community/content/contribute/2FA.cn.md
+++ b/docs/community/content/contribute/2FA.cn.md
@@ -1,6 +1,6 @@
+++
title = "2FA"
-weight = 8
+weight = 9
chapter = true
+++
diff --git a/docs/community/content/contribute/2FA.en.md b/docs/community/content/contribute/2FA.en.md
index c0aeb9c..8b2191e 100644
--- a/docs/community/content/contribute/2FA.en.md
+++ b/docs/community/content/contribute/2FA.en.md
@@ -1,6 +1,6 @@
+++
title = "2FA"
-weight = 8
+weight = 9
chapter = true
+++
diff --git a/docs/community/content/contribute/release_ui.cn.md b/docs/community/content/contribute/release-elasticjob.cn.md
similarity index 54%
copy from docs/community/content/contribute/release_ui.cn.md
copy to docs/community/content/contribute/release-elasticjob.cn.md
index d854468..31d1e94 100644
--- a/docs/community/content/contribute/release_ui.cn.md
+++ b/docs/community/content/contribute/release-elasticjob.cn.md
@@ -1,6 +1,6 @@
+++
-title = "UI发布指南"
-weight = 7
+title = "ElasticJob发布指南"
+weight = 8
chapter = true
+++
@@ -34,32 +34,33 @@ chapter = true
### 更新版本说明
+在Github主干上更新如下文件，并提交PR到主干：
+
```
-https://github.com/apache/shardingsphere-ui/blob/master/RELEASE-NOTES.md
+https://github.com/apache/shardingsphere-elasticjob/blob/master/RELEASE-NOTES.md
```
### 创建发布分支
-假设从github下载的ShardingSphere源代码在`~/shardingsphere-ui/`目录；假设即将发布的版本为`${RELEASE.VERSION}`。
-创建`${RELEASE.VERSION}-release-ui`分支，接下来的操作都在该分支进行。
+假设从github下载的ElasticJob源代码在`~/elasticjob/`目录；假设即将发布的版本为`${RELEASE.VERSION}`。
+创建`${RELEASE.VERSION}-release`分支，接下来的操作都在该分支进行。
```shell
## ${name}为源码所在分支，如：master，dev-4.x
-git clone --branch ${name} https://github.com/apache/shardingsphere-ui.git ~/shardingsphere-ui
-cd ~/shardingsphere-ui/
+git clone --branch ${name} https://github.com/apache/shardingsphere-elasticjob.git ~/elasticjob
+cd ~/elasticjob/
git pull
-git checkout -b ${RELEASE.VERSION}-release-ui
-git push origin ${RELEASE.VERSION}-release-ui
+git checkout -b ${RELEASE.VERSION}-release
+git push origin ${RELEASE.VERSION}-release
```
### 发布预校验
```shell
-cd ~/shardingsphere-ui
mvn release:prepare -Prelease -Darguments="-DskipTests" -DautoVersionSubmodules=true -DdryRun=true -Dusername=${Github用户名}
```
--Prelease: 选择release的profile，这个profile会打包所有源码、jar文件以及ShardingSphere-UI的可执行二进制包。
+-Prelease: 选择release的profile，这个profile会打包所有源码和jar文件。
-DautoVersionSubmodules=true：作用是发布过程中版本号只需要输入一次，不必为每个子模块都输入一次。
@@ -70,14 +71,12 @@ mvn release:prepare -Prelease -Darguments="-DskipTests" -DautoVersionSubmodules=
首先清理发布预校验本地信息。
```shell
-cd ~/shardingsphere-ui
mvn release:clean
```
-然后准备执行发布。
+然后准备执行发布。发布之前需要更新`examples`模块的pom，将版本由${CURRENT.VERSION}替换为${RELEASE.VERSION}。
```shell
-cd ~/shardingsphere-ui
mvn release:prepare -Prelease -Darguments="-DskipTests" -DautoVersionSubmodules=true -DpushChanges=false -Dusername=${Github用户名}
```
@@ -95,10 +94,14 @@ git push origin --tags
### 部署发布
```shell
-cd ~/shardingsphere-ui
mvn release:perform -Prelease -Darguments="-DskipTests" -DautoVersionSubmodules=true -Dusername=${Github用户名}
```
+执行完该命令后，待发布版本会自动上传到Apache的临时筹备仓库(staging repository)。
+访问https://repository.apache.org/#stagingRepositories, 使用Apache的LDAP账户登录后，就会看到上传的版本，`Repository`列的内容即为${STAGING.REPOSITORY}。
+点击`Close`来告诉Nexus这个构建已经完成，只有这样该版本才是可用的。
+如果电子签名等出现问题，`Close`会失败，可以通过`Activity`查看失败信息。
+
## 发布Apache SVN仓库
### 检出shardingsphere发布目录
@@ -130,40 +133,44 @@ gpg -a --export ${GPG用户名} >> KEYS
创建版本号目录。
```shell
-mkdir -p ~/ss_svn/dev/shardingsphere/shardingsphere-ui-${RELEASE.VERSION}
-cd ~/ss_svn/dev/shardingsphere/shardingsphere-ui-${RELEASE.VERSION}
+mkdir -p ~/ss_svn/dev/shardingsphere/elasticjob-${RELEASE.VERSION}
+cd ~/ss_svn/dev/shardingsphere/elasticjob-${RELEASE.VERSION}
```
将源码包和二进制包添加至SVN工作目录。
```shell
-cp -f ~/shardingsphere-ui/shardingsphere-ui-distribution/shardingsphere-ui-src-distribution/target/*.zip ~/ss_svn/dev/shardingsphere/shardingsphere-ui-${RELEASE.VERSION}
-cp -f ~/shardingsphere-ui/shardingsphere-ui-distribution/shardingsphere-ui-src-distribution/target/*.zip.asc ~/ss_svn/dev/shardingsphere/shardingsphere-ui-${RELEASE.VERSION}
-cp -f ~/shardingsphere-ui/shardingsphere-ui-distribution/shardingsphere-ui-bin-distribution/target/*.tar.gz ~/ss_svn/dev/shardingsphere/shardingsphere-ui-${RELEASE.VERSION}
-cp -f ~/shardingsphere-ui/shardingsphere-ui-distribution/shardingsphere-ui-bin-distribution/target/*.tar.gz.asc ~/ss_svn/dev/shardingsphere/shardingsphere-ui-${RELEASE.VERSION}
+cp -f ~/elasticjob/elasticjob-distribution/elasticjob-src-distribution/target/*.zip ~/ss_svn/dev/shardingsphere/elasticjob-${RELEASE.VERSION}
+cp -f ~/elasticjob/elasticjob-distribution/elasticjob-src-distribution/target/*.zip.asc ~/ss_svn/dev/shardingsphere/elasticjob-${RELEASE.VERSION}
+cp -f ~/elasticjob/elasticjob-distribution/elasticjob-lite-distribution/target/*.tar.gz ~/ss_svn/dev/shardingsphere/elasticjob-${RELEASE.VERSION}
+cp -f ~/elasticjob/elasticjob-distribution/elasticjob-lite-distribution/target/*.tar.gz.asc ~/ss_svn/dev/shardingsphere/elasticjob-${RELEASE.VERSION}
+cp -f ~/elasticjob/elasticjob-distribution/elasticjob-cloud-distribution/target/*.tar.gz ~/ss_svn/dev/shardingsphere/elasticjob-${RELEASE.VERSION}
+cp -f ~/elasticjob/elasticjob-distribution/elasticjob-cloud-distribution/target/*.tar.gz.asc ~/ss_svn/dev/shardingsphere/elasticjob-${RELEASE.VERSION}
```
### 生成文件签名
```shell
-shasum -a 512 apache-shardingsphere-${RELEASE.VERSION}-shardingsphere-ui-src.zip >> apache-shardingsphere-${RELEASE.VERSION}-shardingsphere-ui-src.zip.sha512
-shasum -b -a 512 apache-shardingsphere-${RELEASE.VERSION}-shardingsphere-ui-bin.tar.gz >> apache-shardingsphere-${RELEASE.VERSION}-shardingsphere-ui-bin.tar.gz.sha512
+shasum -a 512 apache-shardingsphere-elasticjob-${RELEASE.VERSION}-src.zip >> apache-shardingsphere-elasticjob-${RELEASE.VERSION}-src.zip.sha512
+shasum -b -a 512 apache-shardingsphere-elasticjob-${RELEASE.VERSION}-elasticjob-lite-bin.tar.gz >> apache-shardingsphere-elasticjob-${RELEASE.VERSION}-elasticjob-lite-bin.tar.gz.sha512
+shasum -b -a 512 apache-shardingsphere-elasticjob-${RELEASE.VERSION}-elasticjob-cloud-bin.tar.gz >> apache-shardingsphere-elasticjob-${RELEASE.VERSION}-elasticjob-cloud-bin.tar.gz.sha512
```
### 提交Apache SVN
```shell
-cd ~/ss_svn/dev/shardingsphere/
-svn add shardingsphere-ui-${RELEASE.VERSION}
-svn --username=${APACHE LDAP 用户名} commit -m "release shardingsphere-ui-${RELEASE.VERSION}"
+svn add *
+svn --username=${APACHE LDAP 用户名} commit -m "release elasticjob-${RELEASE.VERSION}"
```
+
## 检查发布结果
### 检查sha512哈希
```shell
-shasum -c apache-shardingsphere-${RELEASE.VERSION}-shardingsphere-ui-src.zip.sha512
-shasum -c apache-shardingsphere-${RELEASE.VERSION}-shardingsphere-ui-bin.tar.gz.sha512
+shasum -c apache-shardingsphere-elasticjob-${RELEASE.VERSION}-src.zip.sha512
+shasum -c apache-shardingsphere-elasticjob-${RELEASE.VERSION}-elasticjob-lite-bin.tar.gz.sha512
+shasum -c apache-shardingsphere-elasticjob-${RELEASE.VERSION}-elasticjob-cloud-bin.tar.gz.sha512
```
### 检查gpg签名
@@ -194,8 +201,9 @@ Your decision? 5
然后进行gpg签名检查。
```shell
-gpg --verify apache-shardingsphere-${RELEASE.VERSION}-shardingsphere-ui-src.zip.asc apache-shardingsphere-${RELEASE.VERSION}-shardingsphere-ui-src.zip
-gpg --verify apache-shardingsphere-${RELEASE.VERSION}-shardingsphere-ui-bin.tar.gz.asc apache-shardingsphere-${RELEASE.VERSION}-shardingsphere-ui-bin.tar.gz
+gpg --verify apache-shardingsphere-elasticjob-${RELEASE.VERSION}-src.zip.asc apache-shardingsphere-elasticjob-${RELEASE.VERSION}-src.zip
+gpg --verify apache-shardingsphere-elasticjob-${RELEASE.VERSION}-elasticjob-lite-bin.tar.gz.asc apache-shardingsphere-elasticjob-${RELEASE.VERSION}-elasticjob-lite-bin.tar.gz
+gpg --verify apache-shardingsphere-elasticjob-${RELEASE.VERSION}-elasticjob-cloud-bin.tar.gz.asc apache-shardingsphere-elasticjob-${RELEASE.VERSION}-elasticjob-cloud-bin.tar.gz
```
### 检查发布文件内容
@@ -203,10 +211,10 @@ gpg --verify apache-shardingsphere-${RELEASE.VERSION}-shardingsphere-ui-bin.tar.
#### 对比源码包与Github上tag的内容差异
```
-curl -Lo tag-shardingsphere-ui-${RELEASE.VERSION}.zip https://github.com/apache/shardingsphere-ui/archive/shardingsphere-ui-${RELEASE.VERSION}.zip
-unzip tag-shardingsphere-ui-${RELEASE.VERSION}.zip
-unzip apache-shardingsphere-${RELEASE.VERSION}-shardingsphere-ui-src.zip
-diff -r apache-shardingsphere-${RELEASE.VERSION}-shardingsphere-ui-src/ shardingsphere-shardingsphere-ui-${RELEASE.VERSION}/
+curl -Lo tag-${RELEASE.VERSION}.zip https://github.com/apache/shardingsphere-elasticjob/archive/${RELEASE.VERSION}.zip
+unzip tag-${RELEASE.VERSION}.zip
+unzip apache-shardingsphere-elasticjob-${RELEASE.VERSION}-src.zip
+diff -r apache-shardingsphere-elasticjob-${RELEASE.VERSION}-src-release shardingsphere-elasticjob-${RELEASE.VERSION}
```
#### 检查源码包的文件内容
@@ -221,7 +229,7 @@ diff -r apache-shardingsphere-${RELEASE.VERSION}-shardingsphere-ui-src/ sharding
#### 检查二进制包的文件内容
-解压缩`apache-shardingsphere-${RELEASE.VERSION}-shardingsphere-ui-bin.tar.gz`
+解压缩`apache-shardingsphere-elasticjob-${RELEASE.VERSION}-elasticjob-lite-bin.tar.gz`和`apache-shardingsphere-elasticjob-${RELEASE.VERSION}-elasticjob-cloud-bin.tar.gz`
进行如下检查:
- 存在`LICENSE`和`NOTICE`文件
@@ -249,7 +257,7 @@ diff -r apache-shardingsphere-${RELEASE.VERSION}-shardingsphere-ui-src/ sharding
标题：
```
-[VOTE] Release Apache ShardingSphere UI ${RELEASE.VERSION}
+[VOTE] Release Apache ShardingSphere ElasticJob-${RELEASE.VERSION}
```
正文：
@@ -257,25 +265,28 @@ diff -r apache-shardingsphere-${RELEASE.VERSION}-shardingsphere-ui-src/ sharding
```
Hello ShardingSphere Community,
-This is a call for vote to release Apache ShardingSphere UI version ${RELEASE.VERSION}
+This is a call for vote to release Apache ShardingSphere ElasticJob-${RELEASE.VERSION}
Release notes:
-https://github.com/apache/shardingsphere-ui/blob/master/RELEASE-NOTES.md
+https://github.com/apache/shardingsphere-elasticjob/blob/master/RELEASE-NOTES.md
The release candidates:
-https://dist.apache.org/repos/dist/dev/shardingsphere/shardingsphere-ui-${RELEASE.VERSION}/
+https://dist.apache.org/repos/dist/dev/shardingsphere/elasticjob-${RELEASE.VERSION}/
+
+Maven 2 staging repository:
+https://repository.apache.org/content/repositories/${STAGING.REPOSITORY}/org/apache/shardingsphere/
Git tag for the release:
-https://github.com/apache/shardingsphere-ui/tree/shardingsphere-ui-${RELEASE.VERSION}/
+https://github.com/apache/shardingsphere-elasticjob/tree/${RELEASE.VERSION}/
Release Commit ID:
-https://github.com/apache/shardingsphere-ui/commit/xxxxxxxxxxxxxxxxxxxxxxx
+https://github.com/apache/shardingsphere-elasticjob/commit/xxxxxxxxxxxxxxxxxxxxxxx
Keys to verify the Release Candidate:
https://dist.apache.org/repos/dist/dev/shardingsphere/KEYS
Look at here for how to verify this release candidate:
-https://shardingsphere.apache.org/community/en/contribute/release_ui/
+https://shardingsphere.apache.org/community/en/contribute/release-elasticjob/
GPG user ID:
${YOUR.GPG.USER.ID}
@@ -312,7 +323,7 @@ Checklist for reference:
正文：
```
-The vote to release Apache ShardingSphere UI ${RELEASE.VERSION} has passed.
+The vote to release Apache ShardingSphere ElasticJob-${RELEASE.VERSION} has passed.
7 PMC member +1 binding votes:
@@ -335,7 +346,7 @@ Thank you everyone for taking the time to review the release and help us.
标题：
```
-[RESULT][VOTE] Release Apache ShardingSphere UI ${RELEASE.VERSION}
+[RESULT][VOTE] Release Apache ShardingSphere ElasticJob-${RELEASE.VERSION}
```
正文：
@@ -358,33 +369,35 @@ I will process to publish the release and send ANNOUNCE.
### 将源码、二进制包以及KEYS从svn的dev目录移动到release目录
```shell
-svn mv https://dist.apache.org/repos/dist/dev/shardingsphere/shardingsphere-ui-${RELEASE.VERSION} https://dist.apache.org/repos/dist/release/shardingsphere/ -m "transfer packages for shardingsphere-ui-${RELEASE.VERSION}"
+svn mv https://dist.apache.org/repos/dist/dev/shardingsphere/elasticjob-${RELEASE.VERSION} https://dist.apache.org/repos/dist/release/shardingsphere/ -m "transfer packages for elasticjob-${RELEASE.VERSION}"
svn delete https://dist.apache.org/repos/dist/release/shardingsphere/KEYS -m "delete KEYS"
-svn cp https://dist.apache.org/repos/dist/dev/shardingsphere/KEYS https://dist.apache.org/repos/dist/release/shardingsphere/ -m "transfer KEYS for shardingsphere-ui-${RELEASE.VERSION}"
+svn cp https://dist.apache.org/repos/dist/dev/shardingsphere/KEYS https://dist.apache.org/repos/dist/release/shardingsphere/ -m "transfer KEYS for elasticjob-${RELEASE.VERSION}"
```
+### 在Apache Staging仓库找到ShardingSphere并点击`Release`
+
### 合并Github的release分支到`master`, 合并完成后删除release分支
```shell
git checkout master
-git merge origin/${RELEASE.VERSION}-release-ui
+git merge origin/${RELEASE.VERSION}-release
git push
-git push --delete origin ${RELEASE.VERSION}-release-ui
+git push --delete origin ${RELEASE.VERSION}-release
```
### 更新下载页面
-https://shardingsphere.apache.org/document/current/en/downloads/
+https://shardingsphere.apache.org/elasticjob/current/en/downloads/
-https://shardingsphere.apache.org/document/current/cn/downloads/
+https://shardingsphere.apache.org/elasticjob/current/cn/downloads/
GPG签名文件和哈希校验文件的下载连接应该使用这个前缀： `https://downloads.apache.org/shardingsphere/`
-`最新版本`中保留一个最新的版本。Incubator阶段历史版本会自动归档到[Archive repository](https://archive.apache.org/dist/incubator/shardingsphere/)
+`最新版本`中保留一个最新的版本。
### GitHub版本发布
-在[GitHub Releases](https://github.com/apache/shardingsphere-ui/releases)页面的`shardingsphere-ui-${RELEASE_VERSION}`版本上点击`Edit`
+在[GitHub Releases](https://github.com/apache/shardingsphere-elasticjob/releases)页面的`${RELEASE_VERSION}`版本上点击`Edit`
编辑版本号及版本说明，并点击`Publish release`
@@ -395,7 +408,7 @@ GPG签名文件和哈希校验文件的下载连接应该使用这个前缀： `
标题：
```
-[ANNOUNCE] Apache ShardingSphere UI ${RELEASE.VERSION} available
+[ANNOUNCE] Apache ShardingSphere ElasticJob-${RELEASE.VERSION} available
```
正文：
@@ -403,24 +416,22 @@ GPG签名文件和哈希校验文件的下载连接应该使用这个前缀： `
```
Hi all,
-Apache ShardingSphere Team is glad to announce the new release of Apache ShardingSphere UI ${RELEASE.VERSION}.
+Apache ShardingSphere Team is glad to announce the new release of Apache ShardingSphere ElasticJob-${RELEASE.VERSION}.
-ShardingSphere is an open-source ecosystem consisted of a set of distributed database middleware solutions, including 2 independent products, ShardingSphere-JDBC & ShardingSphere-Proxy.
-They both provide functions of data sharding, distributed transaction and database orchestration, applicable in a variety of situations such as Java isomorphism, heterogeneous language.
-Aiming at reasonably making full use of the computation and storage capacity of the database in a distributed system, ShardingSphere defines itself as a middleware, rather than a totally new type of database.
-As the cornerstone of many enterprises, relational database still takes a huge market share.
-Therefore, at the current stage, we prefer to focus on its increment instead of a total overturn.
+ElasticJob is a distributed scheduling solution consisting of two separate projects, ElasticJob-Lite and ElasticJob-Cloud.
+Through the functions of flexible scheduling, resource management and job management, it creates a distributed scheduling solution suitable for Internet scenarios, and provides diversified job ecosystem through open architecture design. It uses a unified job API for each project. Developers only need code one time and can deploy at will.
+ElasticJob became an Apache ShardingSphere Sub project on May 28 2020.
-Download Links: https://shardingsphere.apache.org/document/current/en/downloads/
+Download Links: https://shardingsphere.apache.org/elasticjob/current/en/downloads/
-Release Notes: https://github.com/apache/shardingsphere-ui/blob/master/RELEASE-NOTES.md
+Release Notes: https://github.com/apache/shardingsphere-elasticjob/blob/master/RELEASE-NOTES.md
-Website: https://shardingsphere.apache.org/
+Website: http://shardingsphere.apache.org/elasticjob/
ShardingSphere Resources:
-- Issue: https://github.com/apache/shardingsphere-ui/issues/
+- Issue: https://github.com/apache/shardingsphere-elasticjob/issues/
- Mailing list: dev@shardingsphere.apache.org
-- Documents: https://shardingsphere.apache.org/document/current/
+- Documents: https://shardingsphere.apache.org/elasticjob/current/en/overview/
diff --git a/docs/community/content/contribute/release_ui.en.md b/docs/community/content/contribute/release-elasticjob.en.md
similarity index 54%
copy from docs/community/content/contribute/release_ui.en.md
copy to docs/community/content/contribute/release-elasticjob.en.md
index 67bfc53..e04d593 100644
--- a/docs/community/content/contribute/release_ui.en.md
+++ b/docs/community/content/contribute/release-elasticjob.en.md
@@ -1,6 +1,6 @@
+++
-title = "Release Guide For UI"
-weight = 7
+title = "ElasticJob Release Guide"
+weight = 8
chapter = true
+++
@@ -34,32 +34,33 @@ For encryption settings, please see [here](http://maven.apache.org/guides/mini/g
### Update Release Notes
+Update the following file in master branch, and submit a PR to master branch:
+
```
-https://github.com/apache/shardingsphere-ui/blob/master/RELEASE-NOTES.md
+https://github.com/apache/shardingsphere-elasticjob/blob/master/RELEASE-NOTES.md
```
### Create Release Branch
-Suppose ShardingSphere source codes downloaded from github is under `~/shardingsphere-ui/` directory and the version to be released is `4.0.0-RC`.
-Create `${RELEASE.VERSION}-release-ui` branch, where all the following operations are performed.
+Suppose ElasticJob source codes downloaded from github is under `~/elasticjob/` directory and the version to be released is `${RELEASE.VERSION}`.
+Create `${RELEASE.VERSION}-release` branch, where all the following operations are performed.
```shell
## ${name} is the properly branch, e.g. master, dev-4.x
-git clone --branch ${name} https://github.com/apache/shardingsphere-ui.git ~/shardingsphere-ui
-cd ~/shardingsphere-ui/
+git clone --branch ${name} https://github.com/apache/shardingsphere-elasticjob.git ~/elasticjob
+cd ~/elasticjob/
git pull
-git checkout -b ${RELEASE.VERSION}-release-ui
-git push origin ${RELEASE.VERSION}-release-ui
+git checkout -b ${RELEASE.VERSION}-release
+git push origin ${RELEASE.VERSION}-release
```
### Pre-Release Check
```shell
-cd ~/shardingsphere-ui
mvn release:prepare -Prelease -Darguments="-DskipTests" -DautoVersionSubmodules=true -DdryRun=true -Dusername=${Github username}
```
--Prelease: choose release profile, which will pack all the source codes, jar files and executable binary packages of ShardingSphere-UI.
+-Prelease: choose release profile, which will pack all the source codes and jar files.
-DautoVersionSubmodules=true: it can make the version number is inputted only once and not for each sub-module.
@@ -70,14 +71,12 @@ mvn release:prepare -Prelease -Darguments="-DskipTests" -DautoVersionSubmodules=
First, clean local pre-release check information.
```shell
-cd ~/shardingsphere-ui
mvn release:clean
```
-Then, prepare to execute the release.
+Then, prepare to execute the release. Before releasing, update the POM of the module `examples`, changing the version from ${CURRENT.VERSION} to ${RELEASE.VERSION}.
```shell
-cd ~/shardingsphere-ui
mvn release:prepare -Prelease -Darguments="-DskipTests" -DautoVersionSubmodules=true -DpushChanges=false -Dusername=${Github username}
```
@@ -95,10 +94,14 @@ git push origin --tags
### Deploy the Release
```shell
-cd ~/shardingsphere-ui
mvn release:perform -Prelease -Darguments="-DskipTests" -DautoVersionSubmodules=true -Dusername=${Github username}
```
+After that command is executed, the version to be released will be uploaded to Apache staging repository automatically.
+Visit [https://repository.apache.org/#stagingRepositories](https://repository.apache.org/#stagingRepositories) and use Apache LDAP account to log in; then you can see the uploaded version, the content of `Repository` column is the ${STAGING.REPOSITORY}.
+Click `Close` to tell Nexus that the construction is finished, because only in this way, this version can be usable.
+If there is any problem in gpg signature, `Close` will fail, but you can see the failure information through `Activity`.
+
## Apache SVN Repository Release
### Checkout ShardingSphere Release Directory
@@ -131,32 +134,34 @@ gpg -a --export ${GPG username} >> KEYS
Create folder by version number.
```shell
-mkdir -p ~/ss_svn/dev/shardingsphere/shardingsphere-ui-${RELEASE.VERSION}
-cd ~/ss_svn/dev/shardingsphere/shardingsphere-ui-${RELEASE.VERSION}
+mkdir -p ~/ss_svn/dev/shardingsphere/elasticjob-${RELEASE.VERSION}
+cd ~/ss_svn/dev/shardingsphere/elasticjob-${RELEASE.VERSION}
```
-Add source code packages, binary packages and executable binary packages of ShardingSphere-Proxy to SVN working directory.
+Add source code packages and binary packages to SVN working directory.
```shell
-cp -f ~/shardingsphere-ui/shardingsphere-ui-distribution/shardingsphere-ui-src-distribution/target/*.zip ~/ss_svn/dev/shardingsphere/shardingsphere-ui-${RELEASE.VERSION}
-cp -f ~/shardingsphere-ui/shardingsphere-ui-distribution/shardingsphere-ui-src-distribution/target/*.zip.asc ~/ss_svn/dev/shardingsphere/shardingsphere-ui-${RELEASE.VERSION}
-cp -f ~/shardingsphere-ui/shardingsphere-ui-distribution/shardingsphere-ui-bin-distribution/target/*.tar.gz ~/ss_svn/dev/shardingsphere/shardingsphere-ui-${RELEASE.VERSION}
-cp -f ~/shardingsphere-ui/shardingsphere-ui-distribution/shardingsphere-ui-bin-distribution/target/*.tar.gz.asc ~/ss_svn/dev/shardingsphere/shardingsphere-ui-${RELEASE.VERSION}
+cp -f ~/elasticjob/elasticjob-distribution/elasticjob-src-distribution/target/*.zip ~/ss_svn/dev/shardingsphere/elasticjob-${RELEASE.VERSION}
+cp -f ~/elasticjob/elasticjob-distribution/elasticjob-src-distribution/target/*.zip.asc ~/ss_svn/dev/shardingsphere/elasticjob-${RELEASE.VERSION}
+cp -f ~/elasticjob/elasticjob-distribution/elasticjob-lite-distribution/target/*.tar.gz ~/ss_svn/dev/shardingsphere/elasticjob-${RELEASE.VERSION}
+cp -f ~/elasticjob/elasticjob-distribution/elasticjob-lite-distribution/target/*.tar.gz.asc ~/ss_svn/dev/shardingsphere/elasticjob-${RELEASE.VERSION}
+cp -f ~/elasticjob/elasticjob-distribution/elasticjob-cloud-distribution/target/*.tar.gz ~/ss_svn/dev/shardingsphere/elasticjob-${RELEASE.VERSION}
+cp -f ~/elasticjob/elasticjob-distribution/elasticjob-cloud-distribution/target/*.tar.gz.asc ~/ss_svn/dev/shardingsphere/elasticjob-${RELEASE.VERSION}
```
### Generate sign files
```shell
-shasum -a 512 apache-shardingsphere-${RELEASE.VERSION}-shardingsphere-ui-src.zip >> apache-shardingsphere-${RELEASE.VERSION}-shardingsphere-ui-src.zip.sha512
-shasum -b -a 512 apache-shardingsphere-${RELEASE.VERSION}-shardingsphere-ui-bin.tar.gz >> apache-shardingsphere-${RELEASE.VERSION}-shardingsphere-ui-bin.tar.gz.sha512
+shasum -a 512 apache-shardingsphere-elasticjob-${RELEASE.VERSION}-src.zip >> apache-shardingsphere-elasticjob-${RELEASE.VERSION}-src.zip.sha512
+shasum -b -a 512 apache-shardingsphere-elasticjob-${RELEASE.VERSION}-elasticjob-lite-bin.tar.gz >> apache-shardingsphere-elasticjob-${RELEASE.VERSION}-elasticjob-lite-bin.tar.gz.sha512
+shasum -b -a 512 apache-shardingsphere-elasticjob-${RELEASE.VERSION}-elasticjob-cloud-bin.tar.gz >> apache-shardingsphere-elasticjob-${RELEASE.VERSION}-elasticjob-cloud-bin.tar.gz.sha512
```
### Commit to Apache SVN
```shell
-cd ~/ss_svn/dev/shardingsphere/
-svn add shardingsphere-ui-${RELEASE.VERSION}
-svn --username=${APACHE LDAP 用户名} commit -m "release shardingsphere-ui-${RELEASE.VERSION}"
+svn add *
+svn --username=${APACHE LDAP username} commit -m "release elasticjob-${RELEASE.VERSION}"
```
## Check Release
@@ -164,8 +169,9 @@ svn --username=${APACHE LDAP 用户名} commit -m "release shardingsphere-ui-${R
### Check sha512 hash
```shell
-shasum -c apache-shardingsphere-${RELEASE.VERSION}-shardingsphere-ui-src.zip.sha512
-shasum -c apache-shardingsphere-${RELEASE.VERSION}-shardingsphere-ui-bin.tar.gz.sha512
+shasum -c apache-shardingsphere-elasticjob-${RELEASE.VERSION}-src.zip.sha512
+shasum -c apache-shardingsphere-elasticjob-${RELEASE.VERSION}-elasticjob-lite-bin.tar.gz.sha512
+shasum -c apache-shardingsphere-elasticjob-${RELEASE.VERSION}-elasticjob-cloud-bin.tar.gz.sha512
```
### Check gpg Signature
@@ -197,8 +203,9 @@ Your decision? 5
Then, check the gpg signature.
```shell
-gpg --verify apache-shardingsphere-${RELEASE.VERSION}-shardingsphere-ui-src.zip.asc apache-shardingsphere-${RELEASE.VERSION}-shardingsphere-ui-src.zip
-gpg --verify apache-shardingsphere-${RELEASE.VERSION}-shardingsphere-ui-bin.tar.gz.asc apache-shardingsphere-${RELEASE.VERSION}-shardingsphere-ui-bin.tar.gz
+gpg --verify apache-shardingsphere-elasticjob-${RELEASE.VERSION}-src.zip.asc apache-shardingsphere-elasticjob-${RELEASE.VERSION}-src.zip
+gpg --verify apache-shardingsphere-elasticjob-${RELEASE.VERSION}-elasticjob-lite-bin.tar.gz.asc apache-shardingsphere-elasticjob-${RELEASE.VERSION}-elasticjob-lite-bin.tar.gz
+gpg --verify apache-shardingsphere-elasticjob-${RELEASE.VERSION}-elasticjob-cloud-bin.tar.gz.asc apache-shardingsphere-elasticjob-${RELEASE.VERSION}-elasticjob-cloud-bin.tar.gz
```
### Check Released Files
@@ -206,10 +213,10 @@ gpg --verify apache-shardingsphere-${RELEASE.VERSION}-shardingsphere-ui-bin.tar.
#### compare release source with github tag
```
-curl -Lo tag-shardingsphere-ui-${RELEASE.VERSION}.zip https://github.com/apache/shardingsphere-ui/archive/shardingsphere-ui-${RELEASE.VERSION}.zip
-unzip tag-shardingsphere-ui-${RELEASE.VERSION}.zip
-unzip apache-shardingsphere-${RELEASE.VERSION}-shardingsphere-ui-src.zip
-diff -r apache-shardingsphere-${RELEASE.VERSION}-shardingsphere-ui-src/ shardingsphere-shardingsphere-ui-${RELEASE.VERSION}/
+curl -Lo tag-${RELEASE.VERSION}.zip https://github.com/apache/shardingsphere-elasticjob/archive/${RELEASE.VERSION}.zip
+unzip tag-${RELEASE.VERSION}.zip
+unzip apache-shardingsphere-elasticjob-${RELEASE.VERSION}-src.zip
+diff -r apache-shardingsphere-elasticjob-${RELEASE.VERSION}-src-release shardingsphere-elasticjob-${RELEASE.VERSION}
```
#### Check source package
@@ -224,7 +231,7 @@ diff -r apache-shardingsphere-${RELEASE.VERSION}-shardingsphere-ui-src/ sharding
#### Check binary packages
-Decompress `apache-shardingsphere-${RELEASE.VERSION}-shardingsphere-ui-bin.tar.gz`
+Decompress `apache-shardingsphere-elasticjob-${RELEASE.VERSION}-elasticjob-lite-bin.tar.gz` and `apache-shardingsphere-elasticjob-${RELEASE.VERSION}-elasticjob-cloud-bin.tar.gz`
to check the following items:
* `LICENSE` and `NOTICE` files exist
@@ -253,7 +260,7 @@ After at least 72 hours and with at least 3 `+1 PMC member` votes, it can come t
Title:
```
-[VOTE] Release Apache ShardingSphere UI ${RELEASE.VERSION}
+[VOTE] Release Apache ShardingSphere ElasticJob-${RELEASE.VERSION}
```
@@ -262,25 +269,28 @@ Body:
```
Hello ShardingSphere Community,
-This is a call for vote to release Apache ShardingSphere UI version ${RELEASE.VERSION}
+This is a call for vote to release Apache ShardingSphere ElasticJob-${RELEASE.VERSION}
Release notes:
-https://github.com/apache/shardingsphere-ui/blob/master/RELEASE-NOTES.md
+https://github.com/apache/shardingsphere-elasticjob/blob/master/RELEASE-NOTES.md
The release candidates:
-https://dist.apache.org/repos/dist/dev/shardingsphere/shardingsphere-ui-${RELEASE.VERSION}/
+https://dist.apache.org/repos/dist/dev/shardingsphere/elasticjob-${RELEASE.VERSION}/
+
+Maven 2 staging repository:
+https://repository.apache.org/content/repositories/${STAGING.REPOSITORY}/org/apache/shardingsphere/
Git tag for the release:
-https://github.com/apache/shardingsphere-ui/tree/shardingsphere-ui-${RELEASE.VERSION}/
+https://github.com/apache/shardingsphere-elasticjob/tree/${RELEASE.VERSION}/
Release Commit ID:
-https://github.com/apache/shardingsphere-ui/commit/xxxxxxxxxxxxxxxxxxxxxxx
+https://github.com/apache/shardingsphere-elasticjob/commit/xxxxxxxxxxxxxxxxxxxxxxx
Keys to verify the Release Candidate:
https://dist.apache.org/repos/dist/dev/shardingsphere/KEYS
Look at here for how to verify this release candidate:
-https://shardingsphere.apache.org/community/en/contribute/release_ui/
+https://shardingsphere.apache.org/community/en/contribute/release-elasticjob/
GPG user ID:
${YOUR.GPG.USER.ID}
@@ -317,7 +327,7 @@ Checklist for reference:
Body:
```
-The vote to release Apache ShardingSphere UI ${RELEASE.VERSION} has passed.
+The vote to release Apache ShardingSphere ElasticJob-${RELEASE.VERSION} has passed.
7 PMC member +1 binding votes:
@@ -342,7 +352,7 @@ Thank you everyone for taking the time to review the release and help us.
Title：
```
-[RESULT][VOTE] Release Apache ShardingSphere UI ${RELEASE.VERSION}
+[RESULT][VOTE] Release Apache ShardingSphere ElasticJob-${RELEASE.VERSION}
```
Body:
@@ -366,33 +376,35 @@ I will process to publish the release and send ANNOUNCE.
### Move source packages, binary packages and KEYS from the `dev` directory to `release` directory
```shell
-svn mv https://dist.apache.org/repos/dist/dev/shardingsphere/shardingsphere-ui-${RELEASE.VERSION} https://dist.apache.org/repos/dist/release/shardingsphere/ -m "transfer packages for shardingsphere-ui-${RELEASE.VERSION}"
+svn mv https://dist.apache.org/repos/dist/dev/shardingsphere/elasticjob-${RELEASE.VERSION} https://dist.apache.org/repos/dist/release/shardingsphere/ -m "transfer packages for elasticjob-${RELEASE.VERSION}"
svn delete https://dist.apache.org/repos/dist/release/shardingsphere/KEYS -m "delete KEYS"
-svn cp https://dist.apache.org/repos/dist/dev/shardingsphere/KEYS https://dist.apache.org/repos/dist/release/shardingsphere/ -m "transfer KEYS for shardingsphere-ui-${RELEASE.VERSION}"
+svn cp https://dist.apache.org/repos/dist/dev/shardingsphere/KEYS https://dist.apache.org/repos/dist/release/shardingsphere/ -m "transfer KEYS for elasticjob-${RELEASE.VERSION}"
```
+### Find ShardingSphere in staging repository and click `Release`
+
### Merge release branch to `master` and delete release branch on Github
```shell
git checkout master
-git merge origin/${RELEASE.VERSION}-release-ui
+git merge origin/${RELEASE.VERSION}-release
git push
-git push --delete origin ${RELEASE.VERSION}-release-ui
+git push --delete origin ${RELEASE.VERSION}-release
```
### Update the download page
-https://shardingsphere.apache.org/document/current/en/downloads/
+https://shardingsphere.apache.org/elasticjob/current/en/downloads/
-https://shardingsphere.apache.org/document/current/cn/downloads/
+https://shardingsphere.apache.org/elasticjob/current/cn/downloads/
GPG signatures and hashes (SHA* etc) should use URL start with `https://downloads.apache.org/shardingsphere/`
-Keep one latest versions in `Latest releases`. Incubating stage versions will be archived automatically in [Archive repository](https://archive.apache.org/dist/incubator/shardingsphere/)
+Keep one latest versions in `Latest releases`.
### Publish release in GitHub
-Click `Edit` in [GitHub Releases](https://github.com/apache/shardingsphere-ui/releases)'s `shardingsphere-ui-${RELEASE_VERSION}` version
+Click `Edit` in [GitHub Releases](https://github.com/apache/shardingsphere-elasticjob/releases)'s `${RELEASE_VERSION}` version
Edit version number and release notes, click `Publish release`
@@ -403,7 +415,7 @@ Announcement e-mail template:
Title:
```
-[ANNOUNCE] Apache ShardingSphere UI ${RELEASE.VERSION} available
+[ANNOUNCE] Apache ShardingSphere ElasticJob-${RELEASE.VERSION} available
```
Body:
@@ -411,24 +423,22 @@ Body:
```
Hi all,
-Apache ShardingSphere Team is glad to announce the new release of Apache ShardingSphere UI ${RELEASE.VERSION}.
+Apache ShardingSphere Team is glad to announce the new release of Apache ShardingSphere ElasticJob-${RELEASE.VERSION}.
-ShardingSphere is an open-source ecosystem consisted of a set of distributed database middleware solutions, including 2 independent products, ShardingSphere-JDBC & ShardingSphere-Proxy.
-They both provide functions of data sharding, distributed transaction and database orchestration, applicable in a variety of situations such as Java isomorphism, heterogeneous language.
-Aiming at reasonably making full use of the computation and storage capacity of the database in a distributed system, ShardingSphere defines itself as a middleware, rather than a totally new type of database.
-As the cornerstone of many enterprises, relational database still takes a huge market share.
-Therefore, at the current stage, we prefer to focus on its increment instead of a total overturn.
+ElasticJob is a distributed scheduling solution consisting of two separate projects, ElasticJob-Lite and ElasticJob-Cloud.
+Through the functions of flexible scheduling, resource management and job management, it creates a distributed scheduling solution suitable for Internet scenarios, and provides diversified job ecosystem through open architecture design. It uses a unified job API for each project. Developers only need code one time and can deploy at will.
+ElasticJob became an Apache ShardingSphere Sub project on May 28 2020.
-Download Links: https://shardingsphere.apache.org/document/current/en/downloads/
+Download Links: https://shardingsphere.apache.org/elasticjob/current/en/downloads/
-Release Notes: https://github.com/apache/shardingsphere-ui/blob/master/RELEASE-NOTES.md
+Release Notes: https://github.com/apache/shardingsphere-elasticjob/blob/master/RELEASE-NOTES.md
-Website: https://shardingsphere.apache.org/
+Website: http://shardingsphere.apache.org/elasticjob/
ShardingSphere Resources:
-- Issue: https://github.com/apache/shardingsphere-ui/issues/
+- Issue: https://github.com/apache/shardingsphere-elasticjob/issues/
- Mailing list: dev@shardingsphere.apache.org
-- Documents: https://shardingsphere.apache.org/document/current/
+- Documents: https://shardingsphere.apache.org/elasticjob/current/en/overview/
diff --git a/docs/community/content/contribute/release.cn.md b/docs/community/content/contribute/release.cn.md
index 2950086..2c7f496 100644
--- a/docs/community/content/contribute/release.cn.md
+++ b/docs/community/content/contribute/release.cn.md
@@ -1,5 +1,5 @@
+++
-title = "发布指南"
+title = "ShardingSphere发布指南"
weight = 6
chapter = true
+++
@@ -256,6 +256,7 @@ shasum -b -a 512 apache-shardingsphere-${RELEASE.VERSION}-shardingsphere-scaling
svn add *
svn --username=${APACHE LDAP 用户名} commit -m "release ${RELEASE.VERSION}"
```
+
## 检查发布结果
### 检查sha512哈希
diff --git a/docs/community/content/contribute/release.en.md b/docs/community/content/contribute/release.en.md
index 241232e..3fd027a 100644
--- a/docs/community/content/contribute/release.en.md
+++ b/docs/community/content/contribute/release.en.md
@@ -1,5 +1,5 @@
+++
-title = "Release Guide"
+title = "ShardingSphere Release Guide"
weight = 6
chapter = true
+++
diff --git a/docs/community/content/contribute/release_ui.cn.md b/docs/community/content/contribute/release_ui.cn.md
index d854468..684dded 100644
--- a/docs/community/content/contribute/release_ui.cn.md
+++ b/docs/community/content/contribute/release_ui.cn.md
@@ -1,5 +1,5 @@
+++
-title = "UI发布指南"
+title = "ShardingSphere-UI发布指南"
weight = 7
chapter = true
+++
diff --git a/docs/community/content/contribute/release_ui.en.md b/docs/community/content/contribute/release_ui.en.md
index 67bfc53..efca471 100644
--- a/docs/community/content/contribute/release_ui.en.md
+++ b/docs/community/content/contribute/release_ui.en.md
@@ -1,5 +1,5 @@
+++
-title = "Release Guide For UI"
+title = "ShardingSphere-UI Release Guide"
weight = 7
chapter = true
+++
@@ -40,7 +40,7 @@ https://github.com/apache/shardingsphere-ui/blob/master/RELEASE-NOTES.md
### Create Release Branch
-Suppose ShardingSphere source codes downloaded from github is under `~/shardingsphere-ui/` directory and the version to be released is `4.0.0-RC`.
+Suppose ShardingSphere source codes downloaded from github is under `~/shardingsphere-ui/` directory and the version to be released is `${RELEASE.VERSION}`.
Create `${RELEASE.VERSION}-release-ui` branch, where all the following operations are performed.
```shell