diff --git a/howto/upgrade_debian.md b/howto/upgrade_debian.md new file mode 100644 index 0000000..d726de9 --- /dev/null +++ b/howto/upgrade_debian.md @@ -0,0 +1,46 @@ +# Changement de version majeure de Debian + +Parce que de temps en temps il faut le faire. +Ça a l'air terrifiant dit comme ça, mais en y allant calmement on s'en sort. +Conseil pour les gens qui débutent : commencer par des VM brûlables, +ou des VM "en prod mais inutiles" pour se faire la main, +puis y aller progressivement. + +## HowTo passer de Bookworm à Trixie + +Tuto made in @Lzebulon, "testé en prod sur voyager" : + +- Vérifier qu'il n'y a pas de service + pénible à gérer (`isc-dhcp-server`, `dovecot` par exemple). +- Aller lire les notes de release de Debian. + - Voir [ici](https://www.debian.org/releases/trixie/release-notes/upgrading.fr.html) pour Debian 13 (Trixie). Parce qu'on est studieux ici. +- On commence par se mettre totalement à jour sur la version dont on sort. + - `sudo apt update` + - `sudo apt dist-upgrade --auto-remove` +- On remplace les sources de paquets d'une version à l'autre + - Exemple pour `bookworm -> trixie` : `sudo sed -i 's/bookworm/trixie/g' /etc/apt/sources.list` + - :warning: Debian a changé sa gestion des sources à partir de Trixie. + Maintenant, le fichier a un format différent + et son chemin est `/etc/apt/sources.list`. +- On se remet à jour en rattrapant les paquets de la nouvelle version. + - `sudo apt update` + - `sudo apt dist-upgrade --autoremove` +- Il faut s'attendre à pas mal de prompts sur les fichiers de config, + d'autant qu'au Crans on a un historique d'usage d'Ansible conséquent. + Le plus prudent, de loin, est de garder le fichier de config actuel. + Testé et approuvé. +- Debian va montrer les changelogs d'une version à l'autre, les lire. +- On peut reboot la VM. Et vérifier que tout marche.™ +- On peut nettoyer les anciens paquets. + - `sudo apt autoremove --purge` + - `sudo apt purge '~o` + - `sudo apt autoclean` +- Spécifiquement pour le passage à Trixie, il existe une commande pour + faire la transition de l'ancienne convention de sources à la nouvelle. + - `sudo apt modernize-sources` + - `sudo apt update` +- Vérifier que les srvices fonctionnent toujours. + - Pour les services ayant un Nginx local, `sudo systemctl restart nginx` + sur la VM de service. Les pads (Kenobi) sont concernés. + - Pour les services utilisant PHP, vérifier dans le Nginx central (Hodaur) + que c'est la bonne version qui est utilisée. \ No newline at end of file