Versiune 1.0.0-alpha.1cea mai recentă
Capitolul 2.1
Arhitectură
Ce deține fiecare serviciu din chartul Nexus și ce medii de stocare se află sub acesta, apoi regulile care le leagă împreună, de la identitatea între servicii până la calea pe care o urmează fiecare apel de model.
Această pagină a fost tradusă cu ajutorul IA din originalul în limba engleză. Dacă există neclarități, pagina în limba engleză rămâne cea de referință. Citiți această pagină în limba engleză

Când Tomás Reilly a finalizat prima instalare la Harrow Port Authority, kubectl -n nexus get pods afișa zece Deployments și șapte StatefulSets, plus trei CronJobs. Acele Jobs de migrare care construiseră baza de date dispăruseră deja, deoarece fiecare se șterge singur atunci când reușește. Acea listă reprezintă întreaga platformă. Învățați-o, deoarece majoritatea întrebărilor de după punerea în funcțiune încep cu „care dintre acestea deține acel lucru?”
Acest capitol răspunde la această întrebare pentru fiecare piesă, urmărește o cerere prin ele, apoi acoperă regulile pe care le respectă toate. Restul Părții 2 se bazează pe această imagine de ansamblu.
Serviciile și ce deține fiecare
Pachetul este un singur chart Helm, nexus, versiunea 1.0.0-alpha.1, pentru Kubernetes 1.33 sau o versiune ulterioară. Fiecare sarcină de lucru (workload) rulează sub propriul său ServiceAccount, ca utilizator non-root, cu toate capabilitățile Linux eliminate. Apelurile către serviciile care protejează identitatea și cheile rulează prin TLS (Transport Layer Security) mutual, iar API-ul (interfața de programare a aplicațiilor) public împarte un proces cu ruterul de IA (inteligență artificială).
| Componentă | Deployment și Service | Portul serviciului | Ce deține |
|---|---|---|---|
| Consolă | nexus-alpha |
3000 | Paginile pe care le văd utilizatorii; servește HTML (Hypertext Markup Language) la gazda consolei |
| BFF (backend pentru frontend) | nexus-alpha-bff |
8080 | Datele proprii ale consolei, meniul pe care îl primește fiecare persoană, registrul versiunilor |
| Autentificare | nexus-auth |
9101 (TLS mutual pe 8443) | Persoane, organizații, sesiuni, tokenuri, chei API, setul de chei de model al organizației |
| Gateway | nexus-gateway |
9092, WebSocket 8093 | AI Provider Router și punctul de acces API public pentru REST (representational state transfer) și MCP (Model Context Protocol) |
| Orchestrator | nexus-orchestrator |
8080 | Expediere UNO: acceptarea fiecărei sarcini și plasarea acesteia în coadă |
| Fluxuri de lucru | nexus-workflows |
8081 | Execuție UNO: procesul de lucru (worker) care rulează sarcinile din coadă |
| GraphRAG | nexus-graphrag |
8090, WebSocket 8091 | Memorie: graful de cunoștințe și regăsirea informațiilor din acesta |
| Probitas | nexus-probitas |
9151 (HTTPS) | Dovezi: înregistrări de guvernanță și registrul sigilat |
| Motorul de competențe (Skills engine) | nexus-skills-engine |
8095 | Biblioteca de competențe; găsirea și rularea competențelor |
| Chei | nexus-keys |
8080 (HTTPS, TLS mutual) | Chei per organizație în OpenBao, custodie, identitatea instalării |
| Pluginuri | nexus-plugins |
9111 | Registrul de pluginuri și înregistrările din catalog; dezactivat în mod implicit |
| Procesarea fișierelor | nexus-fileprocess |
9109 | Citirea documentelor și a imaginilor încărcate; dezactivată în mod implicit |
Primele zece sunt obligatorii. Ultimele două sunt opționale, activate cu components.plugins.enabled și components.fileprocess.enabled acolo unde o instalare Enterprise sau un pachet de domeniu le utilizează. Încă un serviciu opțional, nexus-alive pe portul 8080, are propriul său comutator, components.alive.enabled, și este, de asemenea, dezactivat în mod implicit. Replicile și resursele pentru fiecare se află sub components.<name>.
Consola este formată din pagini randate pe server, fără bază de date. Aceasta comunică cu BFF și cu nexus-auth în interiorul clusterului, niciodată în exterior prin gazda publică de autentificare și înapoi. Refuză să pornească fără ediția sa, pe care chart-ul o transmite ca NEXUS_EDITION din unica valoare edition. Fiecare membru al unei organizații lucrează în ea conform rolului său. Paginile de administrare sunt pentru proprietari și administratori, iar un membru care deschide una primește pagina „Not an administrator”.
BFF este jumătatea de server a consolei și este construit ca un plugin al platformei, înregistrat ca produsul Nexus Alpha. Acesta păstrează tabelele proprii ale consolei într-o bază de date separată, nexus_alpha, și decide ce grupuri de meniuri vede o persoană. Când consola are nevoie ca o sarcină să fie îndeplinită, BFF-ul apelează serviciul care o deține.
nexus-auth este scris în Go și este singurul serviciu care emite tokenuri. Tokenurile de acces sunt valabile 15 minute, iar tokenurile de reîmprospătare 12 ore în mod implicit (auth.accessTokenTTL, auth.refreshTokenTTL). Acesta limitează fiecare persoană autentificată la 5,000 de cereri pe minut înainte de a răspunde cu 429 (auth.rateLimitPerMinute). Rulează două procese de ascultare (listeners): cel simplu pe portul de container 8080, la care ajunge Ingress-ul public, și unul cu TLS mutual pe 8443, pe care trebuie să îl folosească fiecare apelant din interiorul clusterului. Acesta are încredere în X-Forwarded-For doar de la salturile (hops) din proxy.trustedCIDRs, o listă de intervale Classless Inter-Domain Routing (CIDR), care are valoarea implicită 10.42.0.0/16, rețeaua de pod-uri k3s. Dacă al dumneavoastră controler de ingress rulează în altă parte, modificați această valoare. În caz contrar, fiecare autentificare va părea că provine de la controler.
Gateway-ul are două roluri care împart același proces. În interiorul clusterului este AI Provider Router (centrala de IA din Partea 1 și de pe paginile consolei), singurul deținător al acreditărilor de model ale unei organizații (mai multe despre aceasta mai jos). La margine (edge) este ceea ce accesează api.<domain>: clienții REST și clienții MCP, ale căror tokenuri poartă audiența https://<hosts.api>/mcp și provin de la serverul de autorizare OAuth 2.1 de la gazda de autentificare (OAuth este standardul deschis pentru autorizarea delegată).
Orchestratorul și workflows formează împreună UNO, motorul de fluxuri de lucru. Toate procesările rulează prin ele. Orchestratorul acceptă o sarcină la POST /api/v1/dispatch, răspunde cu 202 împreună cu jobId, runId și traceId, și o plasează în coadă. Nu există o cale de execuție în linie (inline): un client interoghează întotdeauna GET /api/v1/dispatch/{jobId} sau primește un apel invers (callback). Procesul de lucru workflows extrage sarcini din coadă, câte patru simultan per replică în mod implicit (workflows.concurrency), și are exact o rută HTTP, GET /health.
Probitas este serviciul de dovezi. Acesta servește TLS în mod direct, dintr-un certificat emis de chart, și își păstrează tabelele în schema trust, cu un rol separat pentru registru. Funcționalitățile sale de guvernanță sunt comutate prin probitas.flags. Mai multe sunt livrate în modul shadow: verdictul este calculat și înregistrat, și nimic nu este blocat până când nu modificați indicatorul (flag).
nexus-keys este serviciul de chei al platformei, scris în Go. Acesta păstrează câte o cheie per organizație într-un depozit de chei OpenBao și le rotește în fiecare noapte. Sarcinile sale nocturne distrug, de asemenea, cheile a căror dată de păstrare a ajuns la termen și își exportă confirmările într-un volum propriu. Ștergerea cheii unei organizații face ca datele blocate sub aceasta să devină definitiv ilizibile. De asemenea, emite identitatea instalării la prima inițializare (bootstrap), sub keys.installationName, iar acel nume este permanent. Alegeți-l cu grijă: chart-ul refuză un nume gol (INSTALLATION_NAME_MISSING) și refuză numele din propriile sale valori de exemplu (INSTALLATION_NAME_EXAMPLE).
Trei gazde publice
Chart-ul publică exact trei nume de gazdă, care împreună constituie identitatea instalării. Fiecare serviciu refuză să pornească fără ele.
| Ingress | Valoarea gazdei | Backend |
|---|---|---|
nexus-console |
hosts.console |
nexus-alpha, portul 3000 |
nexus-api |
hosts.api |
nexus-gateway, portul 9092 |
nexus-auth |
hosts.auth |
nexus-auth, portul 9101 |
Exemplele din această carte utilizează console.harrow.example, api.harrow.example și auth.harrow.example. Obiectele Ingress sunt obiecte networking.k8s.io/v1 simple, cu câte o regulă fiecare, calea /. TLS la margine (edge) urmează tls.mode: existing (un Secret creat de dumneavoastră, numit în tls.existingSecret), cert-manager (un ClusterIssuer pe care îl rulați, numit în tls.clusterIssuer) sau none (TLS se termină în fața clusterului). Chart-ul nu adaugă nicio redirecționare proprie, astfel încât o provocare HTTP ACME (Automated Certificate Management Environment) ajunge la rezolvitorul dumneavoastră nemodificată. Capitolul 2.11, Variații: depozite externe, TLS și ingress, acoperă fiecare mod.
Nimic altceva nu este expus. Depozitele de date, OpenBao și fiecare serviciu intern ascultă doar în interiorul namespace-ului.
O cerere, de la un capăt la altul
Iată ce se întâmplă atunci când Aoife Brennan, șefa departamentului IT de la Harrow, deschide consola și îi adresează asistentului o întrebare despre programul danelor din această lună.
- Browserul ei încarcă
https://console.harrow.example. Obiectul Ingressnexus-consoletrimite cererea cătrenexus-alphape portul 3000. - Ea se autentifică folosind cheia sa de acces (passkey). Paginile de autentificare comunică cu
nexus-authprinauth.harrow.example, iar nexus-auth îi emite un token de acces care conține utilizatorul ei, organizația ei și, atunci când sesiunea ei are una, unitatea ei de afaceri. - Serverul consolei apelează BFF-ul, care îi verifică tokenul și întreabă nexus-auth dacă organizația ei deține produsul și dacă rolul ei este admis. Acesta răspunde cu grupurile de meniuri pe care are permisiunea să le vadă.
- Întrebarea ei merge de la BFF la ruta de expediere a orchestratorului, cu organizația și utilizatorul ei preluate din tokenul verificat. Orchestratorul răspunde cu 202 și plasează sarcina într-o coadă în Valkey.
- Un proces de lucru (worker) workflows preia sarcina. Competența pe care o rulează este rezolvată de motorul de competențe, iar regăsirea informațiilor din documentele Harrow merge la GraphRAG, care citește Neo4j, Qdrant și schema sa PostgreSQL.
- Apelul către model merge la AI Provider Router la
/internal/ai/chat. Ruterul alege furnizorul și modelul din propriul set de chei și politica de rutare ale Harrow, efectuează apelul cu cheia Harrow și returnează completarea. - Rezultatul ajunge pe rândul de execuție al sarcinii. BFF-ul îl citește, iar consola afișează răspunsul, împreună cu citările aferente.
Salturile (hops) de la un serviciu la altul poartă tokenuri de serviciu proiectate, cele către nexus-auth, nexus-keys și Probitas rulează prin TLS de la autoritatea de certificare proprie a instalării, iar fiecare acces la date din pașii de la 4 la 6 este izolat la organizația Harrow în baza de date însăși. Secțiunile de mai jos le explică pe ambele.
Nivelul de date
Nexus livrează propria sa copie semnată a fiecărui depozit de date, cu oferta de cod sursă pentru fiecare inclusă în pachet. Fiecare a fost ales atât pentru licența sa, cât și pentru funcția sa.
| Depozit de date | Versiune | Licență | De ce se află acolo | Port | Volum implicit |
|---|---|---|---|---|---|
| PostgreSQL cu PostGIS și pgvector | PostgreSQL 16, PostGIS 3, pgvector 0.8 | Licența PostgreSQL; PostGIS GPL-2.0-or-later | Sistemul de înregistrare pentru fiecare serviciu; PostGIS pentru date cartografice; pgvector pentru vectori păstrați alături de rânduri | 5432 | 50 GiB |
| Valkey | 8.1 | BSD-3-Clause | Cozile de sarcini UNO și memorie cache de scurtă durată, cum ar fi memoria cache pentru chei API a nexus-auth | 6379 | 5 GiB |
| Neo4j Community Edition | 5.26 | GPL-3.0 | Graful de cunoștințe pe care GraphRAG îl construiește și îl parcurge | 7687 (Bolt) | 20 GiB |
| Qdrant | 1.15 | Apache-2.0 | Căutare vectorială pentru GraphRAG și motorul de competențe | 6333 (HTTP), 6334 (apeluri de procedură la distanță gRPC) | 10 GiB |
| SeaweedFS | 4.48 | Apache-2.0 | Stocare de obiecte pentru fișiere, compatibilă cu Amazon Simple Storage Service (S3) | 8333 | 50 GiB |
| OpenBao | 2.6 | MPL-2.0 | Depozitul de chei și procesul său de desigilare, pentru nexus-keys | 8200 | 5 GiB și 1 GiB |
Unele alegeri au înlocuit opțiuni mai familiare. Valkey ține locul lui Redis 7.4, ale cărui licențe actuale sunt refuzate de această versiune. MinIO are licență AGPL-3.0, astfel încât depozitul de obiecte este SeaweedFS. GraphRAG accesează Neo4j Community Edition prin Bolt, un protocol de rețea, iar serviciile accesează PostGIS prin protocolul PostgreSQL, astfel încât licența GPL rămâne la fiecare dintre ele. OpenBao este bifurcația (fork) realizată de Linux Foundation din Vault, înainte de schimbarea licenței Vault.
Fiecare depozit de date rulează cu autentificarea activată și cu acreditări generate: o parolă pentru Valkey, o cheie API pentru Qdrant, chei de acces pentru SeaweedFS.
Fiecare dintre cele cinci depozite de date de sub dataTier rulează în cluster (mode: in-cluster, valoarea implicită) sau este unul pe care îl operați deja (mode: external, cu external.host și un Secret numit de external.existingSecret). Pentru un PostgreSQL extern, setați sslmode la verify-full sau verify-ca și puneți certificatul autorității de certificare (CA) a serverului în acel Secret; capitolul 2.11, Variații: depozite externe, TLS și ingress, conține detaliile.
# 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-postgresPerechea OpenBao este excepția: aceasta rulează întotdeauna în interiorul instalării, deoarece acel Job de custodie o inițializează acolo.
Identitatea între servicii
Nexus rulează fără un service mesh. TLS-ul mutual provine de la o autoritate de certificare (CA) locală pe care chart-ul o creează prin cert-manager, care trebuie instalat mai întâi (versiunea v1.21.3 este testată).
Un Issuer autosemnat creează un certificat CA, nexus-local-ca, ECDSA (Elliptic Curve Digital Signature Algorithm) P-256, valabil zece ani. Un al doilea Issuer semnează cu acel CA. Fiecare sarcină de lucru (workload) care apelează un server TLS în interiorul instalării primește propriul său certificat de client, numit <service-account>-client-tls, valabil 90 de zile și reînnoit cu 15 zile înainte de expirare. Singurul său nume este un identificator uniform de resurse (URI) în forma de identitate SPIFFE:
spiffe://cluster.local/ns/<namespace>/sa/<service-account>
Fiecare sarcină de lucru găsește certificatul public al CA-ului ca ca.crt în propriul său Secret de certificat. Niciun pod nu montează cheia CA-ului și nu aveți nevoie de trust-manager.
Trei servicii verifică apelanții prin certificat. nexus-auth face acest lucru pe al doilea său proces de ascultare (listener), portul 8443, iar fiecare apelant din interiorul clusterului îl apelează pe acela. nexus-keys face acest lucru pe singurul său proces de ascultare. Probitas servește TLS din propriul său certificat, nexus-probitas-tls, pe care îl recitește atunci când cert-manager îl reînnoiește. Niciunul nu are încredere într-un antet X-Forwarded-Client-Cert.
Fiecare sarcină de lucru primește, de asemenea, tokenuri Kubernetes valabile o oră la /var/run/secrets/nexus, câte unul pentru fiecare serviciu pe care îl apelează, având acel serviciu ca audiență. Obiectul ConfigMap nexus-service-identities asociază fiecare <namespace>/<service-account> cu un nume de serviciu sau de plugin, iar o sarcină de lucru care lipsește din acesta nu are identitate și este refuzată. Orchestratorul și Probitas verifică aceste tokenuri cu API-ul Kubernetes. Dintre serviciile care rulează, doar acele două dețin system:auth-delegator sau au un token API montat; singura altă sarcină de lucru cu un token este acel Job de custodie care rulează la instalare.
Politica de rețea blochează ceea ce nu este blocat prin identitate. Chart-ul pornește de la refuzul implicit (default deny), apoi admite traficul între pod-urile proprii ale instalării, DNS (Domain Name System), namespace-ul controlerului de ingress (networkPolicy.ingressNamespace, kube-system în mod implicit) către cele trei Services publice și serverul API pentru cei doi verificatori de tokenuri. Pod-urile OpenBao poartă o etichetă diferită față de restul platformei, astfel încât regula deschisă din interiorul namespace-ului nu ajunge la ele: doar nexus-keys, propriile sale Jobs și acel Job de custodie pot trece, pe portul 8200. Orice altceva la care o sarcină de lucru trebuie să ajungă în afara namespace-ului, cum ar fi releul dumneavoastră de e-mail, se adaugă în networkPolicy.externalEgressCIDRs, care este gol în mod implicit.
Migrări și registrul de scheme
Migrările rulează ca hook-uri Helm, la post-install și pre-upgrade. Un hook post-instalare rulează după ce obiectele Deployment ale versiunii au fost create. Prin urmare, la o primă instalare, serviciile pornesc în timp ce schemele lor nu există încă și ar intra într-o buclă de blocare (crash-loop) încercând să acceseze o bază de date fără rol, fără parolă și fără tabele. Nexus evită acest lucru cu ajutorul unui registru (ledger).
Hook-urile rulează în ordinea ponderii (weight), iar Helm așteaptă fiecare Job înainte ca următoarea pondere să înceapă:
| Pondere | Hook | Ce face |
|---|---|---|
| -30 | nexus-migrations-env și cerințe preliminare |
Creează Secretul exclusiv pentru hook cu acreditările migratorului și tot ceea ce citește acel Job de custodie |
| -20 | nexus-db-bootstrap |
Creează bazele de date nexus și nexus_alpha, rolul migratorului, rolul de execuție (runtime) al fiecărui serviciu, extensiile și registrul |
| -15 | nexus-openbao-custody-init |
Inițializează depozitul de chei și procesul de desigilare și emite identitatea instalării |
| -12 | nexus-graphrag-migrations |
Schema GraphRAG, care deține obiecte la care face referire linia de bază (baseline) a nexus-auth |
| -10 | nexus-auth-migrations |
Schema de identitate |
| -5 | migrările pentru orchestrator, gateway și Probitas | Schemele lor; Probitas verifică mai întâi dacă tabelele de autentificare există |
| 0 | nexus-alpha-bff-migrations |
Baza de date proprie a consolei |
Fiecare Job de migrare are backoffLimit: 0, astfel încât o migrare eșuată duce la eșecul instalării.
Registrul este un singur tabel, nexus_release.schema_applied, cu câte un rând per lanț și amprentă (digest) de imagine. Fiecare hook își scrie rândul doar după ce procesul său de migrare s-a încheiat. Fiecare Deployment care utilizează PostgreSQL conține un container de inițializare (init container), wait-for-schema, care citește acel tabel sub un rol căruia nu îi este permis să citească nimic altceva (nexus_ledger_reader) și așteaptă până când fiecare lanț de care depinde afișează un rând pentru imaginea acestei versiuni. Apoi serviciul pornește. Procesul de lucru workflows așteaptă lanțul orchestratorului, deoarece împarte aceeași bază de date, iar motorul de competențe așteaptă doar etapa de bootstrap.
Acesta interoghează la fiecare 3 secunde (schemaWait.intervalSeconds) și renunță după 1.800 (schemaWait.timeoutSeconds), afișând o linie care numește lanțurile care încă lipsesc. Containerul propriu al serviciului nu pornește niciodată pe o schemă greșită.
kubectl -n nexus logs deploy/nexus-gateway -c wait-for-schemaAcesta este motivul pentru care nu trebuie să rulați niciodată helm install --wait. Cu --wait, Helm așteaptă obiectele Deployment înainte de a rula hook-urile post-instalare, iar obiectele Deployment așteaptă hook-urile. Niciunul nu avansează. Instalați fără acesta și așteptați după aceea; capitolul 2.6, Instalarea ediției Community pe Kubernetes, oferă comanda exactă.
Izolarea pe trei axe
Fiecare citire, scriere, apel de instrument și expediere de competență în Nexus este delimitată ca domeniu (scoped) pe trei axe.
| Axă | Câmp | Ce separă |
|---|---|---|
| Chiriaș (Tenant) | organization_id |
O organizație de alta, o limită strictă |
| Proprietar (Owner) | owner_user_id |
Lucrurile unei persoane de ale tuturor celorlalți, chiar și în interiorul aceleiași organizații |
| Unitate (Unit) | business_unit_id |
O subdiviziune a unei organizații, opțională |
Axa proprietarului îi surprinde pe utilizatori. O căsuță poștală sau un caiet personal este privat pentru proprietarul său chiar și față de colegii din aceeași unitate și cu același rol. Un administrator stabilește politica și nu citește conținutul.
Axele provin din cererea autentificată și de nicăieri altundeva. Nicio variabilă de mediu, antet, parametru de interogare sau segment de cale nu le poate seta. Un corp de cerere care numește o organizație este refuzat cu TENANT_NOT_A_PARAMETER. O suprafață care nu poate preciza cărui chiriaș, proprietar și unitate îi aparține un rând refuză cu 403 SCOPE_PREDICATE_MISSING, iar corpul listează ce axe au fost rezolvate și care nu. Nu revine niciodată la o citire mai largă.
Acest lucru este valabil în două locuri simultan.
În baza de date. Fiecare serviciu se conectează cu propriile sale roluri de execuție (runtime): nexus_auth, auth_app și auth_platform pentru serviciul de identitate, nexus_probitas și nexus_probitas_ledger pentru Probitas, și nexus_gateway, nexus_graphrag, nexus_skills, orchestrator_app, workflows_app și restul pentru celelalte. Niciunul nu este superutilizator (superuser) și nici nu are BYPASSRLS. De asemenea, niciunul nu deține tabelele pe care le utilizează, astfel încât fiecare politică de securitate la nivel de rând (RLS - row-level security) i se aplică. Rolurile împart un grup, nexus_runtime, care acordă dreptul de conectare și de utilizare a schemei și niciun fel de drepturi asupra tabelelor; fiecărui serviciu îi sunt acordate drepturi asupra propriilor tabele prin propriile sale migrări. Setările de chiriaș pe care le citesc politicile RLS pot fi configurate doar prin funcția bind_scope a fiecărui serviciu, care rulează ca proprietar al acesteia. Procesul de bootstrap revocă set_config pentru toți ceilalți, iar orchestratorul și Probitas refuză să pornească dacă rolul lor de execuție ar putea să o apeleze direct (Probitas numește această situație DB_ROLE_SETS_SCOPE_DIRECTLY). Singurele conexiuni de superutilizator din întreaga instalare aparțin acelui Job de bootstrap și pasului de provizionare al BFF-ului.
În primitiva partajată de interogare delimitată ca domeniu. Fiecare depozit (repository) din platformă și fiecare plugin construit pe SDK (kitul de dezvoltare software) moștenește o barieră care construiește predicatul SQL dintr-un domeniu rezolvat. Funcția sa de domeniu preia identitatea verificată și nu are niciun parametru de organizație, astfel încât un apelant nu poate transmite unul, și nicio rută nu poate renunța la această verificare.
Există exact o singură traversare a limitei chiriașului, și aceasta este strictă: o permisiune înregistrată (grant). Două persoane din organizația care deține rândurile înregistrează ce organizație poate citi ce tabele și până când. Fiecare citire rulează într-o tranzacție doar în citire (read-only) și este jurnalizată în ambii chiriași. Proprietarii și administratorii nu citesc niciodată transversal, iar cititorul nu poate lărgi o permisiune.
Calea IA
Apelanții exprimă dorințe. AI Provider Router deține acreditarea și face alegerea finală.
Fiecare apel de model în Nexus trece prin rutele /internal/ai/* ale ruterului, iar ruterul admite doar apelanți numiți. Chart-ul configurează trei liste pe gateway:
| Rute | Cine poate apela |
|---|---|
| Chat și streaming de chat | nexus-orchestrator, nexus-workflows, nexus-skills-engine |
| Reprezentări vectoriale (embeddings) și reclasificare (rerank) | nexus-graphrag, nexus-skills-engine, nexus-workflows |
| Orice altceva, inclusiv execuția instrumentelor | nexus-orchestrator, nexus-workflows |
Un apel fără identitatea apelantului este refuzat cu 403 MISSING_CALLER_IDENTITY, iar un apelant care nu se află pe listă, cu 403 UNAUTHORIZED_CALLER. Pluginurile nu se află pe nicio listă, iar acest lucru este deliberat: apelurile de model ale unui plugin au loc în numele său, prin expedierea UNO.
Ceea ce poate trimite un apelant este o dorință: un furnizor și un model preferat, plus un profil de capabilități, cum ar fi o lungime minimă a contextului sau utilizarea de instrumente. Ruterul onorează o dorință doar atunci când organizația are acel furnizor activat și cu acreditări configurate; în caz contrar, îl substituie, mai întâi în cadrul aceluiași furnizor, apoi între ceilalți furnizori ai organizației. Un profil de capabilități doar filtrează, iar o cerință privind rezidența datelor din cadrul acestuia este strictă. Când nimic nu se potrivește, nu există niciun model de rezervă (fallback): apelantul primește 422 MODEL_CAPABILITY_UNAVAILABLE sau 422 NO_PROVIDER_FOR_ROLE, împreună cu un șir de caractere pentru remediere pe care consola îl afișează unui administrator.
Cheile aparțin organizației. Administratorii fiecărei organizații introduc propriile chei de furnizor în setul acesteia din consolă, iar ruterul le rezolvă la momentul apelului. Nicio cheie de model nu este o valoare în chart și niciuna nu este livrată împreună cu Nexus. O organizație fără nicio cheie nu primește răspunsuri generate de IA, iar consola menționează acest lucru în mod clar; nimic nu suplinește această lipsă din altă parte.
Două valori din chart configurează routerul. ai.localProvider.baseUrl desemnează un server de modele compatibil cu OpenAI pe care îl rulați dumneavoastră, rutat ca orice alt furnizor. ai.installationHosts listează serverele dumneavoastră de modele sub nume private, pe care routerul le consideră ca fiind în interiorul instalării. GraphRAG generează vectori (embeddings) tot prin intermediul routerului, în numele organizației căreia îi aparține conținutul. Modelul implicit de generare a vectorilor rulează în cluster fără placă grafică; vectorii găzduiți extern rămân la latitudinea fiecărei organizații.
Fără telemetrie
Nimic nu părăsește o instalare dacă nu trimiteți dumneavoastră. Valoarea telemetry.enabled a chart-ului poate fi doar false; schema refuză orice altceva. Raportarea proprie a nivelului de date este, de asemenea, oprită: raportul de utilizare al Neo4j și telemetria Qdrant sunt dezactivate în chart.
Cu networkPolicy.enabled activat (valoarea implicită), niciun pod nu poate accesa internetul dacă nu listați destinația în networkPolicy.externalEgressCIDRs. Un furnizor de modele găzduite este o astfel de destinație, la fel și serverul dumneavoastră de relay pentru e-mail.
Aceeași regulă a modificat o setare implicită pe care o veți observa. Sistemul CAPTCHA al nexus-auth pentru înregistrări necesită un serviciu de internet, astfel că pe o instalare este dezactivat, iar înregistrarea unui necunoscut așteaptă aprobarea unui administrator (403 SIGNUP_REQUIRES_APPROVAL). Filtrul care blochează înregistrările din rețelele de găzduire este, de asemenea, dezactivat, deoarece necesită baze de date licențiate pe care Nexus nu le include. Pierdeți această filtrare.

