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