README.md gelöscht
This commit is contained in:
1 parent
00ed932b79
commit
c54176b428
1 file changed
-387
@@ -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 <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.
|
|
||||||
Reference in new issue
Block a user