Human Plugin in Ihrer Infrastruktur betreiben

Ein Container und eine PostgreSQL-Datenbank in Ihrem Netzwerk, und Sie sind mit Unico verbunden.

Markdown

Voraussetzungen

Voraussetzung	Detail
Container-Laufzeit	Docker, Docker Compose oder Kubernetes. Das Image wird für linux/amd64 und linux/arm64 gebaut und läuft als Nicht-Root
PostgreSQL	Version 16 oder höher. Eine Datenbank, die nur von Human Plugin verwendet wird und mit Benutzer und Passwort erreichbar ist. SSL ist standardmäßig erforderlich
Ausgehendes HTTPS	Zu Unico. Siehe Netzwerk und Sicherheit
Eingehend	Port 8080, reines HTTP, nur von Ihrem Back-end
Secrets	Ihr Zugriffsschlüssel und das Datenbankpasswort

Hardware-Anforderungen

Das Minimum, um Human Plugin mit bis zu 1.500 Transaktionen pro Minute zu betreiben, mit Selfies von bis zu 800 KB.

Human Plugin

Ressource	Minimum
CPU	1 vCPU pro Replikat
Arbeitsspeicher	1 GB pro Replikat

Für mehr Volumen fügen Sie pro 1.500 Transaktionen pro Minute ein Replikat hinzu. Wir empfehlen außerdem, mehr als ein Replikat zu betreiben, damit Human Plugin verfügbar bleibt, während eines neu startet.

PostgreSQL

Ressource	Minimum
Version	16
CPU	2 vCPU
Arbeitsspeicher	4 GB
Festplatte	SSD

Zur Abschätzung des Speicherplatzes rechnen Sie etwa 1,7 KB pro Prozess × Prozesse pro Tag × die Tage, die Sie aufbewahren, plus 30 %.

Netzwerk

Ausgehendes HTTPS (Port 443) zu Unico. Siehe Netzwerk und Sicherheit.

Das Image

Human Plugin wird als pkg.unico.run/human-plugin-api:latest veröffentlicht. Betreiben Sie immer das Tag latest, das dem aktuellen Release entspricht. Rufen Sie es mit den Registry-Zugangsdaten (Benutzername und Token) ab, die Unico Ihnen gibt. Siehe Voraussetzungen und Zugang.

Reihenfolge der Bereitstellung

1. Erstellen Sie die dedizierte Datenbank und eine Rolle für Human Plugin.
2. Legen Sie die Konfiguration fest, mit den Secrets aus Ihrem Secret Store.
3. Starten Sie den Container mit Docker Compose oder Kubernetes, mit einem Stopp-Timeout von mindestens 60 Sekunden.
4. Warten Sie, bis GET /health/ready mit 200 antwortet, bevor Sie Datenverkehr weiterleiten. Siehe Health und Monitoring.
5. Beschränken Sie den Zugriff auf Ihr Back-end. Siehe Netzwerk und Sicherheit.
6. Führen Sie die Create-Anfrage aus dem Quickstart dagegen aus.

Was beim Start passiert

Human Plugin lädt den Attributkatalog herunter, verbindet sich mit PostgreSQL und bereitet seine Tabellen vor und öffnet dann den Port. Es bricht mit einem Fehler ab, bevor es lauscht, wenn:

• eine erforderliche Einstellung fehlt oder ungültig ist;
• der Attributkatalog nicht heruntergeladen werden kann;
• PostgreSQL nicht erreichbar ist oder die Rolle keine Tabellen erstellen kann.

Das Protokoll nennt den Grund. Siehe Fehlerbehebung.

Mehrere Instanzen

Human Plugin hält keinen Anfragezustand im Arbeitsspeicher, daher können mehrere Container eine Datenbank teilen. Container, die gleichzeitig starten, koordinieren sich über die Datenbank, sodass Sie Replikate gemeinsam ausrollen können.

Weg in die Produktion

• Halten Sie das Stopp-Timeout bei 60 Sekunden oder mehr.
• Leiten Sie Datenverkehr erst an einen Container, wenn /health/ready mit 200 antwortet.
• Machen Sie Human Plugin niemals außerhalb Ihres privaten Netzwerks zugänglich.
• Sichern Sie die Datenbank: Sie enthält Ihre Intelligence. Siehe Betrieb.