update release process notes

* drop the detached gpg signature as this doesn't seem required anymore by
anything; the signed git tag is sufficient to auth the released source

* exclude vagrant data from git clean, otherwise this destroys the test
environment which is useful during the release process; this does not
cause any vagrant artifacts to become part of the release source

* drop attaching release artifacts to milestones, as GitLab Releases
have made this practice deprecated

* add diffoscope command for easier tarball comparison
This commit is contained in:
Jerome Charaoui 2021-01-25 09:46:23 -05:00
parent 39e5f2ef23
commit 3a0b694d6e

View File

@ -1,6 +1,11 @@
Upstream Upstream
======== ========
* run the full testsuite
vagrant rsync local && \
vagrant ssh -c "build-backupninja.sh && sudo /vagrant/test/test.sh"
* prepare the environment: * prepare the environment:
export VERSION=x.y.z export VERSION=x.y.z
@ -15,11 +20,11 @@ Upstream
"s{^## \[Unreleased\].*}{## [$VERSION] - $RELEASE_DATE}" \ "s{^## \[Unreleased\].*}{## [$VERSION] - $RELEASE_DATE}" \
CHANGELOG.md CHANGELOG.md
* commit, tag and create the tarball: * commit and created signed tag
git commit configure.ac CHANGELOG.md \ git commit configure.ac CHANGELOG.md \
-m "Releasing backupninja $VERSION" && \ -m "Releasing backupninja $VERSION" && \
git clean -fdx && \ git clean -fdx -e .vagrant && \
git tag -s "backupninja-$VERSION" \ git tag -s "backupninja-$VERSION" \
-m "Releasing backupninja $VERSION" && \ -m "Releasing backupninja $VERSION" && \
./autogen.sh && \ ./autogen.sh && \
@ -29,15 +34,15 @@ Upstream
* compare the content of the generated tarball with the content of the * compare the content of the generated tarball with the content of the
previous one previous one
* move the tarball outside of the Git working copy and clean up: diffoscope --text-color=always ../tarballs/backupninja-x.y.z.tar.gz \
backupninja-$VERSION.tar.gz | less -R
* move the tarball outside of the Git working copy and clean up
mkdir -p ../tarballs && \ mkdir -p ../tarballs && \
mv backupninja-$VERSION.tar.gz ../tarballs/ && \ mv backupninja-$VERSION.tar.gz ../tarballs/ && \
make distclean && \ make distclean && \
git clean -fdx git clean -fdx -e .vagrant
* Install (extract tarball, `.configure && make && sudo make install`)
and test.
Debian Debian
====== ======
@ -59,10 +64,8 @@ Install the `.deb` and test.
Release Release
======= =======
* sign the release and push it to Git: * push the release to GitLab
gpg --armor --detach-sign \
../tarballs/backupninja-$VERSION.tar.gz && \
git checkout debian && \ git checkout debian && \
gbp buildpackage --git-tag-only --git-sign-tags && \ gbp buildpackage --git-tag-only --git-sign-tags && \
git push --follow-tags origin \ git push --follow-tags origin \
@ -71,10 +74,11 @@ Release
pristine-tar:pristine-tar \ pristine-tar:pristine-tar \
upstream:upstream upstream:upstream
* upload the upstream tarball and detached signature to the GitLab * create a new GitLab release
milestone page with *Edit* → *Attach a file*
* announce the release on the backupninja mailing-list, * announce the release on the backupninja mailing-list,
pointing to the milestone web page pointing to the milestone web page
* upload to Debian or ask someone listed in the `Uploaders` control * upload to Debian or ask someone listed in the `Uploaders` control
field to review and upload field to review and upload
@ -82,4 +86,5 @@ Open the next development cycle
=============================== ===============================
* `git checkout master` * `git checkout master`
* Add an empty new section in `CHANGELOG.md`, commit and push. * Add an empty new section in `CHANGELOG.md`, commit and push.