388 lines
8.8 KiB
Markdown
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.
|