This documentation guides the release manager to release the SkyWalking CLI in the Apache Way, and also helps people to check the release for vote.
Upload your GPG public key to a public GPG site, such as MIT's site.
Log in id.apache.org and submit your key fingerprint.
Add your GPG public key into SkyWalking GPG KEYS file, you can do this only if you are a PMC member. You can ask a PMC member for help. DO NOT override the existed KEYS
file content, only append your key at the end of the file.
export VERSION=<the version to release> git clone --recurse-submodules git@github.com:apache/skywalking-cli && cd skywalking-cli git tag -a "$VERSION" -m "Release Apache SkyWalking-CLI $VERSION" git push --tags make clean && make release
The skywalking-cli-${VERSION}-bin.tgz
, skywalking-cli-${VERSION}-src.tgz
, and their corresponding asc
, sha512
. In total, six files should be automatically generated in the directory.
svn co https://dist.apache.org/repos/dist/dev/skywalking/ mkdir -p skywalking/cli/"$VERSION" cp skywalking-cli/skywalking*.tgz skywalking/cli/"$VERSION" cp skywalking-cli/skywalking*.tgz.asc skywalking/cli/"$VERSION" cp skywalking-cli/skywalking-cli*.tgz.sha512 skywalking/cli/"$VERSION" cd skywalking/cli && svn add "$VERSION" && svn commit -m "Draft Apache SkyWalking-CLI release $VERSION"
Send an announcement email to dev@ mailing list.
Subject: [ANNOUNCEMENT] SkyWalking CLi $VERSION test build available Content: The test build of SkyWalking CLI $VERSION is now available. We welcome any comments you may have, and will take all feedback into account if a quality vote is called for this build. Release notes: * https://github.com/apache/skywalking-cli/blob/v$VERSION/CHANGES.md Release Candidate: * https://dist.apache.org/repos/dist/dev/skywalking/cli/$VERSION * sha512 checksums - sha512xxxxyyyzzz apache-skywalking-cli-bin-x.x.x.tgz - sha512xxxxyyyzzz apache-skywalking-cli-src-x.x.x.tgz Release Tag : * (Git Tag) v$VERSION Release Commit Hash : * https://github.com/apache/skywalking-cli/tree/<Git Commit Hash> Keys to verify the Release Candidate : * http://pgp.mit.edu:11371/pks/lookup?op=get&search=0x8BD99F552D9F33D7 corresponding to kezhenxu94@apache.org Guide to build the release from source : * https://github.com/apache/skywalking-cli/blob/v$VERSION/docs/How-to-release.md A vote regarding the quality of this test build will be initiated within the next couple of days.
Any PMC, committer or contributor can test features for releasing, and feedback. Based on that, PMC will decide whether to start a vote or not.
Call for vote in dev@skywalking.apache.org
Subject: [VOTE] Release Apache SkyWalking CLI version $VERSION Content: Hi the SkyWalking Community: This is a call for vote to release Apache SkyWalking CLI version $VERSION. Release notes: * https://github.com/apache/skywalking-cli/blob/v$VERSION/CHANGES.md Release Candidate: * https://dist.apache.org/repos/dist/dev/skywalking/cli/$VERSION * sha512 checksums - sha512xxxxyyyzzz apache-skywalking-cli-src-x.x.x.tgz - sha512xxxxyyyzzz apache-skywalking-cli-bin-x.x.x.tgz Release Tag : * (Git Tag) v$VERSION Release Commit Hash : * https://github.com/apache/skywalking-cli/tree/<Git Commit Hash> Keys to verify the Release Candidate : * https://dist.apache.org/repos/dist/release/skywalking/KEYS Guide to build the release from source : * https://github.com/apache/skywalking-cli/blob/v$VERSION/docs/How-to-release.md Voting will start now and will remain open for at least 72 hours, all PMC members are required to give their votes. [ ] +1 Release this package. [ ] +0 No opinion. [ ] -1 Do not release this package because.... Thanks. [1] https://github.com/apache/skywalking/blob/master/docs/en/guides/How-to-release.md#vote-check
All PMC members and committers should check these before voting +1:
.asc
, .md5
, and sha
files.apache-skywalking-cli-{src,bin}-$VERSION.tgz
) are in https://dist.apache.org/repos/dist/dev/skywalking/cli/$VERSION
with .asc
, .sha512
.LICENSE
and NOTICE
are in source codes and distribution package.shasum -c apache-skywalking-cli-{src,bin}-$VERSION.tgz.sha512
.make license.
Vote result should follow these:
PMC vote is +1 binding, all others is +1 no binding.
Within 72 hours, you get at least 3 (+1 binding), and have more +1 than -1. Vote pass.
Send the closing vote mail to announce the result. When count the binding and no binding votes, please list the names of voters. An example like this:
[RESULT][VOTE] Release Apache SkyWalking CLI version $VERSION 3 days passed, we’ve got ($NUMBER) +1 bindings: xxx xxx xxx ... (list names) I’ll continue the release process.
Move source codes tar balls and distributions to https://dist.apache.org/repos/dist/release/skywalking/
, you can do this only if you are a PMC member.
export SVN_EDITOR=vim svn mv https://dist.apache.org/repos/dist/dev/skywalking/cli/$VERSION https://dist.apache.org/repos/dist/release/skywalking/cli # .... # enter your apache password # ....
Refer to the previous PR, update news and links on the website. There are seven files need to modify.
Update Github release page, follow the previous convention.
Send ANNOUNCE email to dev@skywalking.apache.org
and announce@apache.org
, the sender should use his/her Apache email account. You can get the permlink of vote thread at here.
Subject: [ANNOUNCEMENT] Apache SkyWalking CLI $VERSION Released Content: Hi the SkyWalking Community On behalf of the SkyWalking Team, I’m glad to announce that SkyWalking CLI $VERSION is now released. SkyWalking CLI: A Command Line Interface for Apache SkyWalking. SkyWalking: APM (application performance monitor) tool for distributed systems, especially designed for microservices, cloud native and container-based (Docker, Kubernetes, Mesos) architectures. Vote Thread: $VOTE_THREAD_PERMALINK Download Links: http://skywalking.apache.org/downloads/ Release Notes : https://github.com/apache/skywalking-cli/blob/$VERSION/CHANGES.md Website: http://skywalking.apache.org/ SkyWalking CLI Resources: - Issue: https://github.com/apache/skywalking/issues - Mailing list: dev@skywalkiing.apache.org - Documents: https://github.com/apache/skywalking-cli/blob/$VERSION/README.md The Apache SkyWalking Team