Skip to content

Latest commit

 

History

History
105 lines (71 loc) · 3.25 KB

developer-guide.md

File metadata and controls

105 lines (71 loc) · 3.25 KB
Raw

Developer guide

This guide helps you get started developing Grafana Plugin SDK for Go.

Tooling

Make sure you have the following tools installed before setting up your developer environment:

Building

We use Mage as our primary tool for development related tasks like building and testing etc. It should be run from the root of this repository.

List available Mage targets that are available:

mage -l

You can use the build target to verify all code compiles. It doesn't output any binary though.

mage -v build

The -v flag can be used to show verbose output when running Mage targets.

Testing

mage test

Linting

mage lint

Generate Go code for Protobuf definitions

A prerequisite is to have protoc installed and available in your path.

Next, you need to have protoc-gen-go installed and available in your path. It's very important that you match the version specified of github.com/golang/protobuf in go.mod file, as of this writing it's v1.3.4.

mage protobuf

Changing generic_*.go files in the data package

Currently genny is used for generating some go code. If you make changes to generic template files then genny needs to be installed, and then mage dataGenerate. Changed generated files should be committed with the change in the template files.

Dependency management

We use Go modules for managing Go dependencies. After you've updated/modified modules dependencies, please run go mod tidy to cleanup dependencies.

Releasing

If you want to create a new version of the SDK for release, follow these steps:

  • Checkout the commit you want to tag (git checkout <COMMIT_SHA>)
  • Run gorelease to compare with the previous release. For example, when preparing to release v0.123.0:
gorelease -base v0.122.0 -version v0.123.0
github.com/grafana/grafana-plugin-sdk-go/backend/gtime
------------------------------------------------------
Compatible changes:
- package added

v0.123.0 is a valid semantic version for this release.
  • Run git tag <VERSION> (For example v0.123.0)
    • NOTE: We're using Lightweight Tags, so no other options are required
  • Run git push origin <VERSION>
  • Verify that the tag was create successfully here
  • Edit the tag on GitHub and create a release from it.
    • Use the tag name as title.
    • Click on the Auto-generate release notes button.
    • Add a compatibility section and add the output of the command above.

Release notes example:

  • Title: v0.123.0
  • Content:
<!-- Auto generated release notes -->

## Compatibility
```
gorelease -base v0.122.0 -version v0.123.0
github.com/grafana/grafana-plugin-sdk-go/backend/gtime
------------------------------------------------------
Compatible changes:
- package added

v0.123.0 is a valid semantic version for this release.
```