public_docs/sosreport_packaging.md

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
```