2020-10-15 07:45:06 +00:00
# grafana-pcp
The grafana-pcp package
2022-09-20 15:36:23 +00:00
## Setup instructions
* clone the upstream sources: `git clone https://github.com/performancecopilot/grafana-pcp && cd grafana-pcp`
* checkout the version of the specfile: `git checkout <currentversion>`
* apply existing patches: `git am ../0*.patch`
2020-12-23 14:08:59 +00:00
## Upgrade instructions
2022-09-20 15:36:23 +00:00
* follow the Setup instructions above
* rebase to the new version: `git fetch && git rebase --onto <newversion> <oldversion>`
* rebasing `remove-unused-frontend-crypto.patch` : only apply the patch to `package.json` and run `yarn install` , then `yarn.lock` will get updated automatically
* create new patches from the modified git commits: `git format-patch -N --no-stat --no-signature <newversion> && mv *.patch ..`
2021-11-12 15:21:30 +00:00
* update `Version` , `Release` , `%changelog` and tarball NVRs in the specfile
2022-09-20 15:36:23 +00:00
* create bundles and manifest: `./create_bundles_in_container.sh`
2020-12-23 14:08:59 +00:00
* update specfile with contents of the `.manifest` file
* run local build: `rpkg local`
2022-09-20 15:36:23 +00:00
* run rpmlint: `rpmlint -r grafana-pcp.rpmlintrc /tmp/rpkg/grafana-pcp-*/grafana-pcp-*.src.rpm /tmp/rpkg/grafana-pcp-*/x86_64/grafana-pcp-*.x86_64.rpm`
2020-12-23 14:08:59 +00:00
* run a scratch build: `fedpkg scratch-build --srpm`
* upload new source tarballs: `fedpkg new-sources *.tar.gz *.tar.xz`
2021-11-12 15:21:30 +00:00
* commit new `sources` file
2020-10-15 07:45:06 +00:00
2021-11-12 15:21:30 +00:00
## Patches
2020-12-23 14:08:59 +00:00
* create the patch
* declare and apply (`%prep`) the patch in the specfile
* if the patch affects Go or Node.js dependencies, or the webpack
2022-09-20 15:36:23 +00:00
* update the `create_bundles.sh` script and apply the patch
2021-11-12 15:21:30 +00:00
* create new tarballs
* update the specfile with new tarball name and contents of the `.manifest` file
### General guidelines
* aim to apply all patches in the specfile
* avoid rebuilding the tarballs
Patches fall in several categories:
* modify dependency versions
* modify both sources and vendored dependencies (e.g. CVEs)
* modify the Node.js source (i.e. affect the webpack)
* some patches are conditional (e.g. FIPS)
2020-10-15 07:45:06 +00:00
2021-11-12 15:21:30 +00:00
Patches cannot be applied twice.
It is not possible to unconditionally apply all patches in the Makefile, and great care must be taken to include the required patches at the correct stage of the build.
2022-09-20 15:36:23 +00:00
## Reproducible Bundles
Run `./create_bundles_in_container.sh` to generate a reproducible vendor and webpack bundle.
