You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@skywalking.apache.org by wu...@apache.org on 2018/03/19 02:26:42 UTC
[incubator-skywalking] branch asf/5.0-alpha/release updated: Update
docs and source release.
This is an automated email from the ASF dual-hosted git repository.
wusheng pushed a commit to branch asf/5.0-alpha/release
in repository https://gitbox.apache.org/repos/asf/incubator-skywalking.git
The following commit(s) were added to refs/heads/asf/5.0-alpha/release by this push:
new 77341be Update docs and source release.
77341be is described below
commit 77341be28c35b503330946028a6928b06cfd47cf
Author: wu-sheng <wu...@foxmail.com>
AuthorDate: Mon Mar 19 10:26:12 2018 +0800
Update docs and source release.
---
docs/en/How-to-release.md | 44 +++++++++++++++++++++-----------
tools/releasing/create_source_release.sh | 2 +-
2 files changed, 30 insertions(+), 16 deletions(-)
diff --git a/docs/en/How-to-release.md b/docs/en/How-to-release.md
index 70053f1..1c3496a 100644
--- a/docs/en/How-to-release.md
+++ b/docs/en/How-to-release.md
@@ -1,10 +1,10 @@
Apache SkyWalking release guide
--------------------
-This documents guide every committer to release SkyWalking in Apache Way,
+This document guides every committer to release SkyWalking in Apache Way,
and also help committers to check the release for vote.
-## SETUP YOUR DEVELOPMENT ENVIRONMENT
+## Setup your development environment
Use the following block as a template and place it in ~/.m2/settings.xml
```
@@ -28,32 +28,46 @@ Use the following block as a template and place it in ~/.m2/settings.xml
</settings>
```
-## TEST YOUR SETTINGS
+## Test your settings
```
mvn clean install -Papache-release (this will build artifacts, sources and sign)
```
-## PREPARE THE RELEASE
+## Prepare the release
```
mvn release:clean
mvn release:prepare
```
-## STAGE THE RELEASE FOR A VOTE
+## Stage the release for a vote
```
mvn release:perform
```
The release will automatically be inserted into a temporary staging repository for you.
-## Build the source code package
-TODO
+## Build and sign the source code package
+```shell
+cd tools/releasing
+sh create_source_release.sh
+```
-## Sign the distribution and source code package
-TODO
+The `apache-skywalking-apm-incubating-x.y.z-src.tgz` should be found in `tools/releasing` folder,
+with .asc, .sha512, .md5
+
+## Find and download distribution in Apache Nexus Staging repositories
+1. Use ApacheId to login `https://repository.apache.org/`
+1. Go to `https://repository.apache.org/#stagingRepositories`
+1. Search `skywalking` and find your staging repository
+1. Close the repository and wait for all checks pass.
+1. Go to `{REPO_URL}/org/apache/skywalking/apache-skywalking-apm-incubating/x.y.z`
+1. Download `.tar.gz` and `.zip` with .asc and .sha1
-## Upload to Apache svn
-TODO
+## Upload to Apache svn
+1. Use ApacheId to login `https://dist.apache.org/repos/dist/dev/incubator/skywalking/`
+1. Create folder, named by release version
+1. Upload Source code and distribution package (apache-skywalking-incubating-x.y.z.src.tar.gz, apache-skywalking-incubating-x.y.z.tar.gz, apache-skywalking-incubating-x.y.z.zip)
+`in svn.apache.org` with .asc, .sha512, .sha256
## Make the internal announcements
Send an announcement mail in dev mail list.
@@ -101,8 +115,8 @@ within the next couple of days.
```
## Wait at least 48 hours for test responses
-Any PPMC, committer or contributor can test features and visualization this version, and feedback.
-PPMC will decide whether start a vote.
+Any PPMC, committer or contributor can test features for releasing, and feedback.
+Based on that, PPMC will decide whether start a vote.
## Call a vote in dev
Call a vote in `dev@skywalking.apache.org`
@@ -157,8 +171,8 @@ All PPMC members and committers should check these before vote +1.
`in svn.apache.org` with .asc, .sha512, .sha256
1. `LICENSE` and `NOTICE` are in Source code and distribution package.
1. Check `shasum`
-1. Build distribution from source code package (apache-skywalking-incubating-x.y.z.src.tar.gz)
-1. Apache RAT check.
+1. Build distribution from source code package (apache-skywalking-incubating-x.y.z.src.tar.gz) by following this [doc](https://github.com/apache/incubator-skywalking/blob/master/docs/en/How-to-build.md#build-from-apache-source-codes).
+1. Apache RAT check. Run `mvn apache-rat:check`.
## Call for a vote in Apache IPMC
Call a vote in `general@incubator.apache.org`
\ No newline at end of file
diff --git a/tools/releasing/create_source_release.sh b/tools/releasing/create_source_release.sh
index a08f700..1ef962e 100755
--- a/tools/releasing/create_source_release.sh
+++ b/tools/releasing/create_source_release.sh
@@ -48,4 +48,4 @@ tar czf ${PRODUCT_NAME}-src.tgz ${PRODUCT_NAME}
gpg --armor --detach-sig $PRODUCT_NAME-src.tgz
md5 -r $PRODUCT_NAME-src.tgz > $PRODUCT_NAME-src.tgz.md5
-shasum -a 512 $PRODUCT_NAME-src.tgz > $PRODUCT_NAME-src.tgz.sha
+shasum -a 512 $PRODUCT_NAME-src.tgz > $PRODUCT_NAME-src.tgz.sha512
--
To stop receiving notification emails like this one, please contact
wusheng@apache.org.