Differences between revisions 19 and 20
Revision 19 as of 2019-02-08 02:29:58
Size: 2629
Comment: create tag after release is accepted
Revision 20 as of 2019-03-25 02:48:53
Size: 2697
Comment: Add link to discussion forum
Deletions are marked like this. Additions are marked like this.
Line 36: Line 36:
 1. Publish changelog on various channels - mailing lists, irc and matrix groups, Twitter or GNU Social etc.  1. Publish changelog on various channels - [[https://discuss.freedombox.org/c/announcements|discussion forum]] mailing lists, irc and matrix groups, Twitter or GNU Social etc.

This is a brief description of the process of releasing a new version of FreedomBox.

Pre release (work in progress)

  1. Check that unit tests are not broken.

  2. Run plinth functional tests against current master.

  3. Check if boot process happens on one image.

Plinth Release

Releases are currently done every 2 weeks.

  1. First, check if there are any uncommitted changes on weblate. Commit if there are any.

  2. Update translation strings by running python3 setup.py update_translations. Commit.

  3. Update debian/changelog in the Plinth repository, including details that are relevant to contributors.
    • You can run gbp dch -a --multimaint-merge, then remove duplicates.

    • Also check plinth bugs to see if any Debian bugs should be closed by the changes in the release.

  4. Update the Release Notes on the wiki. This is a summary of changes that are relevant to end users.

  5. Fetch the latest manual by running make -C doc fetch. Commit.

  6. Update the version number in plinth/__init__.py.

  7. Run dch -r and finalize the changelog.

  8. Commit these changes with the message "Release <version> to unstable".

  9. Build the package using gbp buildpackage.

    • Check for any new lintian errors.
    • Recommended to test by installing the package in a development environment, or by building a freedom-maker image with --custom-package.
    • You can also run autopkgtest:
      • autopkgtest --apt-upgrade -B <new freedombox .deb> <source folder> -- lxc --sudo autopkgtest-unstable-amd64

  10. Build the source-only package using gbp buildpackage --changes-option=-S.

  11. Sign the dsc and changes files with debsign.
  12. Upload the changes file with dput.
  13. When the release is accepted into Unstable, you will get an email "Accepted plinth x.y.z (source) into unstable".
  14. After the release is accepted into Unstable, create a tag for the release. Push commits and the new tag to the Salsa repository.
    • Weblate will automatically update with the latest changes.

Post release (work in progress)

  1. Publish changelog on various channels - discussion forum mailing lists, irc and matrix groups, Twitter or GNU Social etc.

  2. Upload new image to Vagrant Cloud.