Files
2026-10-04 22:44:15 +02:00

284 lines
9.9 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, 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`:
```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 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:
```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
- 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:
```text
EXCLUDE_GUESTS="107 105 210"
```
Alle Ausschlüsse können später ohne erneute vollständige Konfiguration entfernt werden:
```bash
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:
```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
```
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:
```bash
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:
```text
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`
```bash
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:
```text
Proxmox Updater - Erfolgreich
Proxmox Updater - FEHLER
```
## Check-Modus
```bash
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.
```text
Proxmox Update-Check - Erfolgreich
Proxmox Update-Check - FEHLER
```
Es werden dabei **keine Updates installiert und keine automatischen Neustarts durchgeführt**.
## Verwendung
```bash
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.
```bash
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
```text
/var/log/pve-guest-update.log
```
```bash
tail -n 100 /var/log/pve-guest-update.log
tail -f /var/log/pve-guest-update.log
```
## 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
```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 sowie der vorhandene Zeitplan werden eingelesen und können übernommen bzw. angepasst werden.
## Ausschlussliste vollständig leeren
```bash
curl -fsSL https://gitea.vourx.com/sharky/Proxmox-und-GuestUpdater/raw/branch/main/install.sh | bash -s -- --clear-excludes
```
## Deinstallation
```bash
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.