wiki/src/contribute/release_process/persistence-setup.mdwn

   1 [[!meta title="Releasing persistence-setup"]]
   2
   3 [[!toc levels=1]]
   4
   5 If running Wheezy or older, you will have to do the upstream part of
   6 the work in a Jessie chroot (e.g. with pbuilder).
   7
   8 Install build and test dependencies
   9 ===================================
  10
  11 Install build-dependencies listed in `debian/control`:
  12
  13     mk-build-deps -i -r
  14
  15 Install build-dependencies from Debian:
  16
  17     libdist-zilla-perl libdist-zilla-plugins-cjm-perl
  18     libdist-zilla-plugin-installguide-perl
  19     libdist-zilla-plugin-test-perl-critic-perl
  20     libdist-zilla-plugin-test-notabs-perl
  21     libdist-zilla-plugin-git-perl
  22     liblocale-msgfmt-perl libmoosex-has-sugar-perl
  23     dh-make-perl
  24
  25 Install build-dependencies that are not in Debian yet:
  26
  27     DEB_BUILD_OPTIONS=nocheck dh-make-perl --build --install --cpan Dist::Zilla::Plugin::LocaleMsgfmt
  28
  29 Make an upstream release
  30 ========================
  31
  32 Enable new translations in `po/PACKAGE` and commit.
  33
  34 Export new upstream version number:
  35
  36     export VERSION=XXX
  37
  38 Update version number in `bin/tails-persistence-setup`:
  39
  40     perl -pi -E 's,^Version [0-9.]+,Version $ENV{VERSION},' bin/tails-persistence-setup
  41     perl -pi -E "s,^our \\\$VERSION = '[0-9.]+';\$,our \\\$VERSION = '$VERSION';," bin/tails-persistence-setup
  42
  43 Commit all files that need to be:
  44
  45     git commit bin/tails-persistence-setup -m "tails-persistent-setup $VERSION"
  46
  47 Run the upstream test suite (point `PERL5LIB` to a checkout of the
  48 relevant tag of Tails' perl5lib):
  49
  50     RELEASE_TESTING=1 PERL5LIB=/home/user/tails/perl5lib/lib fakeroot dzil test
  51
  52 Build an upstream tarball, tag the release, move the tarball out of
  53 the build repository and cleanup:
  54
  55     dzil build && \
  56        git tag -s $VERSION -m "tails-persistent-setup $VERSION" && \
  57        mv Tails-Persistence-*.tar.gz .. && \
  58        rm -rf Tails-Persistence-* .build po/*.mo
  59
  60 Update the Debian package
  61 =========================
  62
  63 Checkout the Debian packaging branch and import the new upstream tarball:
  64
  65     git checkout debian && \
  66        git-import-orig --upstream-vcs-tag=$VERSION ../Tails-Persistence-$VERSION.tar.gz
  67
  68 Update `debian/changelog`:
  69
  70     git-dch && dch -e
  71
  72 (Do not forget to set the appropriate release.)
  73
  74 Commit `debian/changelog`:
  75
  76         git commit debian/changelog -m "$(head -n 1 debian/changelog | sed -e 's,).*,),')"
  77
  78 Build a Debian package (use a Wheezy/i386 chroot, that
  79 has either tails-perl5lib installed, or the Tails APT repository
  80 configured):
  81
  82     git-buildpackage
  83
  84 If everything is fine, add a signed tag to the repository and push the
  85 changes:
  86
  87     git-buildpackage --git-tag-only --git-sign-tags && \
  88        git push && git push --tags
  89
  90 (Make sure `master`, `upstream`, `debian` and `pristine-tar` were all pushed.)
  91
  92 Add the Debian package to Tails
  93 ===============================
  94
  95 Sign the package:
  96
  97     debsign $CHANGES_FILE
  98
  99 Upload:
 100
 101     dupload --to tails $CHANGES_FILE