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

388 lines
8.8 KiB
Markdown

# 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 <VM-ID> 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 <ID>
```
Beispiel:
``` bash
pve-guest-update --ct 101
```
### Einzelne VM aktualisieren
``` bash
pve-guest-update --vm <ID>
```
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.