From 86d5933d33345296a69835a016b68582c6e0a047 Mon Sep 17 00:00:00 2001 From: sharky Date: Sun, 4 Oct 2026 17:04:10 +0200 Subject: [PATCH] Dateien nach "/" hochladen --- README.md | 388 +++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 386 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index c62ef8c..5c16103 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,387 @@ -# Proxmox-und-GuestUpdater +# Proxmox und Guest Updater -Automatische Updates für Proxmox VE, VM und LXC-Container \ No newline at end of file +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 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 +``` + +Beispiel: + +``` bash +pve-guest-update --ct 101 +``` + +### Einzelne VM aktualisieren + +``` bash +pve-guest-update --vm +``` + +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.