Documentation du Navin Manager
Le Navin Manager est la console d'administration de la plateforme Navin Enterprise AI : il installe, configure, exploite et supervise les services de la plateforme sur vos hôtes, grâce à l'agent Navin installé sur chaque hôte. Cette page liste chaque page de sa documentation, dans l'ordre du parcours du lecteur.
Vue d'ensemble
| Page | Contenu |
|---|---|
| Vue d'ensemble | Briques, notions, politique PostgreSQL |
| Architecture | Schéma interactif |
| Compatibilité des systèmes | Distributions, versions, architectures et paquets pris en charge (générée) |
Installation
| Page | Contenu |
|---|---|
| Installer le Navin Manager | Paquets pour Ubuntu 24.04, la famille RHEL 9 et Arch Linux, base de données, premier démarrage, administrateur initial, TLS, proxy inverse, installateur guidé |
| Installation hors ligne | Bundle, transfert, miroir, dépôts de paquets locaux, archives hors ligne |
| Bac à sable | Tout sur un poste, sans root et sans Docker |
| Mettre à niveau | Serveur, migrations et agents |
| Désinstaller | Paquets, puis données |
Configuration
| Page | Contenu |
|---|---|
| Référence de configuration | Chaque paramètre avec sa variable NM_*, son type et sa valeur par défaut (générée) |
Utilisation
| Page | Contenu |
|---|---|
| Guide de la console | Une page par espace de la console : boutons, permissions, tâches courantes |
| Recette de bout en bout | De la machine à une restauration vérifiée, dans une seule console |
| Exploitation | Clusters, hôtes, services, configurations, opérations, mises à niveau, sauvegardes |
| Cycle de vie des services | Profils, contrôles préalables, tests fonctionnels, mise à niveau et retour arrière, sauvegardes, dérive, archive de support, rapport de recette |
| Labellisation et affinage des modèles | Label Studio, jeux de données, LLaMA-Factory sur GPU, export du modèle affiné vers vLLM et LiteLLM (ADR-0172) |
| WebSSO : Keycloak ou LemonLDAP::NG | Choix du fournisseur OpenID Connect, installation ou connexion de LemonLDAP::NG sur l'annuaire de la banque, rôles, vérifications et limites |
| Elasticsearch du client | Journaux du collecteur OpenTelemetry et traces de Jaeger dans l'Elasticsearch que la banque exploite déjà, par une connexion (jamais installé) |
| Sauvegarde, restauration et reprise après sinistre | Centre de sauvegarde, centre de restauration, plans de PRA, exercices, RPO et RTO mesurés |
| Mode Kubernetes | Clusters Kubernetes, découverte, Platform Operator, ManagedComponent, RBAC |
| Haute disponibilité des services | Matrice HA du catalogue |
| Catalogue des services | Une page par service, générée depuis le catalogue |
Agent Navin
| Page | Contenu |
|---|---|
| Agent Navin | Architecture, confiance et enrôlement, TLS mutuel |
| Installer l'agent Navin | Chaque système, commande d'enregistrement, enroll.env, SSH |
| Référence de configuration de l'agent | agent.json, nm-agent, enroll.env (générée) |
| Sécurité de l'agent Navin | Identité, signatures, garde des chemins, commandes autorisées |
| Exploiter l'agent Navin | Démarrer, arrêter, journaux, mise à niveau, retrait |
| Dépanner l'agent Navin | Symptômes, causes, corrections |
| Agent d'hôte | Quel agent, systèmes pris en charge, proxy, faits |
| Agent de cluster Kubernetes | L'agent d'un cluster Kubernetes |
Exploitation et sécurité
| Page | Contenu |
|---|---|
| Supervision et alertes | Supervision du Manager, définitions d'alertes, notifications, Prometheus |
| Sécurité | Connexion, MFA, rôles, secrets, audit, agents |
| Installation durcie | Réseau isolé, Quadlet, profils de sécurité, Trusted Hub, rollback (ADR-0171) |
Référence
| Page | Contenu |
|---|---|
| Référence des opérations | Types d'opérations, étapes, types de tâches (générée) |
| API REST et protocole des agents | Authentification, routes principales, erreurs, protocole des agents |
| Dépannage | Symptômes, causes, corrections |
Pages générées
configuration.md, agent/configuration.md, os-compatibility.md et operations-reference.md sont écrites par
navin-manager/docs/tools/generate_reference.py à partir du code (textes dans
navin-manager/docs/tools/reference_text.yaml) :
navin-manager/server/.venv/bin/python navin-manager/docs/tools/generate_reference.py # écrire
navin-manager/server/.venv/bin/python navin-manager/docs/tools/generate_reference.py --check # sortie 1 si périmées
La référence contractuelle des développeurs est navin-manager/CONTRACT.md. La documentation anglaise se trouve
dans ../en.