Add sosreport packaging documentation

This commit is contained in:
Arif Ali 2024-01-24 09:34:58 +00:00
parent 68a8606a7b
commit 5a7cee31fc
Signed by: arif
GPG Key ID: 369608FBA1353A70

61
sosreport_packaging.md Normal file
View File

@ -0,0 +1,61 @@
This document is a collection of information on how we go about building the sosreport package and the process of building a new version and then potentially doing a SRU. The main purpose of this document is so that anyone would be able to pick this up, if any one leaves the small team that is looking after sosreport.
# Building a tagged release from git
# Some rough notes
```
debuild -i -us -uc -b
```
To attempt to build it locally
```
dpkg-buildpackage -b -us -uc -rfakeroot -m --build-by="arif.ali@canonical.com"
```
This will attempt to build the package locally with the email provided, and the version that is specified in `debian/changelog`. As of writing this piece of the document, this came out to be
```
sosreport_4.6.0-0ubuntu1_amd64.deb
```
This is great for testing locally, but once we are happy that this is working then we need to use the Launchpad way to upload the `source.changes file which will then allow LP to build and the package to be available for testing purposes.
# New release from pull-lp-source
First grab the latest version for a series
```
pull-lp-source sosreport jammy
```
Then run uscan, which wil download the latest from github, with the debian folder from lp
```
uscan
cd sosreport-4.6.1
```
Now update the changelog, to make any changes
```
vi debian/changelog
```
Now build the source changes file
```
dpkg-buildpackage -S --build-by="arif.ali@canonical.com”
```
Finally push the source.changes to publish the package in the PPA
```
dput ppa:arif-ali/sosreport ../sosreport_4.6.1-0ubuntu1~22.04.1_source.changes
```