Service-Center Release¶
Release Notes¶
How to publish release documents¶
Step 1¶
Confirm what this version mainly does
https://issues.apache.org/jira/projects/SCB/issues/SCB-2270?filter=allopenissues
Step 2¶
Collect major issues
Step 3¶
Write the releaseNotes-xx.xx.xx.md
Running Apache Rat tool¶
This guide will help you to run the Apache Rat tool on service-center source code. For running the tool please follow the below guidelines.
Step 1¶
Clone the Servcice-Center code and download Apache Rat tool.
git clone https://github.com/apache/servicecomb-service-center
wget http://mirrors.tuna.tsinghua.edu.cn/apache/creadur/apache-rat-0.13/apache-rat-0.13-bin.tar.gz
# Untar the release
tar -xvf apache-rat-0.13-bin.tar.gz
# Copy the jar in the root directory
cp apache-rat-0.13/apache-rat-0.13.jar ./
Step 2¶
Run the Rat tool using the below command
java -jar apache-rat-0.13.jar -a -d servicecomb-service-center/ -e '(.+(\.svg|\.md|\.MD|\.cer|\.tpl|\.json|\.yaml|\.proto|\.pb.go))|(.gitignore|.gitmodules|ux|docs|vendor|licenses|bower.json|cert_pwd|glide.yaml|go.mod|go.sum)'
Below is the list of the files which has been excluded from the list of RAT tool.
- *.md *.MD *.html: Skip all the Readme and Documentation file like Api Docs.
- .gitignore .gitmodules .travis.yml : Skip the git files and travis file.
- manifest **vendor : Skip manifest and all the files under vendor.
- bower.json : Skip bower installation file
- cert_pwd server.cer trust.cer : Skip ssl files
- *.tpl : Ignore template files
- glide.yaml go.mod go.sum : Skip dependency config files
- docs : Skip document files
- .yaml : Skip configuration files
- ux : Skip foreground files
- .proto .pb.go : Skip proto files
You can access the latest RAT report here
Archive¶
Step 1¶
If you are doing release for the first time, you can read this document.
Execute script, archive source code and generate summary and signature
bash scripts/release/archive.sh apache-servicecomb-service-center 2.0.0 littlecui@apache.org
list current directory
-rw-rw-r-- 1 ubuntu ubuntu 3.1M Jun 8 20:35 apache-servicecomb-service-center-2.0.0-src.tar.gz
-rw-rw-r-- 1 ubuntu ubuntu 862 Jun 8 20:35 apache-servicecomb-service-center-2.0.0-src.tar.gz.asc
-rw-rw-r-- 1 ubuntu ubuntu 181 Jun 8 20:35 apache-servicecomb-service-center-2.0.0-src.tar.gz.sha512
Step 2¶
PUSH to apache dev repo
svn co https://dist.apache.org/repos/dist/dev/servicecomb/
cd servicecomb/
mkdir -p 2.0.0
cp apache-servicecomb-service-center-* 2.0.0/
svn add .
svn ci --username xxx --password xxx -m "Add the Service-Center 2.0.0 version"
Add tag¶
Step 1¶
Push new tag to repo
git clone https://github.com/apache/servicecomb-service-center.git
git tag vx.x.x
git push origin vx.x.x
Step 2¶
Edit the tag to make x.x.x version release
published content should use releaseNotes-vx.x.x.md
Step 3¶
Initiate version voting —— send email to dev@servicecomb.apache.org
mail format : use plain text
mail subject : [VOTE] Release Apache ServiceComb Service-Center version 2.1.0
mail content :
Hi all,
Please review and vote on Apache ServiceCenter 2.1.0 release.
The release candidate has been tagged in GitHub as 2.1.0, available
here:
https://github.com/apache/servicecomb-service-center/releases/tag/v2.1.0
Release Notes are here:
https://github.com/apache/servicecomb-service-center/blob/v2.1.0/docs/release/releaseNotes-2.1.0.md
Thanks to everyone who has contributed to this release.
The artifacts (source, signature and checksum) corresponding to this release
candidate can be found here:
https://dist.apache.org/repos/dist/dev/servicecomb/servicecomb-service-center/2.1.0/
This has been signed with PGP key, public KEYS file is available here:
https://dist.apache.org/repos/dist/dev/servicecomb/KEYS
To verify and build, you can refer to following wiki:
https://github.com/apache/servicecomb-service-center#building--running-service-center-from-source
The vote will be open for at least 72 hours.
[ ] +1 Approve the release
[ ] +0 No opinion
[ ] -1 Do not release this package because ...
Best Regards,
robotljw
Step 4¶
After the vote is passed, upload the release package of the relevant version
1.Edit the v.x.x.x release
2.Attach binaries by dropping them here or selecting them
apache-servicecomb-service-center-x.x.x-darwin-amd64.tar.gz
apache-servicecomb-service-center-x.x.x-linux-amd64.tar.gz
apache-servicecomb-service-center-x.x.x-windows-amd64.tar.gz