Service-Center Release

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


Make a release

See 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