Référence de compatibilité OS
Cette page liste les systèmes sur lesquels s'installent les paquets de la Navin Platform, et les exigences Kubernetes
du déploiement Helm. Les verdicts sont ceux de l'installateur guidé os/install/navin-install (fonctions
server_verdict et node_verdict, la même table que le Navin Manager) et des métadonnées des paquets.
Paquet de la plateforme navin-platform
API Control Plane, worker et portail. Valable aussi pour le paquet de console navin-manager (mêmes systèmes).
| Système | Version | Architecture | Paquet | Python | Verdict |
|---|---|---|---|---|---|
| Ubuntu | 24.04 | x86_64 | navin-platform_<version>_amd64.deb | python3.12 | Certifié |
| Ubuntu | autres versions | toutes | aucun | aucun | Refusé |
| Debian | toutes | toutes | aucun | aucun | Refusé (pas de paquet python3.12) |
| RHEL, Rocky Linux, AlmaLinux, Oracle Linux, CentOS Stream | 9 | x86_64 | navin-platform-<version>-1.el9.x86_64.rpm | python3.11 | Certifié |
| Famille RHEL | 8, 10 | toutes | aucun | aucun | Refusé |
| Fedora | toutes | toutes | aucun | aucun | Refusé |
| Arch Linux | continue | x86_64 | navin-platform-<version>-1-x86_64.pkg.tar.zst | le Python d'Arch Linux au moment du build (python>=3.14, python<3.15 pour 1.0.0) | Certifié |
| Dérivée d'Arch Linux | continue | x86_64 | idem | idem | Avertissement |
Aucun build aarch64 du paquet de la plateforme n'existe dans la version 1.0.0.
Dépendances
| Dépendance | Ubuntu 24.04 | Famille RHEL 9 | Arch Linux |
|---|---|---|---|
| PostgreSQL 15 ou plus récent (conseillé, base locale) | postgresql (16) | postgresql-server après dnf module enable postgresql:16 (flux par défaut 13) | postgresql (dépendance facultative) |
| Node.js 18.18 ou plus récent (portail) | nodejs (18.19) | nodejs après dnf module enable nodejs:20 | nodejs>=18.18 |
| Autres | python3.12-venv, openssl, adduser, systemd | openssl, systemd, util-linux, shadow-utils | openssl, systemd, util-linux |
Les scriptlets RPM sont du shell simple et la charge utile est en xz : un RPM construit sur un autre système se comporte comme un RPM construit sur RHEL. Sur Arch Linux, pacman refuse une mise à niveau de Python qui casserait le venv du paquet tant que la version Navin construite pour le nouveau Python n'est pas installée.
Agent de nœud navin-manager-agent
Installé sur chaque nœud d'un cluster géré par le Navin Manager. Agent Python (all / noarch / any) et agent Go
statique (navin-manager-agent-go, x86_64 et aarch64).
| Système | Versions certifiées | Refusées (fin de vie) | Autres versions |
|---|---|---|---|
| RHEL, Rocky Linux, AlmaLinux | 8, 9, 10 | 7 et antérieures | Avertissement |
| Oracle Linux | 8, 9 | 7 et antérieures | Avertissement |
| CentOS Stream | 9, 10 | 8 et antérieures | Avertissement |
| Ubuntu | 22.04, 24.04 | 25.10 et antérieures, sauf les certifiées | Avertissement (après 25.10) |
| Debian | 12 | 11 et antérieures | Avertissement |
| Arch Linux | continue (x86_64, aarch64) | aucune | aucune |
| Autre système d'une famille connue | aucune | aucune | Avertissement |
| Famille inconnue | aucune | aucune | Refusé |
Rôles de l'installateur guidé
| Rôle | Systèmes |
|---|---|
standalone | Ubuntu 24.04 ; RHEL, Rocky, Alma, Oracle Linux ou CentOS Stream 9 ; Arch Linux (x86_64) |
manager | Comme standalone |
node | Les systèmes de l'agent de nœud ci-dessus |
Chaque hôte exige aussi root, systemd, un nom d'hôte complet qui se résout et une horloge synchronisée.
Déploiement Kubernetes
| Élément | Exigence | Source |
|---|---|---|
| Kubernetes | 1.27 ou plus récent | kubeVersion: ">=1.27.0-0" de deploy/helm/enterprise-ai/Chart.yaml |
| Helm | 3.16 ou plus récent | services/control-plane/tests/test_platform_deploy_env.py |
| CNI | Cilium 1.16.5 (WireGuard, authentification mutuelle SPIFFE) ; global.networkPolicy=kubernetes rend à la place des objets NetworkPolicy standard | deploy/terraform/modules/platform-bootstrap |
| Admission | Chart Kyverno 3.3.4 (signatures d'images, Pod Security) | idem |
| Certificats | cert-manager v1.16.2 | idem |
| Autoscaling | KEDA 2.16.1, HorizontalPodAutoscaler | idem |
| PostgreSQL | Chart CloudNativePG 0.23.0, image PostgreSQL 16.6 | idem, deploy/data/postgres/cluster.yaml |
| Sauvegardes | Chart Velero 8.1.0 | idem |
| GPU | NVIDIA GPU Operator v24.9.1, nœuds portant le label nvidia.com/gpu.present=true | idem, values.yaml (vllm, ollama) |
| Runtimes de bac à sable | RuntimeClass gvisor (handler runsc) et kata (handler kata-qemu) : les nœuds qui exécutent les bacs à sable doivent offrir ces handlers dans leur runtime de conteneurs | values.yaml (sandbox.runtimeClasses) |
| Stockage | Classe de stockage fast-ssd (services de données), local-nvme (cache vLLM du profil sur site) | deploy/data/*, values-onprem-gpu.yaml |
Architectures d'images indiquées dans le chart : LiteLLM est épinglé à un index multi-architecture (linux/amd64,
linux/arm64) ; l'image CPU de vLLM est vllm/vllm-openai-cpu:v0.33.0-x86_64. Vérifiez les architectures des autres
images dans votre registre avant d'ajouter des nœuds arm64.
Le système des nœuds d'un cluster Kubernetes est celui que prennent en charge la distribution Kubernetes, Cilium, le NVIDIA GPU Operator et les runtimes de bac à sable dans les versions ci-dessus ; la plateforme n'ajoute aucune exigence propre.
Docker Compose et développement local
| Méthode | Exigence |
|---|---|
| Docker Compose | Docker Engine avec le greffon compose v2 (make docker-check) ; NVIDIA container toolkit pour le profil gpu |
make | Python 3.11 ou plus récent, Node.js 20 ou plus récent, redis-server, binaires PostgreSQL, Java 21 (Keycloak) |