9.9 KiB
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-upgradeerfordern 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:
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:
/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:
EXCLUDE_GUESTS="107 105 210"
Alle Ausschlüsse können später ohne erneute vollständige Konfiguration entfernt werden:
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:
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:
qm agent <VM-ID> 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:
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:
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
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:
Proxmox Updater - Erfolgreich
Proxmox Updater - FEHLER
Check-Modus
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.
Proxmox Update-Check - Erfolgreich
Proxmox Update-Check - FEHLER
Es werden dabei keine Updates installiert und keine automatischen Neustarts durchgeführt.
Verwendung
pve-guest-update
pve-guest-update --check
pve-guest-update --ct <ID>
pve-guest-update --vm <ID>
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.
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
/var/log/pve-guest-update.log
tail -n 100 /var/log/pve-guest-update.log
tail -f /var/log/pve-guest-update.log
Dateien
/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
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
curl -fsSL https://gitea.vourx.com/sharky/Proxmox-und-GuestUpdater/raw/branch/main/install.sh | bash -s -- --clear-excludes
Deinstallation
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.