Debian upgrades of Tails nodes

:warning: This page documents what i recall from the upgrade procedure which, as far as i know, was undocumented until the moment of writing. It may be incomplete and we may do something different for the bookwormtrixie upgrades (see tpo/tpa/team#42071).

  1. Update the profile::tails::apt class to account for the new version.
  2. For each node:
  3. Start a tmux or screen session on the host where the upgrade will be happening.
  4. Set profile::tails::apt::codename in hiera for the node with the codename of the new debian version, commit, push.
  5. Run Puppet once so the distro codename is updated.
  6. Run apt full-upgrade and apt autopurge manually.
  7. Run Puppet in the node until it converges.
  8. Reboot the machine.
  9. Check that everything works fine.
  10. Once all nodes have been upgraded, update the $codename parameter in the profile::tails::apt class and remove the per-node configuration in hiera.