README.md aktualisiert
This commit is contained in:
1 parent
c54176b428
commit
24ed27c903
1 file changed
@@ -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