Betrieb

Human Plugin im Tagesbetrieb.

Markdown

Updates

Betreiben Sie das latest-Image und aktualisieren Sie, wenn Unico ein Release ankündigt:

• Docker Compose: docker compose pull && docker compose up -d.
• Kubernetes: kubectl -n human-plugin rollout restart deployment/human-plugin, mit imagePullPolicy: Always.

Ein neues Release bereitet die benötigten Tabellen beim Start vor, noch bevor es Datenverkehr annimmt, sodass kein manueller Datenbankschritt nötig ist. Erstellen Sie vor dem Update in der Produktion ein Datenbank-Backup und prüfen Sie danach /health/ready sowie eine echte Create-Anfrage.

Zugangsdaten rotieren

Zugriffsschlüssel. Unico stellt den neuen Schlüssel mit einem Überlappungszeitraum aus. Aktualisieren Sie HUMAN_API_ACCESS_KEY in Ihrer .env oder Ihrem Secret, starten Sie Human Plugin neu (docker compose up -d --force-recreate oder kubectl -n human-plugin rollout restart deployment/human-plugin), bestätigen Sie, dass ein Create erfolgreich ist, und bitten Sie Unico dann, den alten Schlüssel zu widerrufen.

Registry-Zugangsdaten. Unico stellt ein neues Token aus, solange das alte noch funktioniert. Melden Sie sich mit dem neuen Token erneut an (oder erstellen Sie das Kubernetes-Pull-Secret neu), ziehen Sie das Image einmal zur Bestätigung und bitten Sie Unico dann, das alte Token zu widerrufen. Laufende Container sind davon nicht betroffen.

Datenbankpasswort. Ändern Sie es in PostgreSQL und in POSTGRES_PASSWORD und starten Sie Human Plugin anschließend neu.

Herunterfahren

Bei SIGTERM nimmt Human Plugin keine Verbindungen mehr an und wartet bis zu 55 Sekunden auf laufende Anfragen, da ein Create bis zu 30 Sekunden dauern und anschließend sein Ergebnis speichern kann. Setzen Sie das Stopp-Timeout auf mindestens 60 Sekunden. Ein abgebrochenes Create wird bei einem späteren Lesezugriff als fehlgeschlagen abgeschlossen.

Skalierung

Human Plugin hält keinen Anfragezustand im Arbeitsspeicher, daher können mehrere Container eine Datenbank teilen. Fügen Sie pro 1.500 Transaktionen pro Minute ein Replikat hinzu und erhöhen Sie max_connections von PostgreSQL auf 25 × Anzahl der Replikate + 10. Siehe Hardware-Anforderungen.

Der Attributkatalog

Human Plugin lädt den Attributkatalog einmalig beim Start herunter. Eine neue Katalogversion erreicht einen Container bei seinem nächsten Neustart. Wenn Sie Container nacheinander neu starten, bleibt der Dienst verfügbar.

Backups

Ihre Datenbank enthält die Intelligence, aus der data.ndocs berechnet wird. Sichern Sie sie mit Ihren eigenen Werkzeugen und testen Sie Wiederherstellungen. Geht die Datenbank verloren, geht die Intelligence verloren, und sie kann nicht neu aufgebaut werden.