Release Guide

All committer should follow these steps to do release for this repo.

  1. Prepare the official release.
  • Update the CHANGES.md.
  • Create a new skywalking-nginx-lua-x.y-z.rockspec file under rockspec.
  1. Package the source release.
> export VERSION=x.y.z
> make release-src

Use SVN to upload the files(tgz, asc and sha512) in the release folder to https://dist.apache.org/repos/dist/dev/skywalking/nginx-lua/x.y.z.

  1. Make the internal announcements. Send an announcement mail in dev mail list.
[ANNOUNCE] SkyWalking Nginx LUA x.y.z test build available

The test build of x.y.z is 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-nginx-lua/blob/vx.y.z/CHANGES.md

Release Candidate:

 * https://dist.apache.org/repos/dist/dev/skywalking/nginx-lua/x.y.z/
 * sha512 checksums
   - xxxxxxx  skywalking-nginx-lua-x.y.z-src.tgz

Release Tag :

 * vx.y.z

Release CommitID :

 * https://github.com/apache/skywalking-nginx-lua/tree/xxxxxxxxxx

Keys to verify the Release Candidate :

 * https://dist.apache.org/repos/dist/release/skywalking/KEYS


A vote regarding the quality of this test build will be initiated
within the next couple of days.
  1. Wait at least 48 hours for test responses. If there is a critical issue found and confirmed by the PMC, this release should be cancelled.

  2. Call for a vote. Call a vote in dev@skywalking.apache.org

[VOTE] Release SkyWalking Nginx LUA x.y.z

This is a call for vote to release Apache SkyWalking Nginx LUA version x.y.z.

Release notes:

 * https://github.com/apache/skywalking-nginx-lua/blob/vx.y.z/CHANGES.md

Release Candidate:

 * https://dist.apache.org/repos/dist/dev/skywalking/nginx-lua/x.y.z/
 * sha512 checksums
   - xxxxxxx  skywalking-nginx-lua-x.y.z-src.tgz

Release Tag :

 * vx.y.z

Release CommitID :

 * https://github.com/apache/skywalking-nginx-lua/tree/xxxxxxxxxx

Keys to verify the Release Candidate :

 * https://dist.apache.org/repos/dist/release/skywalking/KEYS


Voting will start now (xxxx date) and will remain open for at least 72 hours, Request all PMC members to give their vote.
[ ] +1 Release this package.
[ ] +0 No opinion.
[ ] -1 Do not release this package because....

  1. Publish release, if vote passed.

Move the release from RC folder to the dist folder. This will begin the file sync across the global Apache mirrors.

> export SVN_EDITOR=vim
> svn mv https://dist.apache.org/repos/dist/dev/skywalking/nginx-lua/x.y.z https://dist.apache.org/repos/dist/release/skywalking/nginx-lua
....
enter your apache password
....

Send ANNOUNCE email to dev@skywalking.apache.org, announce@apache.org, the sender should use Apache email account.

Mail title: [ANNOUNCE] Release Apache SkyWalking Nginx LUA version x.y.z

Mail content:
Hi all,

Apache SkyWalking  Team is glad to announce the first release of Apache SkyWalking Nginx LUA x.y.z

SkyWalking: APM (application performance monitor) tool for distributed systems,
especially designed for microservices, cloud native and container-based (Docker, Kubernetes, Mesos) architectures.

SkyWalking Nginx Agent provides the native tracing capability for Nginx powered by Nginx LUA module.

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/blob/v7.0.0/CHANGES.md

Apache SkyWalking website:
http://skywalking.apache.org/

Downloads:
http://skywalking.apache.org/downloads/

Twitter:
https://twitter.com/ASFSkyWalking

SkyWalking Resources:
- GitHub: https://github.com/apache/skywalking
- Issue: https://github.com/apache/skywalking/issues
- Mailing list: dev@skywalkiing.apache.org


- Apache SkyWalking Team
  1. upload rockspec file to luarocks.org login to luarocks.org, the user name is apache-skywalking and the password has been sent to private@skwalking.apache.org.

Then upload the rockspec file and you can use the luarocks command line to install the new version.