updates2mqtt¶

Zusammenfassung¶

Lassen Sie Home Assistant Sie über neue Updates zu Docker-Images für Ihre Container informieren.

Lesen Sie die Versionshinweise und klicken Sie optional auf Aktualisieren, um einen Docker pull (oder optional build) und eine Aktualisierung auszulösen.

Beschreibung¶

Updates2MQTT prüft regelmäßig auf neue Versionen verfügbarer Komponenten und veröffentlicht neue Versionsinformationen über MQTT. Die automatische HomeAssistant-Erkennung wird unterstützt, sodass alle Updates an derselben Stelle wie Home Assistants eigene Komponenten und Add-ins angezeigt werden können.

Derzeit werden nur Docker-Container unterstützt, entweder über eine Image-Registry-Prüfung (unter Verwendung von v1 Docker-APIs oder der OCI v2 API) oder einem Git-Repository als Quelle (siehe Lokale Builds), mit spezifischer Unterstützung für Docker, Github Container Registry, Gitlab, Codeberg, Microsoft Container Registry, Quay und LinuxServer Registry, mit adaptivem Verhalten für die meisten anderen. Das Design ist modular, sodass weitere Update-Quellen hinzugefügt werden können, zumindest für Benachrichtigungen. Als nächstes ist apt für Debian-basierte Systeme geplant.

Komponenten können auch aktualisiert werden, entweder automatisch oder ausgelöst über MQTT, zum Beispiel durch Klicken auf die Schaltfläche Installieren im HomeAssistant-Aktualisierungsdialog. Icons und Versionshinweise können für ein besseres HA-Erlebnis angegeben werden. Weitere Details unter Home Assistant Integration.

Lesen Sie zum Einstieg die Seiten Installation und Konfiguration.

Für einen schnellen Einstieg versuchen Sie Folgendes:

docker run -v /var/run/docker.sock:/var/run/docker.sock -e MQTT_USER=user1 -e MQTT_PASS=user1 -e MQTT_HOST=192.168.1.5 ghcr.io/rhizomatics/updates2mqtt:latest

oder ohne Docker mit uv

export MQTT_HOST=192.168.1.1;export MQTT_USER=user1;export MQTT_PASS=user1;uv run --with updates2mqtt python -m updates2mqtt

Es enthält auch ein einfaches Befehlszeilentool, das die Analyse für einen einzelnen laufenden Container durchführt oder Manifeste, JSON-Blobs und Tag-Listen aus Remote-Registries abruft (funktioniert nachweislich mit GitHub, GitLab, Codeberg, Quay, LSCR und Microsoft MCR).

Release-Unterstützung¶

Derzeit werden nur Docker-Container unterstützt, andere sind geplant, wahrscheinlich mit Priorität für apt.

Heartbeat¶

Ein Heartbeat-JSON-Payload wird optional regelmäßig an ein konfigurierbares MQTT-Topic veröffentlicht, standardmäßig healthcheck/{node_name}/updates2mqtt. Es enthält die aktuelle Version von Updates2MQTT, den Node-Namen, einen Zeitstempel und einige grundlegende Statistiken.

Gesundheitsprüfung¶

Ein healthcheck.sh-Skript ist im Docker-Image enthalten und kann als Docker-Healthcheck verwendet werden, wenn die Container-Umgebungsvariablen MQTT_HOST, MQTT_PORT, MQTT_USER und MQTT_PASS gesetzt sind. Es verwendet das Linux-Paket mosquitto-clients, das den Befehl mosquitto_sub zum Abonnieren von Topics bereitstellt.

Ein weiterer Ansatz ist die Verwendung eines Restarter-Dienstes direkt in Docker Compose, um einen Neustart zu erzwingen, in diesem Fall einmal täglich:

restarter:
    image: docker:cli
    volumes: ["/var/run/docker.sock:/var/run/docker.sock"]
    command: ["/bin/sh", "-c", "while true; do sleep 86400; docker restart updates2mqtt; done"]
    restart: unless-stopped
    environment:
      - UPD2MQTT_UPDATE=AUTO

Ziel-Container¶

Während updates2mqtt alle unter dem Docker-Daemon laufenden Container erkennt und überwacht, gibt es einige Optionen, um das Verhalten für diese Container anzupassen.

Dies geschieht durch Hinzufügen von Umgebungsvariablen oder Docker-Labels zu den Containern, typischerweise in einer .env-Datei oder als environment-Optionen in docker-compose.yaml.

Automatische Updates¶

Wenn Docker-Container sofort aktualisiert werden sollen, ohne Bestätigung oder Auslöser, z.B. aus dem HomeAssistant-Aktualisierungsdialog, dann setzen Sie die Umgebungsvariable UPD2MQTT_UPDATE im Ziel-Container auf Auto (Standard ist Passive). Wenn Sie ohne MQTT-Veröffentlichung und ohne Sichtbarkeit für Home Assistant aktualisieren möchten, verwenden Sie Silent.

restarter:
    image: docker:cli
    command: ["/bin/sh", "-c", "while true; do sleep 86400; docker restart mailserver; done"]
    environment:
      - UPD2MQTT_UPDATE=AUTO

Automatische Updates können auch für lokale Builds gelten, bei denen ein git_repo_path definiert wurde – wenn remote Commits zum Abrufen verfügbar sind, werden git pull, docker compose build und docker compose up ausgeführt.

Verwandte Projekte¶

Weitere nützliche Apps für Self-Hosting mit MQTT:

• psmqtt - Systemeigenschaften und Metriken über MQTT melden

Mehr unter awesome-mqtt

Für einen leistungsstärkeren Docker-fokussierten Update-Manager probieren Sie What’s Up Docker

Entwicklung¶

Diese Komponente basiert auf mehreren Open-Source-Paketen:

• docker-py Python SDK für den Zugriff auf Docker-APIs
• Eclipse Paho MQTT-Client
• OmegaConf für Konfiguration und Validierung
• structlog für strukturiertes Logging und rich für bessere Ausnahmeberichte
• hishel zum Cachen von Metadaten
• httpx zum Abrufen von Metadaten
• Die Astral-Tools uv und ruff für Entwicklung und Build
• pytest und unterstützende Add-ins für automatisierte Tests
• usingversion zur Protokollierung aktueller Versionsinformationen

Rhizomatics Open Source für Home Assistant¶

HACS¶

• AutoArm - Automatisches Scharf- und Unscharfschalten von Home Assistant Alarmzentralen mit physischen Tasten, Anwesenheit, Kalendern, Sonne und mehr
• Remote Logger - OpenTelemetry (OTLP) und Syslog-Ereigniserfassung für Home Assistant
• Supernotify - Einheitliche Benachrichtigung für einfaches Multi-Kanal-Messaging, einschließlich leistungsstarker Türklingel- und Sicherheitskamera-Integration.

Python / Docker¶

• Anpr2MQTT - Integration mit ANPR/ALPR-Kennzeichenkameras über Dateisystem (NAS/FTP) zu MQTT mit optionaler Bildanalyse und UK-DVLA-Integration.