From 5a7cee31fc8551ba87a320bf1659ddc27be41eb9 Mon Sep 17 00:00:00 2001 From: Arif Ali Date: Wed, 24 Jan 2024 09:34:58 +0000 Subject: [PATCH] Add sosreport packaging documentation --- sosreport_packaging.md | 61 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 61 insertions(+) create mode 100644 sosreport_packaging.md diff --git a/sosreport_packaging.md b/sosreport_packaging.md new file mode 100644 index 0000000..b3e0a3d --- /dev/null +++ b/sosreport_packaging.md @@ -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 +```