# 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 und kann nach einem Update-Lauf 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 - Sichere Behandlung von notwendigen Neustarts - Automatischer Host-Neustart optional - Proxmox-Benachrichtigungen optional - Wöchentlicher systemd-Timer - Check-Modus ohne Installation von Updates - Gezielte Aktualisierung einzelner CTs oder VMs - Protokollierung nach `/var/log/pve-guest-update.log` ## 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 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 ### 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" ``` ## 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 ``` Beispiel: ``` bash qm agent 100 ping ``` Ohne erreichbaren QEMU Guest Agent kann eine laufende Debian-/Ubuntu-VM nicht automatisch aktualisiert werden. ## Update-Verhalten Für Debian-/Ubuntu-Systeme verwendet der Updater grundsätzlich: ``` bash apt-get update ``` und bei tatsächlich vorhandenen Paketänderungen: ``` bash DEBIAN_FRONTEND=noninteractive apt-get -y \ -o Dpkg::Options::="--force-confdef" \ -o Dpkg::Options::="--force-confold" \ full-upgrade ``` Vor dem eigentlichen Upgrade wird geprüft, ob Paketänderungen anstehen. Dadurch unterscheidet die Ausgabe zwischen: ``` text CT 101 (InfluxDB): bereits aktuell. ``` und: ``` text CT 101 (InfluxDB): Update erfolgreich. ``` In der Zusammenfassung werden entsprechend **aktualisiert**, **bereits aktuell**, **fehlgeschlagen** und **übersprungen** getrennt gezählt. ## Neustart-Logik Notwendige Neustarts werden nicht sofort während der Aktualisierung durchgeführt. Der Updater sammelt zunächst alle Neustart-Anforderungen und entscheidet erst am Ende des vollständigen Laufs. ### Fehlerfreier Lauf mit notwendigem Host-Reboot Wenn der Proxmox-Host einen Neustart benötigt und der gesamte Update-Lauf fehlerfrei war: - keine einzelnen CT-/VM-Neustarts - der Host übernimmt die Neustarts der Gäste - automatischer Host-Reboot nur, wenn er in der Konfiguration aktiviert ist ### Kein Host-Reboot erforderlich Benötigt der Host keinen Neustart, werden nur die Gäste neu gestartet, bei denen ein Neustart erforderlich ist. ### Fehler während des Laufs Sobald mindestens ein Fehler im Update-Lauf auftritt: - kein automatischer Host-Neustart - keine automatischen Gast-Neustarts Damit wird bei einem nicht vollständig erfolgreichen Lauf kein automatischer Neustart ausgelöst. ### `--no-reboot` Mit `--no-reboot` wird der automatische **Host-Neustart** unterdrückt. Notwendige Gast-Neustarts können weiterhin durchgeführt werden, sofern der Update-Lauf fehlerfrei war. ## Benachrichtigungen Der Updater kann das vorhandene **Proxmox Notification System** verwenden. SMTP-Zugangsdaten werden nicht im Updater gespeichert. Der Installer erkennt vorhandene Notification-Targets. Ist genau ein benutzerdefiniertes Target vorhanden, wird dieses automatisch ausgewählt. Das eingebaute Target `mail-to-root` wird dabei nicht gegenüber einem vorhandenen benutzerdefinierten Target bevorzugt. Sind keine geeigneten Benachrichtigungen eingerichtet, kann der Updater vollständig **ohne Mailversand** verwendet werden. Bei aktiviertem Versand enthält die Nachricht unter anderem: - Status des Proxmox-Hosts - Host-Reboot erforderlich: ja/nein - Anzahl aktualisierter LXCs - Anzahl bereits aktueller LXCs - fehlgeschlagene und übersprungene LXCs - Anzahl aktualisierter VMs - Anzahl bereits aktueller VMs - fehlgeschlagene und übersprungene VMs - Gesamtzahl der Fehler - Neustartentscheidung Beispiel-Betreff: ``` text Proxmox Updater - Erfolgreich ``` Bei einem fehlerhaften Lauf: ``` text Proxmox Updater - FEHLER ``` Der `--check`-Modus verschickt keine Update-Benachrichtigung. ## Verwendung ### Vollständigen Update-Lauf starten ``` bash pve-guest-update ``` ### Nur prüfen ``` bash pve-guest-update --check ``` Der Check-Modus prüft Host und Gäste, installiert aber keine Updates. ### Einzelnen LXC-Container aktualisieren ``` bash pve-guest-update --ct ``` Beispiel: ``` bash pve-guest-update --ct 101 ``` ### Einzelne VM aktualisieren ``` bash pve-guest-update --vm ``` Beispiel: ``` bash pve-guest-update --vm 100 ``` ### Host-Reboot unterdrücken ``` bash pve-guest-update --no-reboot ``` ## Automatischer Zeitplan Der Installer richtet einen systemd-Timer ein. Beispiel: ``` text Sonntag 03:00 Uhr ``` Status des Timers anzeigen: ``` bash systemctl status pve-guest-update.timer ``` Nächsten geplanten Lauf anzeigen: ``` bash systemctl list-timers pve-guest-update.timer ``` ## Logdatei Alle Läufe werden protokolliert: ``` text /var/log/pve-guest-update.log ``` Beispiel: ``` bash tail -n 100 /var/log/pve-guest-update.log ``` Live mitlesen: ``` bash tail -f /var/log/pve-guest-update.log ``` ## Beispiel einer Zusammenfassung ``` text ============================================================ Ergebnis ============================================================ LXC aktualisiert: 0 LXC bereits aktuell: 7 LXC fehlgeschlagen: 0 LXC übersprungen: 1 VM aktualisiert: 0 VM bereits aktuell: 2 VM fehlgeschlagen: 0 VM übersprungen: 2 Fehler gesamt: 0 Host Update: yes Host Reboot nötig: no ============================================================ ``` ## 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 Zum Aktualisieren einfach den Installer erneut ausführen: ``` 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 wird eingelesen und kann übernommen werden. ## Hinweise Das Skript ist für die zentrale Pflege von Proxmox-Systemen mit Debian-/Ubuntu-Gästen gedacht. Vor dem produktiven Einsatz sollte die Konfiguration insbesondere hinsichtlich Ausschlussliste, gestoppter Gäste, automatischer Neustarts und Benachrichtigungen geprüft werden. ## Lizenz Für dieses Repository ist derzeit keine Lizenz angegeben.