diff --git a/README-2.md b/README-2.md new file mode 100644 index 0000000..93fed87 --- /dev/null +++ b/README-2.md @@ -0,0 +1,283 @@ +# Proxmox und Guest Updater + +Automatische Updates für **Proxmox VE**, **LXC-Container** und **Debian-/Ubuntu-VMs**. + +Das Skript aktualisiert den Proxmox-Host sowie unterstützte Gäste zentral vom Proxmox-Host aus. Es erkennt, ob tatsächlich Paketänderungen vorhanden sind, behandelt notwendige Neustarts gesammelt, berücksichtigt laufende Proxmox-Backups und kann nach einem Update- oder Prüflauf eine Zusammenfassung über das **Proxmox Notification System** versenden. + +## Funktionen + +- Automatische Updates des Proxmox-Hosts +- Automatische Updates von Debian-/Ubuntu-LXC-Containern +- Automatische Updates von Debian-/Ubuntu-VMs über den QEMU Guest Agent +- Erkennt, ob ein System bereits aktuell ist +- Gestoppte Gäste können optional für das Update gestartet werden +- Vom Updater gestartete Gäste werden anschließend wieder gestoppt +- Ausschlussliste für einzelne CTs und VMs +- Ein Fehler bei einem Gast stoppt nicht die Aktualisierung der übrigen Gäste +- Fehlerhafte Gäste werden von automatischen Gast-Neustarts ausgeschlossen +- Sichere Behandlung notwendiger Neustarts +- Automatischer Host-Neustart optional +- Schutz vor Updates und Neustarts während laufender Proxmox-Backups +- Prüfung des Update-Zeitplans auf mögliche Überschneidungen mit Proxmox-Backup-Jobs +- Proxmox-Benachrichtigungen optional +- Wöchentlicher systemd-Timer +- Check-Modus ohne Installation von Updates +- Gezielte Aktualisierung einzelner CTs oder VMs +- Zusätzliche Prüfung auf Paketänderungen, die ein `full-upgrade` erfordern würden +- Protokollierung nach `/var/log/pve-guest-update.log` +- Vorhandene Installation kann über den Installer aktualisiert werden +- Ausschlussliste kann über den Installer vollständig geleert werden +- Updater kann über den Installer vollständig entfernt werden + +## Voraussetzungen + +- Proxmox VE +- Debian-/Ubuntu-basierte LXC-Container für automatische LXC-Updates +- Debian-/Ubuntu-VMs benötigen den **QEMU Guest Agent** +- Internetzugriff auf die verwendeten Paketquellen + +Windows-VMs und andere nicht unterstützte Betriebssysteme werden nicht aktualisiert. + +## Installation + +Auf dem Proxmox-Host als `root`: + +```bash +curl -fsSL https://gitea.vourx.com/sharky/Proxmox-und-GuestUpdater/raw/branch/main/install.sh | bash +``` + +Der Installer führt **keine Updates** aus. Er installiert bzw. aktualisiert lediglich das Skript, die Konfiguration sowie den systemd-Service und den systemd-Timer. + +Bei einer vorhandenen Installation werden die bisherigen Einstellungen eingelesen und können übernommen bzw. angepasst werden. + +## Konfiguration + +Die Konfiguration liegt unter: + +```text +/etc/pve-guest-update.conf +``` + +Konfigurierbar sind unter anderem: + +- Update des Proxmox-Hosts +- automatische LXC-Updates +- automatische VM-Updates +- Start gestoppter Gäste +- automatischer Host-Reboot +- Ausschlussliste +- Wochentag und Uhrzeit +- Proxmox-Benachrichtigungen +- Notification-Target +- Wartezeit auf APT-/DPKG-Sperren +- maximale Wartezeit auf laufende Proxmox-Backups + +### Gestoppte Gäste + +Ist das automatische Starten gestoppter Gäste deaktiviert, werden diese übersprungen. + +Ist es aktiviert, startet der Updater einen unterstützten gestoppten Gast, führt die Aktualisierung durch und fährt ihn anschließend wieder herunter. + +Ein Gast, der vor dem Lauf gestoppt war, bleibt also nicht dauerhaft eingeschaltet. + +### Gäste ausschließen + +CT- und VM-IDs können in der Ausschlussliste eingetragen werden. Diese Gäste werden vollständig übersprungen. + +Beispiel: + +```text +EXCLUDE_GUESTS="107 105 210" +``` + +Alle Ausschlüsse können später ohne erneute vollständige Konfiguration entfernt werden: + +```bash +curl -fsSL https://gitea.vourx.com/sharky/Proxmox-und-GuestUpdater/raw/branch/main/install.sh | bash -s -- --clear-excludes +``` + +## QEMU Guest Agent für VMs + +Automatische Updates innerhalb von Debian-/Ubuntu-VMs erfolgen über den **QEMU Guest Agent**. + +In jeder VM, die automatisch aktualisiert werden soll: + +```bash +apt update +apt install -y qemu-guest-agent +systemctl enable --now qemu-guest-agent +``` + +Zusätzlich in Proxmox bei der VM unter: + +**Optionen → QEMU Guest Agent** + +den QEMU Guest Agent aktivieren. + +Die Verbindung kann auf dem Proxmox-Host geprüft werden: + +```bash +qm agent ping +``` + +Ohne erreichbaren QEMU Guest Agent kann eine laufende Debian-/Ubuntu-VM nicht automatisch aktualisiert werden. + +## Update-Verhalten + +Für Debian-/Ubuntu-Systeme wird zunächst `apt-get update` ausgeführt. Anschließend prüft der Updater, ob Paketänderungen vorhanden sind. + +Die Aktualisierung der Gäste erfolgt mit `apt-get upgrade` unter Verwendung nichtinteraktiver DPKG-Einstellungen, damit vorhandene Konfigurationsdateien nicht ungefragt ersetzt werden. + +Der Proxmox-Host wird mit `full-upgrade` aktualisiert. Vorher wird über eine Simulation geprüft, ob tatsächlich Paketänderungen erforderlich sind. + +## Full-upgrade-Prüfung der Gäste + +Nach der normalen Aktualisierung eines unterstützten Gastes führt der Updater zusätzlich eine Simulation von: + +```bash +apt-get -s full-upgrade +``` + +durch. Dadurch können Paketänderungen erkannt werden, die durch das normale `upgrade` nicht durchgeführt wurden. + +Der Updater führt bei Gästen nicht automatisch ein `full-upgrade` durch. Die Ausgabe dient als Hinweis für eine anschließende manuelle Prüfung. + +## Schutz vor Proxmox-Backups + +Vor einem normalen Update-Lauf prüft der Updater, ob aktuell ein Proxmox-Backup über `vzdump` läuft. Ist ein Backup aktiv, wartet der Updater zunächst auf dessen Ende. + +Standardmäßig gilt: + +```text +BACKUP_WAIT_TIMEOUT="7200" +BACKUP_WAIT_INTERVAL="60" +``` + +Damit wartet der Updater maximal **2 Stunden** und prüft alle **60 Sekunden**, ob das Backup beendet wurde. Auch unmittelbar vor automatischen Neustarts wird erneut geprüft, ob inzwischen ein Proxmox-Backup läuft. + +### Prüfung des geplanten Zeitpunkts + +Der Installer liest vorhandene Proxmox-Backup-Jobs aus und vergleicht deren Startzeiten mit dem gewählten Update-Zeitpunkt. Liegt eine Backup-Startzeit innerhalb eines Sicherheitsfensters von **±2 Stunden** um den Updater-Start, wird eine Warnung angezeigt. + +## Neustart-Logik + +Notwendige Neustarts werden nicht sofort während der Aktualisierung durchgeführt. Der Updater sammelt zunächst die Neustart-Anforderungen und entscheidet erst am Ende des Update-Laufs. + +### Fehlerfreier Lauf mit notwendigem Host-Reboot + +Wenn der Proxmox-Host erfolgreich aktualisiert wurde und einen Neustart benötigt, werden keine einzelnen CT-/VM-Neustarts durchgeführt, wenn ein automatischer Host-Reboot erfolgt. Der Host-Neustart übernimmt gleichzeitig die notwendigen Neustarts der laufenden Gäste. + +### Kein automatischer Host-Reboot + +Findet kein automatischer Host-Reboot statt, werden notwendige Gast-Neustarts einzeln verarbeitet. Das gilt auch bei `--no-reboot` oder bei einem gezielten CT-/VM-Lauf. + +### Fehler während des Laufs + +Ein Fehler bei einem Gast verhindert **nicht** automatisch alle Neustarts. Fehlerhafte Gäste werden intern markiert und nicht automatisch einzeln neu gestartet. Erfolgreich aktualisierte Gäste können weiterhin neu gestartet werden, wenn dies erforderlich ist. + +Auch ein notwendiger Host-Neustart kann weiterhin durchgeführt werden, wenn das Host-Update selbst erfolgreich war, der automatische Host-Reboot aktiviert ist, `--no-reboot` nicht verwendet wurde und kein laufendes Proxmox-Backup den Neustart blockiert. + +### `--no-reboot` + +```bash +pve-guest-update --no-reboot +``` + +unterdrückt ausschließlich den automatischen **Host-Neustart**. Notwendige Neustarts erfolgreich aktualisierter Gäste können weiterhin durchgeführt werden. + +## Benachrichtigungen + +Der Updater kann das vorhandene **Proxmox Notification System** verwenden. SMTP-Zugangsdaten werden nicht im Updater gespeichert. + +Die Benachrichtigung enthält unter anderem Hoststatus, Backup-Schutz, LXC-/VM-Ergebnisse, Fehlerdetails, Full-upgrade-Hinweise und die getroffene Neustartentscheidung. + +Beispiel-Betreff: + +```text +Proxmox Updater - Erfolgreich +Proxmox Updater - FEHLER +``` + +## Check-Modus + +```bash +pve-guest-update --check +``` + +prüft Host und konfigurierte Gäste, ohne Updates zu installieren. Sind Proxmox-Benachrichtigungen aktiviert, verschickt auch der Check-Modus eine Zusammenfassung. + +```text +Proxmox Update-Check - Erfolgreich +Proxmox Update-Check - FEHLER +``` + +Es werden dabei **keine Updates installiert und keine automatischen Neustarts durchgeführt**. + +## Verwendung + +```bash +pve-guest-update +pve-guest-update --check +pve-guest-update --ct +pve-guest-update --vm +pve-guest-update --no-reboot +pve-guest-update --help +``` + +## Automatischer Zeitplan + +Der Installer richtet einen systemd-Timer ein. Wochentag und Uhrzeit können während der Installation ausgewählt werden. + +```bash +systemctl status pve-guest-update.timer +systemctl list-timers pve-guest-update.timer +``` + +Der Timer verwendet `Persistent=true`, sodass ein verpasster Lauf von systemd nachgeholt werden kann. + +## Logdatei + +```text +/var/log/pve-guest-update.log +``` + +```bash +tail -n 100 /var/log/pve-guest-update.log +tail -f /var/log/pve-guest-update.log +``` + +## Dateien + +```text +/usr/local/sbin/pve-guest-update +/etc/pve-guest-update.conf +/etc/systemd/system/pve-guest-update.service +/etc/systemd/system/pve-guest-update.timer +/var/log/pve-guest-update.log +``` + +## Aktualisierung des Updaters + +```bash +curl -fsSL https://gitea.vourx.com/sharky/Proxmox-und-GuestUpdater/raw/branch/main/install.sh | bash +``` + +Eine vorhandene Installation wird erkannt. Die aktuelle Konfiguration sowie der vorhandene Zeitplan werden eingelesen und können übernommen bzw. angepasst werden. + +## Ausschlussliste vollständig leeren + +```bash +curl -fsSL https://gitea.vourx.com/sharky/Proxmox-und-GuestUpdater/raw/branch/main/install.sh | bash -s -- --clear-excludes +``` + +## Deinstallation + +```bash +curl -fsSL https://gitea.vourx.com/sharky/Proxmox-und-GuestUpdater/raw/branch/main/install.sh | bash -s -- --uninstall +``` + +Die vorhandene Logdatei wird **absichtlich nicht gelöscht**. + +## Lizenz + +Für dieses Repository ist derzeit keine Lizenz angegeben.