Dateien nach "/" hochladen
This commit is contained in:
1 parent
85e0b5af3e
commit
00ed932b79
1 file changed
+283
+283
@@ -0,0 +1,283 @@
|
|||||||
|
# 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, berücksichtigt laufende Proxmox-Backups und kann nach einem Update- oder Prüflauf 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
|
||||||
|
- Fehlerhafte Gäste werden von automatischen Gast-Neustarts ausgeschlossen
|
||||||
|
- Sichere Behandlung notwendiger Neustarts
|
||||||
|
- Automatischer Host-Neustart optional
|
||||||
|
- Schutz vor Updates und Neustarts während laufender Proxmox-Backups
|
||||||
|
- Prüfung des Update-Zeitplans auf mögliche Überschneidungen mit Proxmox-Backup-Jobs
|
||||||
|
- Proxmox-Benachrichtigungen optional
|
||||||
|
- Wöchentlicher systemd-Timer
|
||||||
|
- Check-Modus ohne Installation von Updates
|
||||||
|
- Gezielte Aktualisierung einzelner CTs oder VMs
|
||||||
|
- Zusätzliche Prüfung auf Paketänderungen, die ein `full-upgrade` erfordern würden
|
||||||
|
- Protokollierung nach `/var/log/pve-guest-update.log`
|
||||||
|
- Vorhandene Installation kann über den Installer aktualisiert werden
|
||||||
|
- Ausschlussliste kann über den Installer vollständig geleert werden
|
||||||
|
- Updater kann über den Installer vollständig entfernt werden
|
||||||
|
|
||||||
|
## 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 sowie den systemd-Service 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
|
||||||
|
- Wartezeit auf APT-/DPKG-Sperren
|
||||||
|
- maximale Wartezeit auf laufende Proxmox-Backups
|
||||||
|
|
||||||
|
### 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"
|
||||||
|
```
|
||||||
|
|
||||||
|
Alle Ausschlüsse können später ohne erneute vollständige Konfiguration entfernt werden:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -fsSL https://gitea.vourx.com/sharky/Proxmox-und-GuestUpdater/raw/branch/main/install.sh | bash -s -- --clear-excludes
|
||||||
|
```
|
||||||
|
|
||||||
|
## 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
|
||||||
|
```
|
||||||
|
|
||||||
|
Ohne erreichbaren QEMU Guest Agent kann eine laufende Debian-/Ubuntu-VM nicht automatisch aktualisiert werden.
|
||||||
|
|
||||||
|
## Update-Verhalten
|
||||||
|
|
||||||
|
Für Debian-/Ubuntu-Systeme wird zunächst `apt-get update` ausgeführt. Anschließend prüft der Updater, ob Paketänderungen vorhanden sind.
|
||||||
|
|
||||||
|
Die Aktualisierung der Gäste erfolgt mit `apt-get upgrade` unter Verwendung nichtinteraktiver DPKG-Einstellungen, damit vorhandene Konfigurationsdateien nicht ungefragt ersetzt werden.
|
||||||
|
|
||||||
|
Der Proxmox-Host wird mit `full-upgrade` aktualisiert. Vorher wird über eine Simulation geprüft, ob tatsächlich Paketänderungen erforderlich sind.
|
||||||
|
|
||||||
|
## Full-upgrade-Prüfung der Gäste
|
||||||
|
|
||||||
|
Nach der normalen Aktualisierung eines unterstützten Gastes führt der Updater zusätzlich eine Simulation von:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
apt-get -s full-upgrade
|
||||||
|
```
|
||||||
|
|
||||||
|
durch. Dadurch können Paketänderungen erkannt werden, die durch das normale `upgrade` nicht durchgeführt wurden.
|
||||||
|
|
||||||
|
Der Updater führt bei Gästen nicht automatisch ein `full-upgrade` durch. Die Ausgabe dient als Hinweis für eine anschließende manuelle Prüfung.
|
||||||
|
|
||||||
|
## Schutz vor Proxmox-Backups
|
||||||
|
|
||||||
|
Vor einem normalen Update-Lauf prüft der Updater, ob aktuell ein Proxmox-Backup über `vzdump` läuft. Ist ein Backup aktiv, wartet der Updater zunächst auf dessen Ende.
|
||||||
|
|
||||||
|
Standardmäßig gilt:
|
||||||
|
|
||||||
|
```text
|
||||||
|
BACKUP_WAIT_TIMEOUT="7200"
|
||||||
|
BACKUP_WAIT_INTERVAL="60"
|
||||||
|
```
|
||||||
|
|
||||||
|
Damit wartet der Updater maximal **2 Stunden** und prüft alle **60 Sekunden**, ob das Backup beendet wurde. Auch unmittelbar vor automatischen Neustarts wird erneut geprüft, ob inzwischen ein Proxmox-Backup läuft.
|
||||||
|
|
||||||
|
### Prüfung des geplanten Zeitpunkts
|
||||||
|
|
||||||
|
Der Installer liest vorhandene Proxmox-Backup-Jobs aus und vergleicht deren Startzeiten mit dem gewählten Update-Zeitpunkt. Liegt eine Backup-Startzeit innerhalb eines Sicherheitsfensters von **±2 Stunden** um den Updater-Start, wird eine Warnung angezeigt.
|
||||||
|
|
||||||
|
## Neustart-Logik
|
||||||
|
|
||||||
|
Notwendige Neustarts werden nicht sofort während der Aktualisierung durchgeführt. Der Updater sammelt zunächst die Neustart-Anforderungen und entscheidet erst am Ende des Update-Laufs.
|
||||||
|
|
||||||
|
### Fehlerfreier Lauf mit notwendigem Host-Reboot
|
||||||
|
|
||||||
|
Wenn der Proxmox-Host erfolgreich aktualisiert wurde und einen Neustart benötigt, werden keine einzelnen CT-/VM-Neustarts durchgeführt, wenn ein automatischer Host-Reboot erfolgt. Der Host-Neustart übernimmt gleichzeitig die notwendigen Neustarts der laufenden Gäste.
|
||||||
|
|
||||||
|
### Kein automatischer Host-Reboot
|
||||||
|
|
||||||
|
Findet kein automatischer Host-Reboot statt, werden notwendige Gast-Neustarts einzeln verarbeitet. Das gilt auch bei `--no-reboot` oder bei einem gezielten CT-/VM-Lauf.
|
||||||
|
|
||||||
|
### Fehler während des Laufs
|
||||||
|
|
||||||
|
Ein Fehler bei einem Gast verhindert **nicht** automatisch alle Neustarts. Fehlerhafte Gäste werden intern markiert und nicht automatisch einzeln neu gestartet. Erfolgreich aktualisierte Gäste können weiterhin neu gestartet werden, wenn dies erforderlich ist.
|
||||||
|
|
||||||
|
Auch ein notwendiger Host-Neustart kann weiterhin durchgeführt werden, wenn das Host-Update selbst erfolgreich war, der automatische Host-Reboot aktiviert ist, `--no-reboot` nicht verwendet wurde und kein laufendes Proxmox-Backup den Neustart blockiert.
|
||||||
|
|
||||||
|
### `--no-reboot`
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pve-guest-update --no-reboot
|
||||||
|
```
|
||||||
|
|
||||||
|
unterdrückt ausschließlich den automatischen **Host-Neustart**. Notwendige Neustarts erfolgreich aktualisierter Gäste können weiterhin durchgeführt werden.
|
||||||
|
|
||||||
|
## Benachrichtigungen
|
||||||
|
|
||||||
|
Der Updater kann das vorhandene **Proxmox Notification System** verwenden. SMTP-Zugangsdaten werden nicht im Updater gespeichert.
|
||||||
|
|
||||||
|
Die Benachrichtigung enthält unter anderem Hoststatus, Backup-Schutz, LXC-/VM-Ergebnisse, Fehlerdetails, Full-upgrade-Hinweise und die getroffene Neustartentscheidung.
|
||||||
|
|
||||||
|
Beispiel-Betreff:
|
||||||
|
|
||||||
|
```text
|
||||||
|
Proxmox Updater - Erfolgreich
|
||||||
|
Proxmox Updater - FEHLER
|
||||||
|
```
|
||||||
|
|
||||||
|
## Check-Modus
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pve-guest-update --check
|
||||||
|
```
|
||||||
|
|
||||||
|
prüft Host und konfigurierte Gäste, ohne Updates zu installieren. Sind Proxmox-Benachrichtigungen aktiviert, verschickt auch der Check-Modus eine Zusammenfassung.
|
||||||
|
|
||||||
|
```text
|
||||||
|
Proxmox Update-Check - Erfolgreich
|
||||||
|
Proxmox Update-Check - FEHLER
|
||||||
|
```
|
||||||
|
|
||||||
|
Es werden dabei **keine Updates installiert und keine automatischen Neustarts durchgeführt**.
|
||||||
|
|
||||||
|
## Verwendung
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pve-guest-update
|
||||||
|
pve-guest-update --check
|
||||||
|
pve-guest-update --ct <ID>
|
||||||
|
pve-guest-update --vm <ID>
|
||||||
|
pve-guest-update --no-reboot
|
||||||
|
pve-guest-update --help
|
||||||
|
```
|
||||||
|
|
||||||
|
## Automatischer Zeitplan
|
||||||
|
|
||||||
|
Der Installer richtet einen systemd-Timer ein. Wochentag und Uhrzeit können während der Installation ausgewählt werden.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
systemctl status pve-guest-update.timer
|
||||||
|
systemctl list-timers pve-guest-update.timer
|
||||||
|
```
|
||||||
|
|
||||||
|
Der Timer verwendet `Persistent=true`, sodass ein verpasster Lauf von systemd nachgeholt werden kann.
|
||||||
|
|
||||||
|
## Logdatei
|
||||||
|
|
||||||
|
```text
|
||||||
|
/var/log/pve-guest-update.log
|
||||||
|
```
|
||||||
|
|
||||||
|
```bash
|
||||||
|
tail -n 100 /var/log/pve-guest-update.log
|
||||||
|
tail -f /var/log/pve-guest-update.log
|
||||||
|
```
|
||||||
|
|
||||||
|
## 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
|
||||||
|
|
||||||
|
```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 sowie der vorhandene Zeitplan werden eingelesen und können übernommen bzw. angepasst werden.
|
||||||
|
|
||||||
|
## Ausschlussliste vollständig leeren
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -fsSL https://gitea.vourx.com/sharky/Proxmox-und-GuestUpdater/raw/branch/main/install.sh | bash -s -- --clear-excludes
|
||||||
|
```
|
||||||
|
|
||||||
|
## Deinstallation
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -fsSL https://gitea.vourx.com/sharky/Proxmox-und-GuestUpdater/raw/branch/main/install.sh | bash -s -- --uninstall
|
||||||
|
```
|
||||||
|
|
||||||
|
Die vorhandene Logdatei wird **absichtlich nicht gelöscht**.
|
||||||
|
|
||||||
|
## Lizenz
|
||||||
|
|
||||||
|
Für dieses Repository ist derzeit keine Lizenz angegeben.
|
||||||
Reference in new issue
Block a user