Exécuter Human Plugin dans votre infrastructure

Un conteneur et une base de données PostgreSQL dans votre réseau, et vous êtes connecté à Unico.

Markdown

Prérequis

Prérequis	Détail
Environnement d'exécution de conteneurs	Docker, Docker Compose ou Kubernetes. L'image est construite pour linux/amd64 et linux/arm64 et s'exécute sans privilèges root
PostgreSQL	Version 16 ou ultérieure. Une base de données utilisée uniquement par Human Plugin, accessible avec un utilisateur et un mot de passe. SSL requis par défaut
HTTPS sortant	Vers Unico. Voir Réseau et sécurité
Entrant	Port 8080, HTTP simple, uniquement depuis votre back-end
Secrets	Votre clé d'accès et le mot de passe de la base de données

Exigences matérielles

Le minimum pour exécuter Human Plugin jusqu'à 1 500 transactions par minute, avec des selfies d'au plus 800 Ko.

Human Plugin

Ressource	Minimum
CPU	1 vCPU par réplique
Mémoire	1 Go par réplique

Pour un volume supérieur, ajoutez une réplique pour chaque tranche de 1 500 transactions par minute. Nous suggérons également d'exécuter plus d'une réplique, afin que Human Plugin reste disponible pendant le redémarrage de l'une d'elles.

PostgreSQL

Ressource	Minimum
Version	16
CPU	2 vCPU
Mémoire	4 Go
Disque	SSD

Pour estimer l'espace disque, comptez environ 1,7 Ko par processus × processus par jour × nombre de jours de conservation, plus 30 %.

Réseau

HTTPS sortant (port 443) vers Unico. Voir Réseau et sécurité.

L'image

Human Plugin est publié sous pkg.unico.run/human-plugin-api:latest. Exécutez toujours le tag latest, qui correspond à la version actuelle. Téléchargez-la avec les identifiants du registry (nom d'utilisateur et token) fournis par Unico. Voir Prérequis et accès.

Ordre de déploiement

1. Créez la base de données dédiée et un rôle pour Human Plugin.
2. Définissez la configuration, avec les secrets issus de votre gestionnaire de secrets.
3. Démarrez le conteneur avec Docker Compose ou Kubernetes, avec un délai d'arrêt d'au moins 60 secondes.
4. Attendez que GET /health/ready réponde 200 avant d'acheminer du trafic. Voir Santé et supervision.
5. Restreignez l'accès à votre back-end. Voir Réseau et sécurité.
6. Exécutez dessus la requête de création du Démarrage rapide.

Ce qui se passe au démarrage

Human Plugin télécharge le catalogue d'attributs, se connecte à PostgreSQL et prépare ses tables, puis ouvre le port. Il s'arrête avec une erreur, avant d'écouter, lorsque :

• un paramètre obligatoire est manquant ou invalide ;
• le catalogue d'attributs ne peut pas être téléchargé ;
• PostgreSQL est injoignable, ou le rôle ne peut pas créer de tables.

Le journal indique la raison. Voir Dépannage.

Plusieurs instances

Human Plugin ne conserve aucun état de requête en mémoire : plusieurs conteneurs peuvent donc partager une même base de données. Les conteneurs qui démarrent en même temps se coordonnent via la base de données, vous pouvez donc déployer les répliques ensemble.

Passage en production

• Maintenez le délai d'arrêt à 60 secondes ou plus.
• N'acheminez du trafic vers un conteneur qu'après que /health/ready a répondu 200.
• N'exposez jamais Human Plugin en dehors de votre réseau privé.
• Sauvegardez la base de données : elle contient votre intelligence. Voir Exploitation.