diff --git a/README.md b/README.md deleted file mode 100644 index 5c16103..0000000 --- a/README.md +++ /dev/null @@ -1,387 +0,0 @@ -# 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 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.