Version 1.0.0-alpha.1dernière version
Chapitre 2.1
Architecture
Ce dont chaque service du chart Nexus est responsable et les systèmes de stockage sous-jacents, puis les règles qui assurent leur cohésion, de l'identité inter-services jusqu'au chemin emprunté par chaque appel de modèle.
Cette page a été traduite par l'IA à partir de l'original en anglais. En cas de doute, la page en anglais fait foi. Lire cette page en anglais

Lorsque Tomás Reilly a terminé la première installation chez Harrow Port Authority, kubectl -n nexus get pods affichait dix Deployments et sept StatefulSets, ainsi que trois CronJobs. Les Jobs de migration qui avaient construit la base de données avaient déjà disparu, car chacun se supprime de lui-même lorsqu'il réussit. Cette liste représente l'ensemble de la plateforme. Apprenez-la, car la plupart des questions d'exploitation courante commencent par « lequel de ces éléments est propriétaire de cela ? »
Ce chapitre répond à cette question pour chaque brique, suit le parcours d'une requête à travers elles, puis expose les règles auxquelles elles obéissent toutes. Le reste de la partie 2 s'appuie sur cette vue d'ensemble.
Les services et leurs responsabilités
Le chart est un chart Helm unique, nexus, version 1.0.0-alpha.1, pour Kubernetes 1.33 ou version ultérieure. Chaque charge de travail s'exécute sous son propre ServiceAccount, en tant qu'utilisateur non-root, avec toutes les capacités Linux abandonnées. Les appels vers les services qui protègent l'identité et les clés passent par TLS (Transport Layer Security) mutuel, et l'API (interface de programmation d'application) publique partage un processus avec le routeur d'IA (intelligence artificielle).
| Composant | Deployment et Service | Port de service | Ce qu'il possède |
|---|---|---|---|
| Console | nexus-alpha |
3000 | Les pages que les personnes voient ; sert le HTML (Hypertext Markup Language) sur l'hôte de la console |
| BFF (backend for frontend) | nexus-alpha-bff |
8080 | Les données propres à la console, le menu attribué à chaque personne, le registre des versions |
| Authentification | nexus-auth |
9101 (TLS mutuel sur 8443) | Personnes, organisations, sessions, jetons, clés d'API, le pool de clés de modèles de l'organisation |
| Passerelle | nexus-gateway |
9092, WebSocket 8093 | L'AI Provider Router, et la périphérie d'API publique pour REST (representational state transfer) et MCP (Model Context Protocol) |
| Orchestrateur | nexus-orchestrator |
8080 | Répartition UNO : acceptation et mise en file d'attente de chaque tâche |
| Workflows | nexus-workflows |
8081 | Exécution UNO : le worker qui exécute les tâches en file d'attente |
| GraphRAG | nexus-graphrag |
8090, WebSocket 8091 | Mémoire : le graphe de connaissances et la recherche sur celui-ci |
| Probitas | nexus-probitas |
9151 (HTTPS) | Preuve : les enregistrements de gouvernance et le registre scellé |
| Moteur de compétences | nexus-skills-engine |
8095 | La bibliothèque de compétences ; recherche et exécution de compétences |
| Clés | nexus-keys |
8080 (HTTPS, TLS mutuel) | Clés par organisation dans OpenBao, garde, l'identité de l'installation |
| Plugins | nexus-plugins |
9111 | Le registre de plugins et les enregistrements du catalogue ; désactivé par défaut |
| Traitement de fichiers | nexus-fileprocess |
9109 | Lecture des documents et images téléversés ; désactivé par défaut |
Les dix premiers sont obligatoires. Les deux derniers sont facultatifs, activés avec components.plugins.enabled et components.fileprocess.enabled lorsqu'une installation Enterprise ou un pack métier les utilise. Un autre service facultatif, nexus-alive sur le port 8080, possède son propre commutateur, components.alive.enabled, et est également désactivé par défaut. Les réplicas et les ressources de chacun se trouvent sous components.<name>.
La console est constituée de pages rendues côté serveur sans base de données. Elle communique avec le BFF et avec nexus-auth à l'intérieur du cluster, sans jamais sortir par l'hôte d'authentification public pour revenir ensuite. Elle refuse de démarrer sans son édition, que le chart transmet sous la forme NEXUS_EDITION à partir de l'unique valeur edition. Chaque membre d'une organisation y travaille selon son rôle. Les pages d'administration sont réservées aux propriétaires et aux administrateurs, et un membre qui en ouvre une obtient la page « Not an administrator ».
Le BFF est la moitié serveur de la console et est construit comme un plugin de la plateforme, enregistré sous le nom de produit Nexus Alpha. Il conserve les tables propres à la console dans une base de données distincte, nexus_alpha, et décide quels groupes de menus une personne voit. Lorsque la console a besoin d'effectuer un traitement, le BFF le demande au service qui en est propriétaire.
nexus-auth est écrit en Go et est le seul service qui émet des jetons. Par défaut, les jetons d'accès ont une durée de vie de 15 minutes et les jetons d'actualisation de 12 heures (auth.accessTokenTTL, auth.refreshTokenTTL). Il limite chaque personne connectée à 5,000 requêtes par minute avant de répondre 429 (auth.rateLimitPerMinute). Il exécute deux écouteurs : l'écouteur standard sur le port de conteneur 8080, atteint par l'Ingress public, et un écouteur en TLS mutuel sur le port 8443 que chaque appelant interne au cluster doit utiliser. Il ne fait confiance à X-Forwarded-For que s'il provient des sauts figurant dans proxy.trustedCIDRs, une liste de plages CIDR (Classless Inter-Domain Routing), qui correspond par défaut à 10.42.0.0/16, le réseau de pods k3s. Si votre contrôleur d'ingress s'exécute ailleurs, modifiez cette valeur. Sinon, chaque connexion semblera provenir du contrôleur.
La passerelle remplit deux rôles qui partagent un même processus. À l'intérieur du cluster, c'est l'AI Provider Router (le standard d'IA de la partie 1 et des pages de la console), le seul détenteur des identifiants de modèles d'une organisation (nous y reviendrons plus bas). En périphérie, c'est ce qu'atteint api.<domain> : les clients REST et les clients MCP, dont les jetons portent l'audience https://<hosts.api>/mcp et proviennent du serveur d'autorisation OAuth 2.1 situé sur l'hôte d'authentification (OAuth est la norme ouverte d'autorisation déléguée).
L'orchestrateur et workflows forment ensemble UNO, le moteur de workflows. Tous les calculs passent par eux. L'orchestrateur accepte une tâche sur POST /api/v1/dispatch, répond 202 avec un jobId, un runId et un traceId, puis la met en file d'attente. Il n'existe aucun chemin d'exécution directe : un client interroge toujours GET /api/v1/dispatch/{jobId} ou reçoit un rappel. Le worker workflows extrait les tâches de la file d'attente, quatre à la fois par réplica par défaut (workflows.concurrency), et ne possède qu'une seule route HTTP, GET /health.
Probitas est le service de preuve. Il assure lui-même le service TLS, à partir d'un certificat émis par le chart, et conserve ses tables dans le schéma trust avec un rôle distinct pour le registre. Ses fonctionnalités de gouvernance sont activées par probitas.flags. Plusieurs d'entre elles sont livrées en mode shadow : le verdict est calculé et enregistré, et rien n'est bloqué tant que vous ne modifiez pas l'indicateur.
nexus-keys est le service de clés de la plateforme, écrit en Go. Il conserve une clé par organisation dans un magasin de clés OpenBao et effectue leur rotation chaque nuit. Ses tâches nocturnes détruisent également les clés dont la date de conservation est échue et exportent ses reçus vers un volume qui lui est propre. L'effacement de la clé d'une organisation rend définitivement illisibles les données verrouillées sous celle-ci. Il émet également l'identité de l'installation lors du premier amorçage, sous keys.installationName, et ce nom est permanent. Choisissez-le avec soin : le chart refuse un nom vide (INSTALLATION_NAME_MISSING) et refuse le nom figurant dans ses propres valeurs d'exemple (INSTALLATION_NAME_EXAMPLE).
Trois hôtes publics
Le chart publie exactement trois noms d'hôte, qui constituent ensemble l'identité de l'installation. Chaque service refuse de démarrer sans eux.
| Ingress | Valeur de l'hôte | Backend |
|---|---|---|
nexus-console |
hosts.console |
nexus-alpha, port 3000 |
nexus-api |
hosts.api |
nexus-gateway, port 9092 |
nexus-auth |
hosts.auth |
nexus-auth, port 9101 |
Les exemples de cet ouvrage utilisent console.harrow.example, api.harrow.example et auth.harrow.example. Les Ingress sont de simples objets networking.k8s.io/v1 comportant une règle chacun, avec le chemin /. Le protocole TLS en périphérie suit tls.mode : existing (un Secret que vous avez créé, nommé dans tls.existingSecret), cert-manager (un ClusterIssuer que vous exécutez, nommé dans tls.clusterIssuer) ou none (le TLS se termine en amont du cluster). Le chart n'ajoute aucune redirection propre, de sorte qu'un défi HTTP ACME (Automated Certificate Management Environment) atteint votre solveur sans modification. Le chapitre 2.11, Variations : magasins externes, TLS et ingress, couvre chaque mode.
Rien d'autre n'est exposé. Les magasins de données, OpenBao et tous les services internes n'écoutent qu'à l'intérieur de l'espace de noms.
Une requête, de bout en bout
Voici ce qui se passe lorsqu'Aoife Brennan, directrice informatique chez Harrow, ouvre la console et pose à l'assistant une question sur le planning des postes d'amarrage de ce mois-ci.
- Son navigateur charge
https://console.harrow.example. L'Ingressnexus-consolel'envoie versnexus-alphasur le port 3000. - Elle se connecte avec sa clé d'accès. Les pages de connexion communiquent avec
nexus-authviaauth.harrow.example, et nexus-auth lui émet un jeton d'accès portant son utilisateur, son organisation et, lorsque sa session en comporte une, son unité opérationnelle. - Le serveur de la console appelle le BFF, qui vérifie son jeton et demande à nexus-auth si son organisation détient le produit et si son rôle est admis. Il répond avec les groupes de menus qu'elle est autorisée à voir.
- Sa question passe du BFF à la route de répartition de l'orchestrateur, son organisation et son utilisateur étant extraits du jeton vérifié. L'orchestrateur répond 202 et place la tâche dans une file d'attente dans Valkey.
- Un worker workflows prend la tâche en charge. La compétence qu'il exécute est résolue par le moteur de compétences, et la recherche sur les documents de Harrow est envoyée à GraphRAG, qui lit Neo4j, Qdrant et son schéma PostgreSQL.
- L'appel au modèle est adressé à l'AI Provider Router sur
/internal/ai/chat. Le routeur sélectionne le fournisseur et le modèle à partir du pool de clés et de la politique de routage propres à Harrow, effectue l'appel avec la clé de Harrow et renvoie la complétion. - Le résultat atterrit sur la ligne d'exécution de la tâche. Le BFF le lit et la console affiche la réponse, accompagnée de ses citations.
Les sauts de service à service transportent des jetons de service projetés, ceux vers nexus-auth, nexus-keys et Probitas s'effectuent sur TLS à partir de l'autorité de certification propre à l'installation, et chaque accès aux données dans les étapes 4 à 6 est cloisonné à l'organisation de Harrow au sein même de la base de données. Les sections ci-dessous expliquent ces deux aspects.
La couche de données
Nexus livre sa propre copie signée de chaque magasin, accompagnée de l'offre de code source correspondante dans le bundle. Chacun a été choisi autant pour sa licence que pour sa fonction.
| Magasin | Version | Licence | Sa raison d'être | Port | Volume par défaut |
|---|---|---|---|---|---|
| PostgreSQL avec PostGIS et pgvector | PostgreSQL 16, PostGIS 3, pgvector 0.8 | Licence PostgreSQL ; PostGIS GPL-2.0-or-later | Le système de référence pour chaque service ; PostGIS pour les données cartographiques ; pgvector pour les vecteurs conservés à côté des lignes | 5432 | 50 GiB |
| Valkey | 8.1 | BSD-3-Clause | Les files d'attente de tâches UNO et les caches à courte durée de vie, tels que le cache de clés d'API de nexus-auth | 6379 | 5 GiB |
| Neo4j Community Edition | 5.26 | GPL-3.0 | Le graphe de connaissances que GraphRAG construit et parcourt | 7687 (Bolt) | 20 GiB |
| Qdrant | 1.15 | Apache-2.0 | Recherche vectorielle pour GraphRAG et le moteur de compétences | 6333 (HTTP), 6334 (appels de procédure distante gRPC) | 10 GiB |
| SeaweedFS | 4.48 | Apache-2.0 | Stockage objet pour les fichiers, compatible avec Amazon Simple Storage Service (S3) | 8333 | 50 GiB |
| OpenBao | 2.6 | MPL-2.0 | Le magasin de clés et son service de descellement, pour nexus-keys | 8200 | 5 GiB et 1 GiB |
Certains choix ont remplacé des solutions plus familières. Valkey remplace Redis 7.4, dont les licences actuelles sont refusées par cette version. MinIO étant sous licence AGPL-3.0, le magasin d'objets est SeaweedFS. GraphRAG communique avec Neo4j Community Edition via Bolt, un protocole réseau, et les services communiquent avec PostGIS via le protocole PostgreSQL, de sorte que la licence GPL reste confinée à chacun d'eux. OpenBao est le fork de Vault par la Linux Foundation, antérieur au changement de licence de Vault.
Chaque magasin fonctionne avec l'authentification activée et des identifiants générés : un mot de passe pour Valkey, une clé d'API pour Qdrant, des clés d'accès pour SeaweedFS.
Chacun des cinq magasins sous dataTier s'exécute dans le cluster (mode: in-cluster, la valeur par défaut) ou est un magasin que vous exploitez déjà (mode: external, avec external.host et un Secret nommé par external.existingSecret). Pour un PostgreSQL externe, définissez sslmode sur verify-full ou verify-ca, et placez le certificat de l'autorité de certification (CA) du serveur dans ce Secret ; le chapitre 2.11, Variations : magasins externes, TLS et ingress, en donne les détails.
# harrow-values.yaml (Helm values): Harrow's own PostgreSQL, every other store in the cluster
dataTier:
postgres:
mode: external
sslmode: verify-full
external:
host: pg.harrow.example
existingSecret: harrow-postgresLa paire OpenBao fait exception : elle s'exécute toujours à l'intérieur de l'installation, car le Job de garde l'y initialise.
Identité entre les services
Nexus fonctionne sans maillage de services (service mesh). Le TLS mutuel provient d'une autorité de certification (CA) locale que le chart crée via cert-manager, lequel doit être installé au préalable (la version v1.21.3 est testée).
Un Issuer auto-signé crée un certificat de CA unique, nexus-local-ca, ECDSA (Elliptic Curve Digital Signature Algorithm) P-256, valide dix ans. Un second Issuer signe avec cette CA. Chaque charge de travail qui appelle un serveur TLS à l'intérieur de l'installation reçoit son propre certificat client, nommé <service-account>-client-tls, valide 90 jours et renouvelé 15 jours avant son expiration. Son seul nom est un identifiant de ressource uniforme (URI) au format d'identité SPIFFE :
spiffe://cluster.local/ns/<namespace>/sa/<service-account>
Chaque charge de travail trouve le certificat public de la CA sous le nom ca.crt dans son propre Secret de certificat. Aucun pod ne monte la clé de la CA, et vous n'avez pas besoin de trust-manager.
Trois services vérifient les appelants par certificat. nexus-auth le fait sur son second écouteur, le port 8443, et chaque appelant interne au cluster utilise celui-ci. nexus-keys le fait sur son unique écouteur. Probitas sert le TLS à partir de son propre certificat, nexus-probitas-tls, qu'il relit lorsque cert-manager le renouvelle. Aucun d'eux ne fait confiance à un en-tête X-Forwarded-Client-Cert.
Chaque charge de travail reçoit également des jetons Kubernetes d'une heure dans /var/run/secrets/nexus, un par service qu'elle appelle, avec ce service comme audience. Le ConfigMap nexus-service-identities associe chaque <namespace>/<service-account> à un nom de service ou de plugin, et une charge de travail qui n'y figure pas n'a pas d'identité et est refusée. L'orchestrateur et Probitas vérifient ces jetons auprès de l'API Kubernetes. Parmi les services en cours d'exécution, seuls ces deux-là détiennent system:auth-delegator ou ont un jeton d'API monté ; la seule autre charge de travail disposant d'un jeton est le Job de garde qui s'exécute à l'installation.
La politique réseau ferme ce que l'identité ne couvre pas. Le chart part d'un refus par défaut, puis autorise le trafic entre les pods propres à l'installation, le DNS (Domain Name System), l'espace de noms du contrôleur d'ingress (networkPolicy.ingressNamespace, kube-system par défaut) vers les trois Services publics, et le serveur d'API pour les deux vérificateurs de jetons. Les pods OpenBao portent un label différent du reste de la plateforme, de sorte que la règle d'ouverture interne à l'espace de noms ne les atteint pas : seuls nexus-keys, ses Jobs et le Job de garde peuvent passer, sur le port 8200. Tout autre élément qu'une charge de travail doit joindre en dehors de l'espace de noms, tel que votre relais de messagerie, va dans networkPolicy.externalEgressCIDRs, qui est vide par défaut.
Migrations et registre de schémas
Les migrations s'exécutent sous forme de hooks Helm, sur post-install et pre-upgrade. Un hook post-install s'exécute après la création des Deployments de la release. Ainsi, lors d'une première installation, les services démarrent alors que leurs schémas n'existent pas encore, et ils entreraient dans une boucle de plantage (crash-loop) face à une base de données sans rôle, sans mot de passe et sans tables. Nexus évite cela grâce à un registre.
Les hooks s'exécutent par ordre de poids, et Helm attend la fin de chaque Job avant que le poids suivant ne démarre :
| Poids | Hook | Ce qu'il fait |
|---|---|---|
| -30 | nexus-migrations-env et prérequis |
Crée le Secret réservé aux hooks contenant les identifiants du migrateur, ainsi que tout ce que lit le Job de garde |
| -20 | nexus-db-bootstrap |
Crée les bases de données nexus et nexus_alpha, le rôle du migrateur, le rôle d'exécution de chaque service, les extensions et le registre |
| -15 | nexus-openbao-custody-init |
Initialise le magasin de clés et le service de descellement, et émet l'identité de l'installation |
| -12 | nexus-graphrag-migrations |
Le schéma de GraphRAG, qui possède des objets auxquels la base de référence de nexus-auth fait référence |
| -10 | nexus-auth-migrations |
Le schéma d'identité |
| -5 | Migrations de l'orchestrateur, de la passerelle et de Probitas | Leurs schémas ; Probitas vérifie d'abord que les tables d'authentification existent |
| 0 | nexus-alpha-bff-migrations |
La base de données propre à la console |
Chaque Job de migration possède backoffLimit: 0, de sorte qu'une migration échouée fait échouer l'installation.
Le registre est une table unique, nexus_release.schema_applied, comportant une ligne par chaîne et condensat d'image (digest). Chaque hook n'écrit sa ligne qu'une fois que son exécuteur de migration a terminé. Chaque Deployment qui utilise PostgreSQL comporte un conteneur d'initialisation, wait-for-schema, qui lit cette table en tant que rôle autorisé à ne rien lire d'autre (nexus_ledger_reader) et attend que chaque chaîne dont il dépend présente une ligne pour l'image de cette release. Ensuite, le service démarre. Le worker workflows attend la chaîne de l'orchestrateur, puisqu'il partage cette base de données, et le moteur de compétences n'attend que l'amorçage.
Il interroge la table toutes les 3 secondes (schemaWait.intervalSeconds) et abandonne après 1 800 (schemaWait.timeoutSeconds) en affichant une ligne nommant les chaînes toujours manquantes. Le conteneur propre au service ne démarre jamais face à un schéma incorrect.
kubectl -n nexus logs deploy/nexus-gateway -c wait-for-schemaC'est pourquoi vous ne devez jamais exécuter helm install --wait. Avec --wait, Helm attend les Deployments avant d'exécuter les hooks post-install, et les Deployments attendent les hooks. Plus rien n'avance. Installez sans cette option et attendez ensuite ; le chapitre 2.6, Installation de l'édition Community sur Kubernetes, donne la commande exacte.
Isolation sur trois axes
Chaque lecture, écriture, appel d'outil et répartition de compétence dans Nexus est délimité selon trois axes.
| Axe | Champ | Ce qu'il sépare |
|---|---|---|
| Locataire (Tenant) | organization_id |
Une organisation d'une autre, une frontière stricte |
| Propriétaire (Owner) | owner_user_id |
Les éléments d'une personne de ceux de toutes les autres, même au sein d'une même organisation |
| Unité (Unit) | business_unit_id |
Une subdivision d'une organisation, facultative |
L'axe du propriétaire surprend souvent. Une boîte aux lettres ou un carnet de notes personnel reste privé pour son propriétaire, même vis-à-vis de collègues de la même unité ayant le même rôle. Un administrateur définit les politiques et ne lit pas le contenu.
Les axes proviennent de la requête authentifiée et de nulle part ailleurs. Aucune variable d'environnement, aucun en-tête, aucun paramètre de requête ni aucun segment de chemin ne peut les définir. Un corps de requête qui nomme une organisation est refusé avec TENANT_NOT_A_PARAMETER. Une surface qui ne peut pas indiquer à quels locataire, propriétaire et unité appartient une ligne refuse avec 403 SCOPE_PREDICATE_MISSING, et le corps énumère les axes qui ont pu être résolus et ceux qui ne l'ont pas été. Il ne se rabat jamais sur une lecture plus large.
Cela s'applique à deux endroits simultanément.
Dans la base de données. Chaque service se connecte sous ses propres rôles d'exécution : nexus_auth, auth_app et auth_platform pour le service d'identité, nexus_probitas et nexus_probitas_ledger pour Probitas, et nexus_gateway, nexus_graphrag, nexus_skills, orchestrator_app, workflows_app et le reste pour les autres. Aucun n'est superutilisateur ni ne possède BYPASSRLS. Aucun ne possède non plus les tables qu'il utilise, de sorte que chaque politique de sécurité au niveau des lignes (RLS) s'applique à lui. Les rôles partagent un groupe, nexus_runtime, qui accorde la connexion et l'utilisation du schéma, mais aucun droit sur les tables ; chaque service se voit accorder ses propres tables par ses propres migrations. Les paramètres de locataire que lisent les politiques RLS ne peuvent être définis que par la fonction bind_scope de chaque service, qui s'exécute en tant que son propriétaire. L'amorçage révoque set_config pour tous les autres, et l'orchestrateur ainsi que Probitas refusent de démarrer si leur rôle d'exécution peut l'appeler directement (Probitas nomme cela DB_ROLE_SETS_SCOPE_DIRECTLY). Les seules connexions superutilisateur de toute l'installation appartiennent au Job d'amorçage et à l'étape de provisionnement du BFF.
Dans la primitive partagée de requête délimitée. Chaque dépôt de la plateforme et chaque plugin construit sur le SDK (kit de développement logiciel) hérite d'une barrière unique qui construit le prédicat SQL à partir d'une portée résolue. Sa fonction de portée prend l'identité vérifiée et n'a pas de paramètre d'organisation, de sorte qu'un appelant ne peut pas en transmettre un, et qu'aucune route ne peut s'y soustraire.
Il existe exactement un franchissement de la frontière de locataire, et il est étroit : une autorisation enregistrée. Deux personnes de l'organisation détenant les lignes enregistrent quelle organisation peut lire quelles tables, et jusqu'à quand. Chaque lecture s'exécute dans une transaction en lecture seule et est journalisée chez les deux locataires. Les propriétaires et les administrateurs ne lisent jamais d'un locataire à l'autre, et le lecteur ne peut pas élargir une autorisation.
Le chemin de l'IA
Les appelants expriment des souhaits. L'AI Provider Router détient l'identifiant et fait le choix final.
Chaque appel de modèle dans Nexus passe par les routes /internal/ai/* du routeur, et le routeur n'admet que des appelants nommés. Le chart définit trois listes sur la passerelle :
| Routes | Qui peut appeler |
|---|---|
| Chat et streaming de chat | nexus-orchestrator, nexus-workflows, nexus-skills-engine |
| Embeddings et reclassement (rerank) | nexus-graphrag, nexus-skills-engine, nexus-workflows |
| Tout le reste, y compris l'exécution d'outils | nexus-orchestrator, nexus-workflows |
Un appel sans identité d'appelant est refusé avec 403 MISSING_CALLER_IDENTITY, et un appelant ne figurant pas sur la liste avec 403 UNAUTHORIZED_CALLER. Les plugins ne figurent sur aucune liste, et c'est délibéré : les appels de modèles d'un plugin s'effectuent en son nom, via la répartition UNO.
Ce qu'un appelant peut envoyer est un souhait : un fournisseur et un modèle préférés, ainsi qu'un profil de capacités tel qu'une longueur de contexte minimale ou l'utilisation d'outils. Le routeur n'honore un souhait que lorsque l'organisation a activé ce fournisseur et lui a associé des identifiants ; sinon, il effectue une substitution, d'abord chez le même fournisseur, puis parmi les autres fournisseurs de l'organisation. Un profil de capacités ne fait que filtrer, et une exigence de résidence des données qui y figure est stricte. Lorsque rien ne correspond, il n'y a pas de modèle de repli : l'appelant reçoit 422 MODEL_CAPABILITY_UNAVAILABLE ou 422 NO_PROVIDER_FOR_ROLE, avec une chaîne de remédiation que la console affiche à un administrateur.
Les clés appartiennent à l'organisation. Les administrateurs de chaque organisation placent leurs propres clés de fournisseur dans son pool depuis la console, et le routeur les résout au moment de l'appel. Aucune clé de modèle n'est une valeur du chart et aucune n'est livrée avec Nexus. Une organisation sans clé n'obtient aucune réponse d'IA, et la console l'indique clairement ; rien ne vient combler ce manque depuis l'extérieur.
Deux valeurs du chart façonnent le routeur. ai.localProvider.baseUrl désigne un serveur de modèles compatible OpenAI que vous exécutez, routé comme n'importe quel autre fournisseur. ai.installationHosts répertorie vos serveurs de modèles sur des noms privés, que le routeur considère comme internes à l'installation. GraphRAG génère également les plongements via le routeur, au nom de l'organisation à laquelle appartient le contenu. Le modèle de plongement par défaut s'exécute dans le cluster sans carte graphique ; les plongements hébergés relèvent du choix de chaque organisation.
Aucune télémétrie
Rien ne quitte une installation à moins que vous ne l'envoyiez. La valeur telemetry.enabled du chart ne peut être que false ; le schéma refuse toute autre valeur. Les rapports propres au niveau de données sont également désactivés : le rapport d'utilisation de Neo4j et la télémétrie de Qdrant sont désactivés dans le chart.
Lorsque networkPolicy.enabled est activé, ce qui est la valeur par défaut, aucun pod ne peut accéder à Internet à moins que vous ne répertoriiez la destination dans networkPolicy.externalEgressCIDRs. Un fournisseur de modèles hébergé constitue l'une de ces destinations, tout comme votre relais de messagerie.
La même règle a modifié un paramètre par défaut que vous remarquerez. Le CAPTCHA de nexus-auth pour les inscriptions nécessite un service Internet ; sur une installation, il est donc désactivé, et l'inscription d'un inconnu attend l'approbation d'un administrateur (403 SIGNUP_REQUIRES_APPROVAL). Le filtre qui bloque les inscriptions provenant de réseaux d'hébergement est également désactivé, car il nécessite des bases de données sous licence que Nexus ne fournit pas. Vous perdez ce filtrage.

