Prérequis techniques¶
Cette section décrit les exigences minimales et recommandées pour exécuter SPIE HUB IA. Le logiciel peut fonctionner dans différents environnements d'execution de conteneurs : Docker, Podman, Kubernetes, etc.
Matériel & OS¶
| Élément | Minimum |
|---|---|
| CPU | 2 vCPU |
| RAM | 4 Go |
| Stockage | 20 Go libres |
| OS | Linux (Debian/Ubuntu) |
💡 Besoin réel selon l’usage
Les valeurs ci-dessus correspondent aux exigences minimales pour un usage standard. Les besoins réels peuvent varier selon : - le nombre d’utilisateurs simultanés - le volume de données traité - le type de déploiement (Docker, Podman, Kubernetes)
Pour un dimensionnement précis et des recommandations adaptées à votre usage, consultez la page Sizing & Dimensionnement.
💡 Espace disque
Les valeurs de stockage indiquées concernent l’espace disponible pour les données et applications, hors système d’exploitation. Prévoir également ~2 Go supplémentaires pour l’image Docker/Podman et tout volume de données généré.
Logiciels & conteneurs¶
Pour exécuter SPIE HUB IA, un environnement de conteneurs compatible est nécessaire.
| Logiciel | Lien officiel |
|---|---|
| Docker | Docker |
| Docker Compose | Docker Compose |
| Podman | Podman |
| Kubernetes léger | k3s |
💡 Remarque
L'utilisation des dernières versions stables de ces logiciels est recommandée afin de garantir la compatibilité et le bon fonctionnement de SPIE HUB IA. La récupération de l'image SPIE HUB IA se fait via un token GitLab spécifique pour chaque client (voir Récupération de l'image).
Azure OpenAI obligatoire pour les embeddings¶
L’application utilise un moteur d’embedding non disponible on-premise. Les embeddings sont générés via Azure OpenAI et nécessitent obligatoirement :
- une clé Azure OpenAI
- un endpoint valide
- un modèle d’embedding compatible, recommandé :
text-embedding-3-large- ou tout modèle équivalent supporté par Azure OpenAI
⚠️ Note importante
Le moteur d'embedding ne peut pas être remplacé par un modèle local. FAISS + SQLite dépendent des vecteurs produits. Aucun modèle open-source self-hosted n’est compatible dans cette version.
Variables d’environnement requises¶
⚠️ L’accès Internet sortant vers Azure OpenAI (HTTPS 443) est obligatoire. Sans cela, les embeddings et les chatbots vectorisés seront désactivés.
Variables d’environnement requises¶
⚠️ L’accès Internet sortant vers Azure OpenAI (HTTPS 443) est obligatoire.
Sans cela, les embeddings et les chatbots vectorisés seront désactivés.
AZURE_OPENAI_API_KEY=<clé>
AZURE_OPENAI_API_INSTANCE_NAME=<instance>
AZURE_OPENAI_API_DEPLOYMENT_NAME=<modèle>
AZURE_OPENAI_API_VERSION=2024-02-01
AZURE_OPENAI_API_EMBEDDINGS_DEPLOYMENT_NAME=text-embedding-3-large
Notes supplémentaires¶
- Port interne du conteneur :
3000/tcpRemarque : ce port est exposé à l'intérieur du conteneur.
La configuration d’un reverse proxy (Nginx, Traefik, etc.) pour l’accès externe est à la charge du client. - OS recommandé : Linux (Debian, Ubuntu)
- Accès Internet requis pour le pull de l’image et pour Azure OpenAI
- Pour un usage professionnel multi-utilisateurs, vérifier les besoins RAM/CPU selon le volume de données