# 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.