Prérequis¶
Environnement d'hébergement¶
KAIROS est distribué sous forme d'une image Docker. Il peut donc être installé sur tout système supportant Docker :
- Linux (toutes distributions supportant Docker)
- macOS
- Windows (versions récentes)
Docker¶
L'installation de Docker doit être réalisée au préalable, en suivant la documentation officielle Docker.
Ports réseau¶
KAIROS expose deux services distincts, chacun sur son propre port :
| Service | Port interne conteneur | Rôle |
|---|---|---|
| Interface principale KAIROS | 443 (HTTPS) |
Application web principale (arborescence, graphiques...) |
| Application Streamlit | 8501 (HTTPS) |
Pages complémentaires (documentation intégrée, outils) |
Ces ports doivent être routés vers des ports libres de la machine hôte lors de la création du conteneur (option -p de docker create).
Volumes de données¶
KAIROS a été conçu pour rester une boîte noire sans donnée utilisateur à l'intérieur : toutes les données persistantes doivent être montées depuis l'hôte via des volumes Docker (option -v). Trois répertoires sont concernés :
| Répertoire dans le conteneur | Usage |
|---|---|
/postgres/data |
Données de la base PostgreSQL interne (métriques, arborescence) |
/export |
Exports générés depuis l'interface KAIROS |
/autoupload |
Dépôt de fichiers à importer automatiquement (voir Import) |
Sauvegarde
Le répertoire monté sur /postgres/data contient l'intégralité des données collectées. Il doit être inclus dans votre politique de sauvegarde.
Ressources machine¶
KAIROS embarque dans son image :
- Oracle Linux 8 comme système de base
- PostgreSQL 17 (avec l'extension
oracle_fdwet l'extension métierpgkairos) - Python 3.12 pour le moteur applicatif (
pykairos) et l'application Streamlit - Le client Oracle Instant Client (pour les connexions "Live Object" vers des bases Oracle en direct)
Prévoyez une machine avec des ressources dimensionnées selon le volume de données collectées (le stockage étant le facteur le plus déterminant, en fonction du nombre et de la fréquence des rapports importés).
Certificats¶
L'interface web est exposée en HTTPS. Des certificats sont fournis par défaut dans l'image (répertoire certificates/ du projet), à remplacer par vos propres certificats en environnement de production si nécessaire.