Files
Proxmox-und-GuestUpdater/README.md
T
2026-10-04 22:44:15 +02:00

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-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:

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.