Verzija 1.0.0-alpha.1najnovije
Poglavlje 2.1
Arhitektura
Čime upravlja svaki servis u Nexus chartu i koja se spremišta nalaze ispod njega, a zatim pravila koja ih drže na okupu, od identiteta između servisa do putanje kojom prolazi svaki poziv modelu.
Ovu je stranicu s engleskog izvornika preveo AI. Ako je išta nejasno, mjerodavna je stranica na engleskom jeziku. Pročitajte ovu stranicu na engleskom jeziku

Kada je Tomás Reilly završio prvu instalaciju u organizaciji Harrow Port Authority, kubectl -n nexus get pods je prikazao deset resursa Deployment i sedam resursa StatefulSet, uz tri resursa CronJob. Resursi Job za migraciju koji su izgradili bazu podataka već su nestali jer se svaki sam izbriše nakon što uspije. Taj je ispis cijela platforma. Naučite ga, jer većina pitanja u daljnjem radu počinje s „koji je od ovih vlasnik toga?”.
Ovo poglavlje odgovara na to za svaki dio, prati jedan zahtjev kroz njih, a zatim obrađuje pravila kojih se svi pridržavaju. Ostatak 2. dijela nadovezuje se na ovu sliku.
Servisi i čime svaki od njih upravlja
Predložak je jedan Helm chart, nexus, verzija 1.0.0-alpha.1, za Kubernetes 1.33 ili noviji. Svaki radni zadatak izvodi se pod vlastitim resursom ServiceAccount, kao korisnik bez ovlasti root, sa svim uklonjenim mogućnostima sustava Linux. Pozivi prema servisima koji čuvaju identitet i ključeve odvijaju se putem uzajamnog protokola TLS (Transport Layer Security), a javni API (aplikacijsko programsko sučelje) dijeli proces s usmjerivačem za AI (umjetnu inteligenciju).
| Komponenta | Deployment i Service | Priključak servisa | Čemu je vlasnik |
|---|---|---|---|
| Konzola | nexus-alpha |
3000 | Stranice koje ljudi vide; poslužuje HTML (Hypertext Markup Language) na poslužitelju konzole |
| BFF (backend za frontend) | nexus-alpha-bff |
8080 | Vlastiti podaci konzole, izbornik koji svaka osoba dobiva, registar izdanja |
| Autentifikacija | nexus-auth |
9101 (uzajamni TLS na 8443) | Ljudi, organizacije, sesije, tokeni, ključevi za API, skup ključeva modela organizacije |
| Pristupnik | nexus-gateway |
9092, WebSocket 8093 | AI Provider Router te rubni javni API za REST (representational state transfer) i MCP (Model Context Protocol) |
| Orkestrator | nexus-orchestrator |
8080 | UNO otprema: prihvaćanje svakog posla i njegovo stavljanje u red čekanja |
| Radni tokovi | nexus-workflows |
8081 | UNO izvršavanje: radni proces koji izvodi poslove iz reda čekanja |
| GraphRAG | nexus-graphrag |
8090, WebSocket 8091 | Memorija: graf znanja i dohvaćanje podataka nad njim |
| Probitas | nexus-probitas |
9151 (HTTPS) | Dokazi: zapisi o upravljanju i zapečaćena glavna knjiga |
| Pogon za vještine | nexus-skills-engine |
8095 | Biblioteka vještina; pronalaženje i pokretanje vještina |
| Ključevi | nexus-keys |
8080 (HTTPS, uzajamni TLS) | Ključevi po organizaciji u sustavu OpenBao, skrbništvo, identitet instalacije |
| Dodaci | nexus-plugins |
9111 | Registar dodataka i zapisi kataloga; zadano isključeno |
| Obrada datoteka | nexus-fileprocess |
9109 | Čitanje učitanih dokumenata i slika; zadano isključeno |
Prvih deset je obavezno. Posljednja dva su neobavezna i uključuju se pomoću components.plugins.enabled i components.fileprocess.enabled kada ih koristi instalacija izdanja Enterprise ili domenski paket. Još jedan neobavezni servis, nexus-alive na priključku 8080, ima vlastiti prekidač, components.alive.enabled, te je također zadano isključen. Replike i resursi za svaki od njih nalaze se pod components.<name>.
Konzola se sastoji od stranica iscrtanih na poslužitelju bez baze podataka. Komunicira sa servisom BFF i sa servisom nexus-auth unutar klastera, nikada prema van kroz javni poslužitelj za autentifikaciju pa natrag unutra. Odbija se pokrenuti bez svojeg izdanja, koje chart prosljeđuje kao NEXUS_EDITION iz jedine vrijednosti edition. Svaki član organizacije radi u njoj u skladu sa svojom ulogom. Administracijske stranice namijenjene su vlasnicima i administratorima, a član koji otvori neku od njih dobiva stranicu „Niste administrator”.
BFF je poslužiteljska polovica konzole i izgrađen je kao dodatak platforme, registriran kao proizvod Nexus Alpha. Drži vlastite tablice konzole u zasebnoj bazi podataka, nexus_alpha, i odlučuje koje grupe izbornika osoba vidi. Kada konzola treba obaviti neki posao, BFF to zatraži od servisa koji je za njega nadležan.
nexus-auth je napisan u jeziku Go i jedini je servis koji izdaje tokene. Pristupni tokeni zadano vrijede 15 minuta, a tokeni za osvježavanje 12 sati (auth.accessTokenTTL, auth.refreshTokenTTL). Ograničava svaku prijavljenu osobu na 5,000 zahtjeva u minuti prije nego što odgovori statusom 429 (auth.rateLimitPerMinute). Pokreće dva osluškivača: obični na priključku kontejnera 8080 do kojeg dolazi javni Ingress i onaj s uzajamnim protokolom TLS na priključku 8443 koji mora koristiti svaki pozivatelj unutar klastera. Vjeruje zaglavlju X-Forwarded-For samo sa skokova u proxy.trustedCIDRs, popisu raspona Classless Inter-Domain Routing (CIDR), koji je zadano postavljen na 10.42.0.0/16, mrežu podova sustava k3s. Ako se vaš upravljač resursa Ingress izvodi negdje drugdje, promijenite to. U suprotnom svaka prijava izgleda kao da je došla od upravljača.
Gateway ima dva zadatka koji dijele jedan proces. Unutar klastera on je AI Provider Router (AI centrala u 1. dijelu i na stranicama konzole), jedini nositelj vjerodajnica modela organizacije (više o tome u nastavku). Na rubu mreže on je ono do čega api.<domain> dolazi: klijenti za REST i klijenti za MCP, čiji tokeni nose primatelja https://<hosts.api>/mcp i dolaze s autorizacijskog poslužitelja OAuth 2.1 na poslužitelju za autentifikaciju (OAuth je otvoreni standard za delegiranu autorizaciju).
Orchestrator i workflows zajedno čine UNO, pogon za tijekove rada. Sva se obrada odvija kroz njih. Orchestrator prihvaća posao na POST /api/v1/dispatch, odgovara statusom 202 uz jobId, runId i traceId te ga stavlja u red čekanja. Ne postoji putanja za izravno izvršavanje: klijent uvijek periodički provjerava GET /api/v1/dispatch/{jobId} ili prima povratni poziv. Radni proces workflows povlači poslove iz reda čekanja, zadano po četiri odjednom po replici (workflows.concurrency), i ima točno jednu HTTP rutu, GET /health.
Probitas je servis za dokaze. Sam poslužuje TLS pomoću certifikata koji izdaje chart, a svoje tablice drži u shemi trust sa zasebnom ulogom za glavnu knjigu. Njegovim značajkama upravljanja upravlja se pomoću probitas.flags. Nekoliko ih se isporučuje u načinu rada shadow: pravorijek se izračunava i bilježi, a ništa se ne blokira dok ne promijenite zastavicu.
nexus-keys je platformski servis za ključeve, napisan u jeziku Go. Čuva po jedan ključ za svaku organizaciju u spremištu ključeva OpenBao i rotira ih svake noći. Njegovi noćni poslovi također uništavaju ključeve kojima je nastupio datum zadržavanja i izvoze njegove potvrde na vlastiti volumen. Brisanjem ključa organizacije podaci zaključani njime postaju trajno nečitljivi. Također stvara identitet instalacije pri prvom pokretanju, pod keys.installationName, i taj je naziv trajan. Odaberite ga pažljivo: chart odbija prazan naziv (INSTALLATION_NAME_MISSING) i odbija naziv iz vlastitih primjera vrijednosti (INSTALLATION_NAME_EXAMPLE).
Tri javna poslužitelja
Chart objavljuje točno tri naziva poslužitelja, koji zajedno čine identitet instalacije. Svaki se servis odbija pokrenuti bez njih.
| Ingress | Vrijednost poslužitelja | Pozadinski servis |
|---|---|---|
nexus-console |
hosts.console |
nexus-alpha, priključak 3000 |
nexus-api |
hosts.api |
nexus-gateway, priključak 9092 |
nexus-auth |
hosts.auth |
nexus-auth, priključak 9101 |
Primjeri u ovoj knjizi koriste console.harrow.example, api.harrow.example i auth.harrow.example. Resursi Ingress su obični objekti networking.k8s.io/v1 s po jednim pravilom, putanjom /. TLS na rubu mreže slijedi tls.mode: existing (resurs Secret koji ste izradili, naveden u tls.existingSecret), cert-manager (resurs ClusterIssuer koji održavate, naveden u tls.clusterIssuer) ili none (TLS završava ispred klastera). Chart ne dodaje vlastito preusmjeravanje, tako da HTTP izazov protokola ACME (Automated Certificate Management Environment) stiže do vašeg rješavača nepromijenjen. Poglavlje 2.11, Varijacije: vanjska spremišta, TLS i ingress, obrađuje svaki način rada.
Ništa drugo nije izloženo. Spremišta podataka, OpenBao i svaki interni servis osluškuju samo unutar imenskog prostora.
Zahtjev, od početka do kraja
Evo što se događa kada Aoife Brennan, voditeljica IT-ja u organizaciji Harrow, otvori konzolu i postavi asistentu pitanje o ovomejesečnom rasporedu vezova.
- Njezin preglednik učitava
https://console.harrow.example. Resurs Ingressnexus-consolešalje zahtjev nanexus-alphana priključku 3000. - Prijavljuje se svojim pristupnim ključem. Stranice za prijavu komuniciraju s
nexus-authputemauth.harrow.example, a nexus-auth joj izdaje pristupni token koji nosi njezina korisnika, njezinu organizaciju i, kada ga njezina sesija ima, njezinu poslovnu jedinicu. - Poslužitelj konzole poziva BFF, koji provjerava njezin token i pita nexus-auth posjeduje li njezina organizacija proizvod i ima li njezina uloga dopuštenje. Odgovara grupama izbornika koje ona smije vidjeti.
- Njezino pitanje ide od servisa BFF do rute za otpremu servisa orchestrator, pri čemu se njezina organizacija i korisnik preuzimaju iz provjerenog tokena. Orchestrator odgovara statusom 202 i stavlja posao u red čekanja u sustavu Valkey.
- Radni proces workflows preuzima posao. Vještinu koju izvodi razrješava pogon za vještine, a dohvaćanje nad dokumentima organizacije Harrow ide u GraphRAG, koji čita Neo4j, Qdrant i svoju shemu u bazi PostgreSQL.
- Poziv modela ide u AI Provider Router na
/internal/ai/chat. Usmjerivač odabire pružatelja i model iz vlastitog skupa ključeva i politike usmjeravanja organizacije Harrow, upućuje poziv s ključem organizacije Harrow i vraća dovršetak. - Rezultat se zapisuje u redak izvođenja posla. BFF ga čita, a konzola iscrtava odgovor, zajedno s njegovim citatima.
Skokovi između servisa nose projicirane tokene servisa, oni prema servisima nexus-auth, nexus-keys i Probitas odvijaju se putem protokola TLS iz vlastitog certifikacijskog tijela instalacije, a svaki pristup podacima u koracima od 4 do 6 ograđen je na organizaciju Harrow u samoj bazi podataka. Odjeljci u nastavku objašnjavaju oboje.
Podatkovni sloj
Nexus isporučuje vlastitu potpisanu kopiju svakog spremišta, s ponudom izvornog koda za svako od njih u paketu. Svako je odabrano jednako zbog svoje licencije koliko i zbog svoje funkcije.
| Spremište | Verzija | Licencija | Zašto je tamo | Priključak | Zadani volumen |
|---|---|---|---|---|---|
| PostgreSQL uz PostGIS i pgvector | PostgreSQL 16, PostGIS 3, pgvector 0.8 | PostgreSQL licenca; PostGIS GPL-2.0-or-later | Sustav zapisa za svaki servis; PostGIS za kartografske podatke; pgvector za vektore koji se čuvaju uz retke | 5432 | 50 GiB |
| Valkey | 8.1 | BSD-3-Clause | Redovi čekanja poslova sustava UNO i kratkotrajne predmemorije, kao što je predmemorija ključeva za API servisa nexus-auth | 6379 | 5 GiB |
| Neo4j Community Edition | 5.26 | GPL-3.0 | Graf znanja koji GraphRAG gradi i pretražuje | 7687 (Bolt) | 20 GiB |
| Qdrant | 1.15 | Apache-2.0 | Vektorsko pretraživanje za GraphRAG i pogon za vještine | 6333 (HTTP), 6334 (gRPC udaljeni pozivi procedura) | 10 GiB |
| SeaweedFS | 4.48 | Apache-2.0 | Objektna pohrana za datoteke, kompatibilna s uslugom Amazon Simple Storage Service (S3) | 8333 | 50 GiB |
| OpenBao | 2.6 | MPL-2.0 | Spremište ključeva i njegov servis za otpečaćivanje, za nexus-keys | 8200 | 5 GiB i 1 GiB |
Neki su odabiri zamijenili nešto poznatije. Valkey mijenja Redis 7.4, čije trenutačne licencije ovo izdanje odbija. MinIO je pod licencijom AGPL-3.0, pa je objektno spremište SeaweedFS. GraphRAG pristupa sustavu Neo4j Community Edition putem mrežnog protokola Bolt, a servisi pristupaju proširenju PostGIS putem protokola baze PostgreSQL, tako da licencija GPL ostaje uz svakog od njih. OpenBao je ogranak sustava Vault pod okriljem organizacije Linux Foundation nastao prije promjene licencije sustava Vault.
Svako se spremište izvodi s uključenom autentifikacijom i generiranim vjerodajnicama: zaporkom za Valkey, ključem za API za Qdrant, pristupnim ključevima za SeaweedFS.
Svako od pet spremišta pod dataTier izvodi se u klasteru (mode: in-cluster, zadano) ili je riječ o spremištu kojim već sami upravljate (mode: external, uz external.host i resurs Secret naveden pomoću external.existingSecret). Za vanjski PostgreSQL postavite sslmode na verify-full ili verify-ca i stavite certifikat certifikacijskog tijela (CA) poslužitelja u taj Secret; poglavlje 2.11, Varijacije: vanjska spremišta, TLS i ingress, sadrži pojedinosti.
# 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-postgresPar OpenBao je iznimka: uvijek se izvodi unutar instalacije, jer ga tamo inicijalizira skrbnički Job.
Identitet između servisa
Nexus se izvodi bez servisne mreže (service mesh). Uzajamni TLS dolazi iz lokalnog certifikacijskog tijela (CA) koje chart stvara putem alata cert-manager, koji mora biti prethodno instaliran (testirana je verzija v1.21.3).
Samopotpisani Issuer izrađuje jedan CA certifikat, nexus-local-ca, ECDSA (Elliptic Curve Digital Signature Algorithm) P-256, valjan deset godina. Drugi Issuer potpisuje tim CA certifikatom. Svaki radni zadatak koji poziva TLS poslužitelj unutar instalacije dobiva vlastiti klijentski certifikat, nazvan <service-account>-client-tls, valjan 90 dana i obnovljen 15 dana prije isteka. Njegov je jedini naziv jedinstveni identifikator resursa (URI) u obliku identiteta SPIFFE:
spiffe://cluster.local/ns/<namespace>/sa/<service-account>
Svaki radni zadatak pronalazi javni certifikat CA-a kao ca.crt u vlastitom resursu Secret za certifikat. Nijedan pod ne montira ključ CA-a i ne treba vam trust-manager.
Tri servisa provjeravaju pozivatelje pomoću certifikata. nexus-auth to čini na svojem drugom osluškivaču, priključku 8443, i svaki pozivatelj unutar klastera bira taj priključak. nexus-keys to čini na svojem jedinom osluškivaču. Probitas poslužuje TLS iz vlastitog certifikata, nexus-probitas-tls, koji ponovno učitava kada ga cert-manager obnovi. Nijedan ne vjeruje zaglavlju X-Forwarded-Client-Cert.
Svaki radni zadatak također dobiva jednosatne tokene sustava Kubernetes na /var/run/secrets/nexus, po jedan za svaki servis koji poziva, s tim servisom kao primateljem. ConfigMap nexus-service-identities mapira svaki <namespace>/<service-account> na naziv servisa ili dodatka, a radni zadatak koji u njemu nedostaje nema identitet te biva odbijen. Orchestrator i Probitas provjeravaju te tokene pomoću API-ja sustava Kubernetes. Od pokrenutih servisa, samo ta dva imaju system:auth-delegator ili montiran token za API; jedini drugi radni zadatak s tokenom je skrbnički Job koji se izvodi pri instalaciji.
Mrežna politika zatvara ono što identitet ne zatvara. Chart kreće od zadanog odbijanja, a zatim propušta promet između vlastitih podova instalacije, sustava DNS (Domain Name System), imenskog prostora upravljača resursa Ingress (networkPolicy.ingressNamespace, zadano kube-system) prema trima javnim resursima Service te poslužitelja API-ja za dva provjeravatelja tokena. Podovi sustava OpenBao nose drugačiju oznaku od ostatka platforme, pa otvoreno pravilo unutar imenskog prostora ne dopire do njih: prolaze samo nexus-keys, njegovi resursi Job i skrbnički Job, na priključku 8200. Sve ostalo do čega radni zadatak mora doći izvan imenskog prostora, poput vašeg posrednika za e-poštu, ide u networkPolicy.externalEgressCIDRs, koji je zadano prazan.
Migracije i glavna knjiga sheme
Migracije se izvode kao kuke sustava Helm, na post-install i pre-upgrade. Kuka post-install izvodi se nakon što su stvoreni resursi Deployment tog izdanja. Stoga se pri prvoj instalaciji servisi pokreću dok njihove sheme još ne postoje, pa bi ušli u petlju rušenja prema bazi podataka bez uloge, bez zaporke i bez tablica. Nexus to izbjegava pomoću glavne knjige.
Kuke se izvode prema redoslijedu težine, a Helm čeka svaki Job prije nego što započne sljedeća težina:
| Težina | Kuka | Što radi |
|---|---|---|
| -30 | nexus-migrations-env i preduvjeti |
Stvara Secret samo za kuke s vjerodajnicama migratora i svime što skrbnički Job čita |
| -20 | nexus-db-bootstrap |
Stvara baze podataka nexus i nexus_alpha, ulogu migratora, izvršnu ulogu svakog servisa, proširenja i glavnu knjigu |
| -15 | nexus-openbao-custody-init |
Inicijalizira spremište ključeva i servis za otpečaćivanje te stvara identitet instalacije |
| -12 | nexus-graphrag-migrations |
Shema servisa GraphRAG, koja je vlasnik objekata na koje se poziva osnovica servisa nexus-auth |
| -10 | nexus-auth-migrations |
Shema identiteta |
| -5 | migracije servisa orchestrator, gateway i Probitas | Njihove sheme; Probitas najprije provjerava postoje li tablice za autentifikaciju |
| 0 | nexus-alpha-bff-migrations |
Vlastita baza podataka konzole |
Svaki migracijski Job ima backoffLimit: 0, pa neuspjela migracija ruši instalaciju.
Glavna knjiga je jedna tablica, nexus_release.schema_applied, s po jednim retkom za svaki lanac i sažetak slike. Svaka kuka zapisuje svoj redak tek nakon što njezin pokretač migracije završi. Svaki Deployment koji koristi PostgreSQL nosi inicijalizacijski kontejner, wait-for-schema, koji čita tu tablicu kao uloga kojoj nije dopušteno čitati ništa drugo (nexus_ledger_reader) i čeka dok svaki lanac o kojem ovisi ne pokaže redak za sliku ovog izdanja. Tada se servis pokreće. Radni proces workflows čeka lanac servisa orchestrator, budući da dijeli tu bazu podataka, a pogon za vještine čeka samo inicijalizaciju (bootstrap).
Periodički provjerava svake 3 sekunde (schemaWait.intervalSeconds) i odustaje nakon 1800 (schemaWait.timeoutSeconds) uz redak u kojem su navedeni lanci koji još uvijek nedostaju. Vlastiti kontejner servisa nikada se ne pokreće nad pogrešnom shemom.
kubectl -n nexus logs deploy/nexus-gateway -c wait-for-schemaZbog toga nikada ne smijete pokrenuti helm install --wait. Uz --wait, Helm čeka resurse Deployment prije nego što pokrene kuke post-install, a resursi Deployment čekaju kuke. Ništa se ne pomiče. Instalirajte bez toga i pričekajte nakon instalacije; poglavlje 2.6, Instaliranje izdanja Community na sustavu Kubernetes, daje točnu naredbu.
Izolacija na tri osi
Svako čitanje, pisanje, poziv alata i otprema vještine u sustavu Nexus ograničeni su dosezi na tri osi.
| Os | Polje | Što odvaja |
|---|---|---|
| Zakupnik | organization_id |
Jednu organizaciju od druge, čvrsta granica |
| Vlasnik | owner_user_id |
Stvari jedne osobe od stvari svih ostalih, čak i unutar iste organizacije |
| Jedinica | business_unit_id |
Podjedinicu organizacije, neobavezno |
Os vlasnika iznenađuje ljude. Poštanski sandučić ili osobna bilježnica privatni su za svog vlasnika čak i u odnosu na kolege u istoj jedinici s istom ulogom. Administrator postavlja pravila i ne čita sadržaj.
Osi dolaze iz autentificiranog zahtjeva i niotkuda drugdje. Nijedna varijabla okruženja, zaglavlje, parametar upita ili segment putanje ne može ih postaviti. Tijelo zahtjeva koje navodi organizaciju odbija se uz TENANT_NOT_A_PARAMETER. Površina koja ne može navesti kojem zakupniku, vlasniku i jedinici pripada pojedini redak odbija zahtjev statusom 403 SCOPE_PREDICATE_MISSING, a u tijelu se navodi koje su se osi razriješile, a koje nisu. Nikada se ne vraća na šire čitanje.
To vrijedi na dva mjesta istodobno.
U bazi podataka. Svaki se servis povezuje putem vlastitih izvršnih uloga: nexus_auth, auth_app i auth_platform za servis identiteta, nexus_probitas i nexus_probitas_ledger za Probitas te nexus_gateway, nexus_graphrag, nexus_skills, orchestrator_app, workflows_app i ostale za druge servise. Nijedna nije superkorisnik niti ima ovlast BYPASSRLS. Nijedna nije ni vlasnik tablica koje koristi, tako da se na nju primjenjuje svako pravilo sigurnosti na razini retka (RLS). Uloge dijele grupu, nexus_runtime, koja daje pravo povezivanja i korištenja sheme te nikakva prava nad tablicama; svakom se servisu prava nad njegovim tablicama dodjeljuju kroz njegove vlastite migracije. Postavke zakupnika koje čitaju RLS pravila mogu se postaviti samo putem funkcije bind_scope pojedinog servisa, koja se izvodi s ovlastima svojeg vlasnika. Inicijalizacija (bootstrap) opoziva set_config svima ostalima, a orchestrator i Probitas odbijaju se pokrenuti ako bi ga njihova izvršna uloga mogla izravno pozvati (Probitas to naziva DB_ROLE_SETS_SCOPE_DIRECTLY). Jedine superkorisničke veze u cijeloj instalaciji pripadaju inicijalizacijskom resursu Job i koraku dodjele resursa servisa BFF.
U zajedničkom primitivu za upite s ograničenim dosezima. Svaki repozitorij u platformi i svaki dodatak izgrađen na SDK-u (kompletu za razvoj softvera) nasljeđuje jednu ogradu koja gradi SQL predikat iz razriješenog dosega. Njegova funkcija dosega prima provjereni identitet i nema parametar organizacije, tako da ga pozivatelj ne može proslijediti i nijedna se ruta ne može izuzeti.
Postoji točno jedan prijelaz granice zakupnika, i on je uzak: zabilježeno odobrenje. Dvije osobe u organizaciji koja drži retke bilježe koja organizacija smije čitati koje tablice i do kada. Svako se čitanje izvodi u transakciji samo za čitanje i bilježi u dnevnik kod oba zakupnika. Vlasnici i administratori nikada ne čitaju preko granice, a čitatelj ne može proširiti odobrenje.
Putanja AI-ja
Pozivatelji izražavaju želje. AI Provider Router posjeduje vjerodajnicu i donosi konačni odabir.
Svaki poziv modela u sustavu Nexus prolazi kroz rute /internal/ai/* usmjerivača, a usmjerivač propušta samo imenovane pozivatelje. Chart postavlja tri popisa na servisu gateway:
| Rute | Tko smije pozivati |
|---|---|
| Razgovor i strujanje razgovora | nexus-orchestrator, nexus-workflows, nexus-skills-engine |
| Ugradnje (embeddings) i ponovno rangiranje | nexus-graphrag, nexus-skills-engine, nexus-workflows |
| Sve ostalo, uključujući izvršavanje alata | nexus-orchestrator, nexus-workflows |
Poziv bez identiteta pozivatelja odbija se statusom 403 MISSING_CALLER_IDENTITY, a pozivatelj koji nije na popisu statusom 403 UNAUTHORIZED_CALLER. Dodaci nisu ni na jednom popisu, i to je namjerno: pozivi modela nekog dodatka odvijaju se u njegovo ime, putem UNO otpreme.
Ono što pozivatelj smije poslati jest želja: željeni pružatelj i model, uz profil mogućnosti kao što je minimalna duljina konteksta ili korištenje alata. Usmjerivač poštuje želju samo kada organizacija ima omogućenog tog pružatelja i njegove vjerodajnice; u suprotnom vrši zamjenu, najprije unutar istog pružatelja, a zatim među ostalim pružateljima organizacije. Profil mogućnosti samo filtrira, a zahtjev za smještajem podataka u njemu je strog. Kada ništa ne odgovara, nema pričuvnog modela: pozivatelj dobiva 422 MODEL_CAPABILITY_UNAVAILABLE ili 422 NO_PROVIDER_FOR_ROLE, uz uputu za otklanjanje problema koju konzola prikazuje administratoru.
Ključevi pripadaju organizaciji. Administratori svake organizacije unose vlastite ključeve pružatelja u njezin skup iz konzole, a usmjerivač ih razrješava u trenutku poziva. Nijedan ključ modela nije vrijednost u predlošku chart i nijedan se ne isporučuje sa sustavom Nexus. Organizacija bez ključa ne dobiva nikakve AI odgovore, i konzola to jasno kaže; ništa ne popunjava prazninu s nekog drugog mjesta.
Dvije vrijednosti charta oblikuju usmjerivač. ai.localProvider.baseUrl imenuje poslužitelj modela kompatibilan s OpenAI-jem koji sami pokrećete, a usmjerava se kao i svaki drugi pružatelj usluga. ai.installationHosts navodi vaše poslužitelje modela na privatnim nazivima, koje usmjerivač računa kao unutar instalacije. GraphRAG također ugrađuje (embeds) putem usmjerivača, u ime organizacije čiji je to sadržaj. Zadani model za ugradnju izvodi se u klasteru bez grafičke kartice; hostane ugradnje izbor su svake pojedine organizacije.
Bez telemetrije
Ništa ne napušta instalaciju osim ako to sami ne pošaljete. Vrijednost telemetry.enabled u chartu može biti samo false; shema odbija sve ostalo. Vlastito izvješćivanje podatkovnog sloja također je isključeno: Neo4j izvješće o korištenju i Qdrant telemetrija onemogućeni su u chartu.
Kada je networkPolicy.enabled uključen, što je zadana postavka, nijedan pod ne može pristupiti internetu osim ako odredište ne navedete u networkPolicy.externalEgressCIDRs. Hostani pružatelj modela jedno je takvo odredište, kao i vaš poslužitelj za prosljeđivanje e-pošte (mail relay).
Isto je pravilo promijenilo jednu zadanu postavku koju ćete primijetiti. CAPTCHA servisa nexus-auth za registracije zahtijeva internetsku uslugu, pa je na instalaciji isključena, a registracija nepoznatog korisnika čeka odobrenje administratora (403 SIGNUP_REQUIRES_APPROVAL). Provjera koja blokira registracije s hosting mreža također je isključena jer zahtijeva licencirane baze podataka koje Nexus ne isporučuje. Gubite tu provjeru.

