8.8 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 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:
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:
/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:
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:
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
Beispiel:
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:
apt-get update
und bei tatsächlich vorhandenen Paketänderungen:
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:
CT 101 (InfluxDB): bereits aktuell.
und:
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:
Proxmox Updater - Erfolgreich
Bei einem fehlerhaften Lauf:
Proxmox Updater - FEHLER
Der --check-Modus verschickt keine Update-Benachrichtigung.
Verwendung
Vollständigen Update-Lauf starten
pve-guest-update
Nur prüfen
pve-guest-update --check
Der Check-Modus prüft Host und Gäste, installiert aber keine Updates.
Einzelnen LXC-Container aktualisieren
pve-guest-update --ct <ID>
Beispiel:
pve-guest-update --ct 101
Einzelne VM aktualisieren
pve-guest-update --vm <ID>
Beispiel:
pve-guest-update --vm 100
Host-Reboot unterdrücken
pve-guest-update --no-reboot
Automatischer Zeitplan
Der Installer richtet einen systemd-Timer ein.
Beispiel:
Sonntag 03:00 Uhr
Status des Timers anzeigen:
systemctl status pve-guest-update.timer
Nächsten geplanten Lauf anzeigen:
systemctl list-timers pve-guest-update.timer
Logdatei
Alle Läufe werden protokolliert:
/var/log/pve-guest-update.log
Beispiel:
tail -n 100 /var/log/pve-guest-update.log
Live mitlesen:
tail -f /var/log/pve-guest-update.log
Beispiel einer Zusammenfassung
============================================================
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
/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:
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.