mirror of https://github.com/grafana/grafana.git
27 lines
1.1 KiB
Markdown
27 lines
1.1 KiB
Markdown
# Upgrade dependencies
|
|
|
|
We recommend the practices in this documentation when upgrading the various backend dependencies of Grafana.
|
|
|
|
## Protocol buffers (protobufs)
|
|
|
|
Use the most recent stable version of the [protobuf library](http://github.com/golang/protobuf) in Grafana and the plugin SDK.
|
|
|
|
Additionally, you typically want to upgrade your protobuf compiler toolchain and re-compile the protobuf files.
|
|
|
|
> **Note:** You need Buf CLI installed and available in your path. For instructions, refer to the [Buf Docs documentation](https://buf.build/docs/installation).
|
|
|
|
After you've installed Buf CLI, re-compile the protobuf files in Grafana and the plugin SDK. Use this code:
|
|
|
|
```shell
|
|
cd $GRAFANA
|
|
make protobuf
|
|
cd $GRAFANA_PLUGIN_SDK_GO
|
|
mage protobuf
|
|
```
|
|
|
|
After upgrading the protobuf dependency in Grafana and the plugin SDK, it is a best practice to test that your code still works before creating your PR. Specifically:
|
|
|
|
- Test a plugin built with upgraded SDK on upgraded Grafana
|
|
- Test a plugin built with non-upgraded SDK on upgraded Grafana
|
|
- Test a plugin built with upgraded SDK on non-upgraded Grafana
|