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.
Add your GPG public key into SkyWalking GPG KEYS file, you can do this only if you are a committer, use your Apache id and password to log into the svn, and update the file. DO NOT override the existed KEYS file.
Upload your GPG public key to public GPG site, such as MIT's site. This site should be in Apache maven staging repository check list.
export VERSION=<the version to release> git tag v${VERSION} make release
The skywalking-cli-${VERSION}-bin.tgz, skywalking-cli-${VERSION}-src.tgz, and their corresponding asc, sha512 should be generated in the directory automatically.
svn checkout https://dist.apache.org/repos/dist/dev/skywalkingcli/, e.g. cd skywalking && mkdir -p cli/$VERSION.asc and .sha512Send 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 All, 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 (xxxx date) 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....
All PMC members and committers should check these before voting +1.
.asc, .md5, and sha filesapache-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.sha512make license;Vote result should follow these.
https://dist.apache.org/repos/dist/release/skywalking/.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 # ....
Public download links of source and distribution tar/zip locate in http://www.apache.org/dyn/closer.cgi/skywalking/cli/$VERSION/. We only publish Apache mirror path as release info.
Public asc and sha512 locate in https://www.apache.org/dist/skywalking/cli/$VERSION/xxx
Public KEYS pointing to https://www.apache.org/dist/skywalking/KEYS
Send ANNOUNCEMENT email to dev@skywalking.apache.org.
Update links on the website download page. http://skywalking.apache.org/downloads/ . Include the new source codes, distribution packages, corresponding sha512, asc and document links. Links could be found by following rules(3)-(6).
Add a release event on website homepage and event page. Announce the public release with changelog or key features.
Send ANNOUNCE email to dev@skywalking.apache.org and announce@apache.org, the sender should use his/her Apache email account.
Subject: [ANNOUNCEMENT] Apache SkyWalking CLI $VERSION Released Content: Hi all, The Apache SkyWalking Team is glad to announce the release of Apache SkyWalking CLI $VERSION. SkyWalking CLI: A Command Line Interface for Apache SkyWalking https://skywalking.apache.org/ SkyWalking: APM (application performance monitor) tool for distributed systems, especially designed for microservices, cloud native and container-based (Docker, Kubernetes, Mesos) architectures. This release contains a number of new features, bug fixes and improvements compared to version a.b.c(last release). The notable changes since x.y.z include: (Highlight key changes) 1. ... 2. ... 3. ... Please refer to the change log for the complete list of changes: https://github.com/apache/skywalking-cli/blob/$VERSION/CHANGES.md Apache SkyWalking website: http://skywalking.apache.org/ Downloads: http://skywalking.apache.org/downloads/ Twitter: https://twitter.com/ASFSkyWalking 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/docs/README.md - The Apache SkyWalking Team