Votre clé d'accès et la connexion à votre base de données. Une valeur manquante ou invalide empêche le démarrage.
Human Plugin lit sa configuration dans l'environnement une seule fois, au démarrage. Modifier une valeur nécessite de redémarrer le conteneur.
Référence rapide
Le fichier .env minimal pour une base de données qui utilise les valeurs par défaut ci-dessous :
HUMAN_API_ACCESS_KEY=<your access key>
POSTGRES_ADDRESS_HOST=<database host>
POSTGRES_PASSWORD=<database password>
Clé d'accès
| Variable | Obligatoire | Remarques |
|---|---|---|
HUMAN_API_ACCESS_KEY | Oui | Votre clé d'accès. Elle relie l'installation à Unico et identifie votre compte. Sans espace ni caractère de contrôle. Jamais journalisée |
La clé d'accès est un secret. Conservez-la dans votre gestionnaire de secrets et injectez-la dans le conteneur à l'exécution.
Connexion à la base de données
| Variable | Obligatoire | Valeur par défaut | Remarques |
|---|---|---|---|
POSTGRES_ADDRESS_HOST | Oui | Nom d'hôte ou adresse IP de votre serveur PostgreSQL | |
POSTGRES_PASSWORD | Oui | Sans espace, apostrophe, barre oblique inverse ni caractère de contrôle. Human Plugin refuse de démarrer si l'un d'eux est présent, sans journaliser la valeur | |
POSTGRES_ADDRESS_PORT | Non | 5432 | |
POSTGRES_USER | Non | postgres | Utilisez un rôle dédié à Human Plugin |
POSTGRES_DATABASE | Non | human_plugin | Utilisez une base de données dédiée à Human Plugin |
POSTGRES_SSL_MODE | Non | require | N'utilisez disable que lorsque PostgreSQL s'exécute sur le même hôte ou en conteneur sidecar |
La base de données doit être utilisée uniquement par Human Plugin. Le rôle doit avoir le droit d'y créer des tables : Human Plugin crée et met à jour ses propres tables au démarrage, avant d'accepter des requêtes.
Le mot de passe est un secret. Conservez-le dans votre gestionnaire de secrets, comme la clé d'accès.
Tout le reste
L'image définit toutes les autres valeurs. Ne définissez pas d'autres variables, sauf si Unico vous le demande : elles ne font pas partie de la configuration prise en charge.
Exemple
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 sans valeur transmet la variable depuis votre shell, de sorte que les secrets n'apparaissent pas dans la ligne de commande.