Zum Hauptinhalt springen
Konfiguration

Ihr Zugriffsschlüssel und die Verbindung zu Ihrer Datenbank. Ein fehlender oder ungültiger Wert verhindert den Start.

Markdown

Human Plugin liest seine Konfiguration einmalig beim Start aus der Umgebung. Eine Änderung erfordert den Neustart des Containers.

Kurzreferenz​

Die minimale .env für eine Datenbank, die die unten genannten Standardwerte verwendet:

.env
HUMAN_API_ACCESS_KEY=<your access key>
POSTGRES_ADDRESS_HOST=<database host>
POSTGRES_PASSWORD=<database password>

Zugriffsschlüssel​

VariableErforderlichHinweise
HUMAN_API_ACCESS_KEYJaIhr Zugriffsschlüssel. Er verbindet die Installation mit Unico und identifiziert Ihr Konto. Keine Leerzeichen oder Steuerzeichen. Wird nie protokolliert

Der Zugriffsschlüssel ist ein Geheimnis. Bewahren Sie ihn in Ihrem Secret Store auf und injizieren Sie ihn zur Laufzeit in den Container.

Datenbankverbindung​

VariableErforderlichStandardHinweise
POSTGRES_ADDRESS_HOSTJaHostname oder IP-Adresse Ihres PostgreSQL-Servers
POSTGRES_PASSWORDJaKeine Leerzeichen, einfachen Anführungszeichen, Backslashes oder Steuerzeichen. Human Plugin verweigert in diesem Fall den Start, ohne den Wert zu protokollieren
POSTGRES_ADDRESS_PORTNein5432
POSTGRES_USERNeinpostgresVerwenden Sie eine eigene Rolle für Human Plugin
POSTGRES_DATABASENeinhuman_pluginVerwenden Sie eine eigene Datenbank für Human Plugin
POSTGRES_SSL_MODENeinrequireVerwenden Sie disable nur, wenn PostgreSQL auf demselben Host oder als Sidecar läuft

Die Datenbank darf ausschließlich von Human Plugin genutzt werden. Die Rolle benötigt die Berechtigung, darin Tabellen zu erstellen: Human Plugin erstellt und aktualisiert seine eigenen Tabellen beim Start, bevor es Anfragen annimmt.

Das Passwort ist ein Geheimnis. Bewahren Sie es wie den Zugriffsschlüssel in Ihrem Secret Store auf.

Alles Weitere​

Das Image setzt alle übrigen Werte. Setzen Sie keine weiteren Variablen, es sei denn, Unico fordert Sie dazu auf: Sie gehören nicht zur unterstützten Konfiguration.

Beispiel​

docker run -d --name human-plugin --stop-timeout 60 -p 127.0.0.1:8080:8080 \
-e HUMAN_API_ACCESS_KEY \
-e POSTGRES_ADDRESS_HOST=db.internal \
-e POSTGRES_USER=human_plugin \
-e POSTGRES_PASSWORD \
pkg.unico.run/human-plugin-api:latest

-e NAME ohne Wert übernimmt die Variable aus Ihrer Shell, sodass die Geheimnisse nicht in der Befehlszeile erscheinen.