2019-04-29 12:46:34 +00:00
# grafana
2020-04-22 16:14:45 +00:00
The grafana package
2019-04-29 12:46:34 +00:00
2020-04-22 16:14:45 +00:00
## Upgrade instructions
2021-09-30 12:16:39 +00:00
* update `Version` , `Release` , `%changelog` and tarball NVRs in the specfile
* create bundles and manifest: `make clean all`
2020-11-25 17:55:36 +00:00
* update specfile with contents of the `.manifest` file
2020-04-22 16:14:45 +00:00
* check if the default configuration has changed: `diff grafana-X.Y.Z/conf/defaults.ini distro-defaults.ini` and update `distro-defaults.ini` if necessary
2021-05-20 14:57:43 +00:00
* update the manpages patch in `002-manpages.patch` and other patches if required
2020-07-30 15:52:28 +00:00
* run local build: `rpkg local`
2020-11-04 16:44:15 +00:00
* run rpm linter: `rpkg lint -r grafana.rpmlintrc`
* run local builds with different OS versions: `./run_container_build.sh fedora-version`
2020-04-22 16:14:45 +00:00
* run a scratch build: `fedpkg scratch-build --srpm`
2020-12-21 18:42:28 +00:00
* upload new source tarballs: `fedpkg new-sources *.tar.gz *.tar.xz`
2021-09-30 12:16:39 +00:00
* commit new `sources` file
2020-11-04 16:44:15 +00:00
## Backporting
* create the patch
* declare and apply (`%prep`) the patch in the specfile
* if the patch affects Go or Node.js dependencies, or the webpack
2021-09-30 12:16:39 +00:00
* create new tarballs
2020-11-25 17:55:36 +00:00
* update the specfile with new tarball path and contents of the `.manifest` file
2020-11-04 16:44:15 +00:00
2021-09-30 12:16:39 +00:00
Note: the Makefile automatically applies patches before creating the tarballs
## Patches
* `*.patch` : regular patches applied to the source, applied in the Makefile before vendoring and in the specfile (e.g. updating dependencies)
* `*.vendor.patch` : patches applied to the vendor tarball (e.g. patching vendored sources before generating a webpack)
* `*.cond.patch` : conditionally applied patches in the specfile
2021-05-20 14:57:43 +00:00
## Verification
* compare the list of files with the upstream RPM at https://grafana.com/grafana/download
