---
title: Exécuter Human Plugin dans votre infrastructure
description: Ce que implique l'exécution de Human Plugin — un conteneur et votre base de données PostgreSQL — et l'ordre d'un déploiement.
canonical: https://developer.unico.io/fr/human-plugin/self-hosting/overview
locale: fr
generated_by: markdown-export
---

# 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.

```mermaid
flowchart LR
  A[Your back-end] --> B[Human Plugin container]
  B --> C[(Your PostgreSQL, dedicated)]
```

## 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é](/fr/human-plugin/self-hosting/networking-and-security) |
| 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 |

<a id="hardware-requirements"></a>

## 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é](/fr/human-plugin/self-hosting/networking-and-security).

## 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](/fr/human-plugin/get-started/prerequisites).

## 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](/fr/human-plugin/self-hosting/configuration), avec les secrets issus de votre gestionnaire de secrets.
3. Démarrez le conteneur avec [Docker Compose](/fr/human-plugin/self-hosting/docker-compose) ou [Kubernetes](/fr/human-plugin/self-hosting/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](/fr/human-plugin/self-hosting/health-and-monitoring).
5. Restreignez l'accès à votre back-end. Voir [Réseau et sécurité](/fr/human-plugin/self-hosting/networking-and-security).
6. Exécutez dessus la requête de création du [Démarrage rapide](/fr/human-plugin/get-started/quickstart#3-create-a-process).

## Ce qui se passe au démarrage

Human Plugin télécharge le [catalogue d'attributs](/fr/human-plugin/additional-resources/attribute-catalog), 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](/fr/human-plugin/additional-resources/troubleshooting).

## 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](/fr/human-plugin/self-hosting/operations).