Release Guide

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

  1. Update the package version and CHANGES.md to prepare the official release.

  2. 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/grafana-plugins/x.y.z.

  1. Make the internal announcements. Send an announcement mail in dev mail list.
[ANNOUNCE] SkyWalking Grafana Plugins 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-grafana-plugins/blob/vx.y.z/CHANGES.md

Release Candidate:

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

Release Tag :

 * vx.y.z

Release CommitID :

 * https://github.com/apache/skywalking-grafana-plugins/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 Grafana Plugins x.y.z

This is a call for vote to release Apache SkyWalking Grafana Plugins version x.y.z.

Release notes:

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

Release Candidate:

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

Release Tag :

 * vx.y.z

Release CommitID :

 * https://github.com/apache/skywalking-grafana-plugins/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/grafana-plugins/x.y.z https://dist.apache.org/repos/dist/release/skywalking/grafana-plugins
....
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 Grafana Plugins version x.y.z

Mail content:
Hi all,

Apache SkyWalking  Team is glad to announce the first release of Apache SkyWalking Grafana Plugins 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 Grafana Plugins provide browser metrics and error collection to SkyWalking backend.

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-grafana-plugins/blob/x.y.z/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. publish package to Grafana Cloud

  2. Build the plugin

> yarn install --pure-lockfile
> yarn build
> export VERSION=x.y.z
> make release-dist
  1. Sign in to Grafana Cloud account,the username is wusheng@apache.org and the password has been sent to private@skwalking.apache.org.
* In the left menu, under Org settings, click My Plugins.

* Click Submit Update for the plugin you want to update.

* Enter the information requested by the form.

  OS & Architecture:

    Select Single if your plugin archive contains binaries for multiple architectures.

    Select Multiple if you’d like to submit separate plugin archives for each architecture. This can lead to faster downloads since users can select the specific architecture they want to install the plugin on.

  URL: A URL that points to a ZIP archive of your packaged plugin.

  Source Code URL: A URL that points to a public git repository or ZIP archive of your complete plugin source code.

  MD5: The MD5 hash of the plugin specified by the URL.

* Click Submit.