forgejo.dev/infrastructure-as-code
2
1
Fork 0
Code Issues 18 Pull requests Releases Activity

Adds documentation draft on how to manually update from Debian 11 to 12

Browse source
This commit is contained in:
Maximilian Kratz 2024-07-21 11:35:13 +02:00
parent 156825c169
commit 83269343cf
1 changed files with 21 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

21
doc/upgrade-debian-11-to-12.md Normal file
View file

@ -0,0 +1,21 @@
# Upgrade Debian 11 to 12
The upgrade of the underlying OS gets carried out manually (i.e., without the help of Terraform or Ansible).
## Steps
- Create a backup of the whole system, e.g., using the Hetzner cloud backup mechanism.
- Change all apt repositories in `/etc/apt/sources.list` and `/etc/apt/sources.list.d/*` from `bullseye` to `bookworm`.
- `non-free` was changed to `non-free-firmware`.
- `$ apt update`
- `$ apt full-upgrade`
- If the systems asks to configure `iperf3` as automatic service startup, select `no`.
- If the systems asks to restart services without manual interaction, select `yes`.
- If the systems asks to decide on how to handle updated config files in `/etc/*`, choose `N` (= keep your currently-installed version).
- `$ apt autoremove` to clean up old packages.
- Reboot.
- (Obviously) Check if all services are up and running correctly.
- Adapt the Terraform configuration, i.e., change the base image of the system from `debian-11` to `debian-12`.
- Be careful when re-running Terraform because it usually wants to recreate the whole system. This can be ommitted by configuring the respective Terraform resource to ignore this specific attribute when considering rebuilding.
- Adapt the Ansible confguration.
- Adapt all necessary information in Ansible roles, e.g., it is necessary to update `bullseye` to `bookworm` in apt repositories.