PrijavaZakažite brifing

Poglavlje 2.1

Arhitektura

Za šta je odgovoran svaki servis u Nexus chartu i koja skladišta se 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 stranicu je sa engleskog originala prevela AI tehnologija. Ako nešto nije jasno, merodavna je stranica na engleskom. Pročitajte ovu stranicu na engleskom

19 min čitanja

Kada je Tomás Reilly završio prvu instalaciju u Harrow Port Authority, kubectl -n nexus get pods je prikazao deset Deployment objekata i sedam StatefulSet objekata, plus tri CronJob objekta. Jobovi za migraciju koji su izgradili bazu podataka već su bili nestali, jer se svaki od njih sam briše kada uspešno završi. Taj spisak predstavlja celu platformu. Upoznajte ga, jer većina pitanja iz svakodnevnog rada počinje sa „koja od ovih komponenti je vlasnik toga?“

Ovo poglavlje odgovara na to pitanje za svaku komponentu, prati jedan zahtev kroz njih, a zatim obrađuje pravila kojih se sve pridržavaju. Ostatak Dela 2 nadograđuje se na ovu sliku.

Servisi i čime svaki od njih upravlja

Chart je jedan Helm chart, nexus, verzija 1.0.0-alpha.1, za Kubernetes 1.33 ili noviji. Svako opterećenje radi pod sopstvenim ServiceAccount nalogom, kao korisnik koji nije root, uz uklonjene sve Linux mogućnosti (capabilities). Pozivi ka servisima koji štite identitet i ključeve idu preko uzajamnog TLS-a (Transport Layer Security), a javni API (interfejs za programiranje aplikacija) deli proces sa AI (veštačka inteligencija) ruterom.

Komponenta Deployment i Service Port servisa Za šta je zadužena
Konzola nexus-alpha 3000 Stranice koje ljudi vide; isporučuje HTML (Hypertext Markup Language) na hostu konzole
BFF (backend za frontend) nexus-alpha-bff 8080 Sopstveni podaci konzole, meni koji dobija svaka osoba, registar izdanja
Auth nexus-auth 9101 (uzajamni TLS na 8443) Osobe, organizacije, sesije, tokeni, API ključevi, skup ključeva za modele organizacije
Gateway nexus-gateway 9092, WebSocket 8093 AI Provider Router i ivica javnog API-ja za REST (representational state transfer) i MCP (Model Context Protocol)
Orchestrator nexus-orchestrator 8080 UNO otpremanje: prihvatanje svakog posla i stavljanje u red čekanja
Workflows nexus-workflows 8081 UNO izvršavanje: radni proces koji izvršava poslove iz reda čekanja
GraphRAG nexus-graphrag 8090, WebSocket 8091 Memorija: graf znanja i pretraživanje nad njim
Probitas nexus-probitas 9151 (HTTPS) Dokazi: zapisi o upravljanju i zapečaćena knjiga zapisa
Mehanizam veština nexus-skills-engine 8095 Biblioteka veština; pronalaženje i pokretanje veština
Ključevi nexus-keys 8080 (HTTPS, uzajamni TLS) Ključevi po organizaciji u OpenBao, čuvanje, identitet instalacije
Dodaci nexus-plugins 9111 Registar dodataka i zapisi kataloga; podrazumevano isključeno
Obrada datoteka nexus-fileprocess 9109 Čitanje otpremljenih dokumenata i slika; podrazumevano isključeno

Prvih deset komponenti je obavezno. Poslednje dve su opcione i uključuju se pomoću components.plugins.enabled i components.fileprocess.enabled kada ih koristi Enterprise instalacija ili paket za određeni domen. Još jedan opcioni servis, nexus-alive na portu 8080, ima sopstveni prekidač, components.alive.enabled, i takođe je podrazumevano isključen. Replike i resursi za svaku komponentu nalaze se pod components.<name>.

Konzola se sastoji od stranica koje se generišu na serveru, bez baze podataka. Komunicira sa BFF-om i sa nexus-auth unutar klastera, nikada spolja preko javnog auth hosta i nazad. Odbija da se pokrene bez svog izdanja, koje joj chart prosleđuje kao NEXUS_EDITION iz jedne vrednosti edition. Svaki član organizacije radi u njoj u skladu sa svojom ulogom. Administrativne stranice namenjene su vlasnicima i administratorima, a član koji otvori neku od njih dobija stranicu „Niste administrator“.

BFF je serverska polovina konzole i izgrađen je kao dodatak platforme, registrovan kao proizvod Nexus Alpha. Sopstvene tabele konzole čuva u zasebnoj bazi podataka, nexus_alpha, i odlučuje koje grupe menija osoba vidi. Kada konzoli treba da se obavi neki posao, BFF se obraća servisu koji je za njega zadužen.

nexus-auth je napisan u jeziku Go i jedini je servis koji izdaje tokene. Pristupni tokeni podrazumevano važe 15 minuta, a tokeni za osvežavanje 12 sati (auth.accessTokenTTL, auth.refreshTokenTTL). Svaku prijavljenu osobu ograničava na 5.000 zahteva u minuti pre nego što odgovori sa 429 (auth.rateLimitPerMinute). Pokreće dva listenera: običan na portu kontejnera 8080, do kojeg stiže javni Ingress, i jedan sa uzajamnim TLS-om na 8443, koji mora da koristi svaki pozivalac unutar klastera. Vrednosti X-Forwarded-For veruje samo od skokova navedenih u proxy.trustedCIDRs, listi opsega Classless Inter-Domain Routing (CIDR), koja je podrazumevano 10.42.0.0/16, mreža podova k3s. Ako Vaš ingress kontroler radi negde drugde, promenite je. U suprotnom će svaka prijava izgledati kao da je došla od kontrolera.

Gateway ima dva zadatka koji dele jedan proces. Unutar klastera to je AI Provider Router (AI komutator iz Dela 1 i sa stranica konzole), jedini koji čuva akreditive organizacije za modele (više o tome u nastavku). Na ivici je to ono do čega stiže api.<domain>: REST klijenti i MCP klijenti, čiji tokeni nose publiku https://<hosts.api>/mcp i dolaze od OAuth 2.1 servera za autorizaciju na auth hostu (OAuth je otvoreni standard za delegiranu autorizaciju).

Orchestrator i workflows zajedno čine UNO, mehanizam za radne tokove. Sva obrada se odvija kroz njih. Orchestrator prihvata posao na POST /api/v1/dispatch, odgovara sa 202 uz jobId, runId i traceId, i stavlja ga u red čekanja. Ne postoji putanja za direktno izvršavanje: klijent uvek proverava GET /api/v1/dispatch/{jobId} ili prima povratni poziv. Radni proces workflows preuzima poslove iz reda čekanja, podrazumevano po četiri istovremeno po replici (workflows.concurrency), i ima tačno jednu HTTP rutu, GET /health.

Probitas je servis za dokaze. Sam isporučuje TLS, sa sertifikatom koji izdaje chart, i svoje tabele čuva u šemi trust, sa zasebnom ulogom za knjigu zapisa. Njegove funkcije upravljanja uključuju se pomoću probitas.flags. Nekoliko njih se isporučuje u režimu shadow: presuda se izračunava i beleži, a ništa se ne blokira dok ne promenite indikator.

nexus-keys je servis za ključeve platforme, napisan u jeziku Go. Čuva po jedan ključ za svaku organizaciju u OpenBao skladištu ključeva i rotira ih svake noći. Njegovi noćni poslovi takođe uništavaju ključeve kojima je istekao rok čuvanja i izvoze njegove potvrde na sopstveni volumen. Brisanje ključa organizacije trajno čini nečitljivim podatke zaključane njime. On takođe izdaje identitet instalacije pri prvom pokretanju, pod keys.installationName, i to ime je trajno. Pažljivo ga izaberite: chart odbija prazno ime (INSTALLATION_NAME_MISSING) i odbija ime iz sopstvenih primera vrednosti (INSTALLATION_NAME_EXAMPLE).

Ova instalacija (Community)
Ova instalacija (Community)
Sopstvena stranica Community instalacije prikazuje njenu verziju i stanje mehanizama. Jasno navodi da licenca nije potrebna. Enterprise delovi stranice prikazani su kao najave.

Tri javna hosta

Chart objavljuje tačno tri imena hostova, koja zajedno čine identitet instalacije. Svaki servis odbija da se pokrene bez njih.

Ingress Vrednost hosta 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

Primeri u ovoj knjizi koriste console.harrow.example, api.harrow.example i auth.harrow.example. Ingress objekti su obični networking.k8s.io/v1 objekti sa po jednim pravilom, putanja /. TLS na ivici prati tls.mode: existing (Secret koji ste Vi napravili, naveden u tls.existingSecret), cert-manager (ClusterIssuer koji Vi pokrećete, naveden u tls.clusterIssuer) ili none (TLS se završava ispred klastera). Chart ne dodaje sopstveno preusmeravanje, tako da ACME (Automated Certificate Management Environment) HTTP izazov stiže do Vašeg rešavača nepromenjen. Poglavlje 2.11, Varijacije: spoljna skladišta, TLS i ingress, obrađuje svaki režim.

Ništa drugo nije izloženo. Skladišta podataka, OpenBao i svi interni servisi osluškuju samo unutar namespace-a.

Tri horizontalne trake. Gornja traka je „Edge“ sa tri Ingress polja označena kao console, api i auth, od kojih svako pokazuje nadole ka svom Service-u (nexus-alpha :3000, nexus-gateway :9092, nexus-auth :9101). Srednja traka je „Servisi platforme“: polje za nexus-alpha-bff; nexus-orchestrator pored nexus-workflows, grupisani i označeni kao UNO; zatim nexus-graphrag, nexus-probitas, nexus-skills-engine, nexus-keys; i dva isprekidana polja za opcione nexus-plugins i nexus-fileprocess. Donja traka je „Sloj podataka“ sa po jednim poljem za svako skladište (PostgreSQL, Valkey, Neo4j, Qdrant, SeaweedFS), i zasebnim ograđenim poljem označenim kao „Skladište ključeva“ koje sadrži openbao i openbao-unsealer, do kojeg dopire samo nexus-keys.
Komponente Nexus instalacije i skladišta ispod njih.

Zahtev, od početka do kraja

Evo šta se dešava kada Aoife Brennan, rukovodilac IT-a u Harrow, otvori konzolu i postavi asistentu pitanje o rasporedu vezova za ovaj mesec.

  1. Njen pregledač učitava https://console.harrow.example. Ingress nexus-console prosleđuje zahtev ka nexus-alpha na portu 3000.
  2. Ona se prijavljuje svojim passkey ključem. Stranice za prijavu komuniciraju sa nexus-auth preko auth.harrow.example, a nexus-auth joj izdaje pristupni token koji nosi njenog korisnika, njenu organizaciju i, kada je njena sesija ima, njenu poslovnu jedinicu.
  3. Server konzole poziva BFF, koji proverava njen token i pita nexus-auth da li njena organizacija poseduje proizvod i da li je njena uloga dozvoljena. Odgovara grupama menija koje ona sme da vidi.
  4. Njeno pitanje ide od BFF-a do rute za otpremanje orchestratora, pri čemu se njena organizacija i korisnik preuzimaju iz verifikovanog tokena. Orchestrator odgovara sa 202 i stavlja posao u red čekanja u Valkey.
  5. Radni proces workflows preuzima posao. Veštinu koju izvršava razrešava mehanizam veština, a pretraživanje Harrow dokumenata ide ka GraphRAG, koji čita Neo4j, Qdrant i svoju PostgreSQL šemu.
  6. Poziv modela ide ka AI Provider Router na /internal/ai/chat. Ruter bira provajdera i model iz sopstvenog skupa ključeva i politike rutiranja organizacije Harrow, izvršava poziv sa ključem organizacije Harrow i vraća odgovor modela.
  7. Rezultat se upisuje u red izvršavanja posla. BFF ga čita, a konzola prikazuje odgovor, sa njegovim citatima.

Skokovi između servisa nose projektovane servisne tokene, oni ka nexus-auth, nexus-keys i Probitas idu preko TLS-a od sopstvenog sertifikacionog tela instalacije, a svaki pristup podacima u koracima od 4 do 6 ograničen je na organizaciju Harrow u samoj bazi podataka. Odeljci u nastavku objašnjavaju oba mehanizma.

Niz sleva nadesno. Polje pregledača šalje „1 stranica“ ka Ingress console, zatim ka nexus-alpha. Bočna strelica „2 prijava“ ide od pregledača kroz Ingress auth do nexus-auth. nexus-alpha šalje „3 meni“ ka nexus-alpha-bff, koji proverava sa nexus-auth. nexus-alpha-bff šalje „4 prosleđivanje, 202“ ka nexus-orchestrator, koji upisuje u ikonu Valkey reda. nexus-workflows preuzima „5 posao“ iz reda i poziva nexus-skills-engine i nexus-graphrag (njegova tri skladišta nacrtana su ispod GraphRAG-a). nexus-workflows šalje „6 čet“ ka nexus-gateway, označenom kao „AI Provider Router: skup ključeva organizacije“, koji šalje jednu strelicu van granice klastera ka „provajder modela“. Isprekidana povratna strelica „7 rezultat u redu izvršavanja“ vraća se ka nexus-alpha-bff.
Jedno pitanje asistentu, od pregledača do provajdera modela i nazad.

Sloj podataka

Nexus isporučuje sopstvenu potpisanu kopiju svakog skladišta, uz ponudu izvornog koda za svako od njih u paketu. Svako je izabrano koliko zbog licence, toliko i zbog funkcije.

Skladište Verzija Licenca Zašto je tu Port Podrazumevani volumen
PostgreSQL sa PostGIS i pgvector PostgreSQL 16, PostGIS 3, pgvector 0.8 PostgreSQL licenca; PostGIS GPL-2.0-or-later Sistem evidencije za svaki servis; PostGIS za kartografske podatke; pgvector za vektore koji se čuvaju uz redove 5432 50 GiB
Valkey 8.1 BSD-3-Clause UNO redovi poslova i kratkotrajni keševi, kao što je keš API ključeva servisa nexus-auth 6379 5 GiB
Neo4j Community Edition 5.26 GPL-3.0 Graf znanja koji GraphRAG gradi i kojim se kreće 7687 (Bolt) 20 GiB
Qdrant 1.15 Apache-2.0 Vektorska pretraga za GraphRAG i mehanizam veština 6333 (HTTP), 6334 (gRPC udaljeni pozivi procedura) 10 GiB
SeaweedFS 4.48 Apache-2.0 Objektno skladište za datoteke, kompatibilno sa Amazon Simple Storage Service (S3) 8333 50 GiB
OpenBao 2.6 MPL-2.0 Skladište ključeva i njegov unsealer, za nexus-keys 8200 5 GiB i 1 GiB

Neki izbori zamenili su nešto poznatije. Valkey zamenjuje Redis 7.4, čije trenutne licence izdanje odbija. MinIO je pod licencom AGPL-3.0, pa je objektno skladište SeaweedFS. GraphRAG pristupa Neo4j Community Edition preko Bolt, mrežnog protokola, a servisi pristupaju PostGIS preko PostgreSQL protokola, tako da GPL ostaje vezan za svaki od njih. OpenBao je fork Vault-a koji održava Linux Foundation, iz perioda pre promene licence Vault-a.

Svako skladište radi sa uključenom autentifikacijom i generisanim akreditivima: lozinkom za Valkey, API ključem za Qdrant, pristupnim ključevima za SeaweedFS.

Svako od pet skladišta pod dataTier radi u klasteru (mode: in-cluster, podrazumevano) ili je skladište kojim već upravljate (mode: external, uz external.host i Secret naveden u external.existingSecret). Za spoljni PostgreSQL podesite sslmode na verify-full ili verify-ca i stavite sertifikat sertifikacionog tela (CA) servera u taj Secret; poglavlje 2.11, Varijacije: spoljna skladišta, TLS i ingress, sadrži detalje.

# 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-postgres

Par OpenBao je izuzetak: uvek radi unutar instalacije, jer ga Job za čuvanje tamo inicijalizuje.

Identitet između servisa

Nexus radi bez service mesh-a. Uzajamni TLS potiče od lokalnog sertifikacionog tela (CA) koje chart kreira putem cert-manager, koji mora biti prethodno instaliran (testirana je verzija v1.21.3).

Samopotpisani Issuer pravi jedan CA sertifikat, nexus-local-ca, ECDSA (Elliptic Curve Digital Signature Algorithm) P-256, koji važi deset godina. Drugi Issuer potpisuje tim CA. Svako opterećenje koje poziva TLS server unutar instalacije dobija sopstveni klijentski sertifikat, pod imenom <service-account>-client-tls, koji važi 90 dana i obnavlja se 15 dana pre isteka. Njegovo jedino ime je jedinstveni identifikator resursa (URI) u obliku SPIFFE identiteta:

spiffe://cluster.local/ns/<namespace>/sa/<service-account>

Svako opterećenje pronalazi javni sertifikat CA kao ca.crt u sopstvenom Secret objektu sertifikata. Nijedan pod ne montira ključ CA, a trust-manager Vam nije potreban.

Tri servisa proveravaju pozivaoce putem sertifikata. nexus-auth to čini na svom drugom listeneru, port 8443, i svaki pozivalac unutar klastera se povezuje upravo na njega. nexus-keys to čini na svom jedinom listeneru. Probitas pruža TLS sa sopstvenim sertifikatom, nexus-probitas-tls, koji ponovo učitava kada ga cert-manager obnovi. Nijedan ne veruje zaglavlju X-Forwarded-Client-Cert.

Svako radno opterećenje takođe dobija Kubernetes tokene sa trajanjem od jednog sata na /var/run/secrets/nexus, po jedan za svaki servis koji poziva, sa tim servisom kao publikom (audience). ConfigMap nexus-service-identities mapira svaki <namespace>/<service-account> na ime servisa ili plugina, a radno opterećenje koje u njemu nedostaje nema identitet i biva odbijeno. Orchestrator i Probitas proveravaju ove tokene pomoću Kubernetes API-ja. Od pokrenutih servisa, samo ta dva imaju system:auth-delegator ili montiran API token; jedino drugo radno opterećenje sa tokenom je custody Job koji se pokreće pri instalaciji.

Mrežna politika zatvara ono što identitet ne zatvara. Chart polazi od podrazumevane zabrane (default deny), a zatim dozvoljava saobraćaj između sopstvenih podova instalacije, DNS (Domain Name System), iz namespace-a ingress kontrolera (networkPolicy.ingressNamespace, podrazumevano kube-system) ka tri javna Service-a, kao i ka API serveru za dva proverivača tokena. OpenBao podovi nose drugačiju oznaku od ostatka platforme, tako da ih otvoreno pravilo unutar namespace-a ne obuhvata: prolaze samo nexus-keys, njegovi Job-ovi i custody Job, na portu 8200. Sve ostalo što radno opterećenje mora da dosegne van namespace-a, kao što je Vaš mail relay, navodi se u networkPolicy.externalEgressCIDRs, koji je podrazumevano prazan.

Migracije i registar šema

Migracije se izvršavaju kao Helm hook-ovi, na post-install i pre-upgrade. Post-install hook se izvršava nakon što su Deployment-i izdanja kreirani. Zato se pri prvoj instalaciji servisi pokreću dok njihove šeme još ne postoje, i ušli bi u petlju pada (crash-loop) nad bazom podataka bez uloge, lozinke i tabela. Nexus to izbegava pomoću evidencije (ledger).

Hook-ovi se izvršavaju redosledom težine, a Helm čeka na svaki Job pre nego što započne sledeća težina:

Težina Hook Šta radi
-30 nexus-migrations-env i preduslovi Kreira Secret namenjen samo hook-ovima sa kredencijalima migratora, kao i sve što custody Job čita
-20 nexus-db-bootstrap Kreira baze podataka nexus i nexus_alpha, ulogu migratora, runtime ulogu svakog servisa, ekstenzije i evidenciju
-15 nexus-openbao-custody-init Inicijalizuje skladište ključeva i unsealer i izdaje identitet instalacije
-12 nexus-graphrag-migrations Šema GraphRAG-a, koja poseduje objekte na koje se poziva osnovna šema nexus-auth-a
-10 nexus-auth-migrations Šema identiteta
-5 Migracije za orchestrator, gateway i Probitas Njihove šeme; Probitas najpre proverava da li auth tabele postoje
0 nexus-alpha-bff-migrations Sopstvena baza podataka konzole

Svaki Job za migraciju ima backoffLimit: 0, tako da neuspela migracija obara instalaciju.

Evidencija je jedna tabela, nexus_release.schema_applied, sa po jednim redom za svaki lanac i digest image-a. Svaki hook upisuje svoj red tek nakon što se njegov izvršilac migracija završi. Svaki Deployment koji koristi PostgreSQL ima init kontejner, wait-for-schema, koji čita tu tabelu kao uloga kojoj nije dozvoljeno da čita ništa drugo (nexus_ledger_reader) i čeka dok svaki lanac od kojeg zavisi ne pokaže red za image ovog izdanja. Tada se servis pokreće. Workflows worker čeka na lanac orchestratora, pošto deli tu bazu podataka, a skills engine čeka samo na bootstrap.

Proverava na svake 3 sekunde (schemaWait.intervalSeconds) i odustaje nakon 1.800 (schemaWait.timeoutSeconds) uz poruku koja navodi lance koji još nedostaju. Sopstveni kontejner servisa se nikada ne pokreće nad pogrešnom šemom.

kubectl -n nexus logs deploy/nexus-gateway -c wait-for-schema

Zato nikada ne smete pokrenuti helm install --wait. Sa --wait, Helm čeka na Deployment-e pre nego što izvrši post-install hook-ove, a Deployment-i čekaju na hook-ove. Ni jedno se ne pomera. Instalirajte bez toga i sačekajte nakon toga; poglavlje 2.6, Instaliranje Community izdanja na Kubernetes, navodi tačnu komandu.

Izolacija po tri ose

Svako čitanje, upis, poziv alata i prosleđivanje veštine u Nexus-u ograničeno je po tri ose.

Osa Polje Šta razdvaja
Tenant organization_id Jednu organizaciju od druge, čvrsta granica
Vlasnik owner_user_id Stvari jedne osobe od stvari svih ostalih, čak i unutar jedne organizacije
Jedinica business_unit_id Podela organizacije, opciono

Osa vlasnika iznenađuje ljude. Poštansko sanduče ili lična beležnica privatni su za svog vlasnika čak i u odnosu na kolege u istoj jedinici sa istom ulogom. Administrator postavlja politike i ne čita sadržaj.

Ose potiču iz autentifikovanog zahteva i ni iz čega drugog. Nijedna promenljiva okruženja, zaglavlje, parametar upita ili segment putanje ne može da ih postavi. Telo zahteva koje navodi organizaciju odbija se sa TENANT_NOT_A_PARAMETER. Površina koja ne može da utvrdi kojem tenantu, vlasniku i jedinici red pripada odbija sa 403 SCOPE_PREDICATE_MISSING, a telo odgovora navodi koje su ose razrešene, a koje nisu. Nikada ne prelazi na šire čitanje.

To važi na dva mesta istovremeno.

U bazi podataka. Svaki servis se povezuje kao sopstvene runtime uloge: nexus_auth, auth_app i auth_platform za servis identiteta, nexus_probitas i nexus_probitas_ledger za Probitas, i nexus_gateway, nexus_graphrag, nexus_skills, orchestrator_app, workflows_app i ostale za druge. Nijedna nije superuser niti ima BYPASSRLS. Nijedna takođe ne poseduje tabele koje koristi, tako da se na nju primenjuje svaka politika bezbednosti na nivou reda (RLS). Uloge dele grupu, nexus_runtime, koja dodeljuje pravo povezivanja i korišćenja šeme, a nikakva prava nad tabelama; svakom servisu se sopstvene tabele dodeljuju njegovim sopstvenim migracijama. Podešavanja tenanta koja RLS politike čitaju mogu se postaviti samo putem funkcije bind_scope svakog servisa, koja se izvršava kao njen vlasnik. Bootstrap opoziva set_config od svih ostalih, a orchestrator i Probitas odbijaju da se pokrenu ako bi njihova runtime uloga mogla da je pozove direktno (Probitas to naziva DB_ROLE_SETS_SCOPE_DIRECTLY). Jedine superuser konekcije u celoj instalaciji pripadaju bootstrap Job-u i koraku dodeljivanja resursa u BFF-u.

U zajedničkoj primitivi za ograničene upite. Svaki repozitorijum na platformi i svaki plugin izgrađen na SDK-u (software development kit) nasleđuje jednu ogradu koja gradi SQL predikat iz razrešenog opsega. Njena funkcija opsega prima provereni identitet i nema parametar organizacije, tako da pozivalac ne može da ga prosledi, a nijedna ruta ne može da se izuzme.

Postoji tačno jedan prelaz granice tenanta, i on je uzak: evidentirano odobrenje. Dve osobe u organizaciji koja drži redove evidentiraju koja organizacija sme da čita koje tabele i do kada. Svako čitanje izvršava se u transakciji samo za čitanje i beleži se kod oba tenanta. Vlasnici i administratori nikada ne čitaju preko granice, a čitalac ne može da proširi odobrenje.

AI putanja

Pozivaoci izražavaju želje. AI Provider Router poseduje kredencijal i donosi konačan izbor.

Svaki poziv modela u Nexus-u prolazi kroz rute /internal/ai/* rutera, a ruter prihvata samo imenovane pozivaoce. Chart postavlja tri liste na gateway-u:

Rute Ko sme da poziva
Čet i strimovanje četa nexus-orchestrator, nexus-workflows, nexus-skills-engine
Embeddings i rerank nexus-graphrag, nexus-skills-engine, nexus-workflows
Sve ostalo, uključujući izvršavanje alata nexus-orchestrator, nexus-workflows

Poziv bez identiteta pozivaoca odbija se sa 403 MISSING_CALLER_IDENTITY, a pozivalac koji nije na listi sa 403 UNAUTHORIZED_CALLER. Plugini nisu ni na jednoj listi, i to je namerno: pozivi modela za plugin odvijaju se u njegovo ime, putem UNO prosleđivanja.

Ono što pozivalac sme da pošalje je želja: željeni provajder i model, plus profil mogućnosti, kao što je minimalna dužina konteksta ili korišćenje alata. Ruter uvažava želju samo kada organizacija ima taj provajder omogućen i snabdeven kredencijalima; u suprotnom ga zamenjuje, najpre unutar istog provajdera, zatim među ostalim provajderima organizacije. Profil mogućnosti samo filtrira, a zahtev za rezidentnost podataka u njemu je obavezujući. Kada ništa ne odgovara, ne postoji rezervni model: pozivalac dobija 422 MODEL_CAPABILITY_UNAVAILABLE ili 422 NO_PROVIDER_FOR_ROLE, sa tekstom o otklanjanju problema koji konzola prikazuje administratoru.

Ključevi pripadaju organizaciji. Administratori svake organizacije unose sopstvene ključeve provajdera u njen skup iz konzole, a ruter ih razrešava u trenutku poziva. Nijedan ključ modela nije vrednost chart-a i nijedan se ne isporučuje sa Nexus-om. Organizacija bez ključa ne dobija AI odgovore, i konzola to jasno navodi; ništa ne popunjava prazninu iz nekog drugog izvora.

Dve vrednosti chart-a oblikuju ruter. ai.localProvider.baseUrl imenuje server modela kompatibilan sa OpenAI-jem koji Vi pokrećete, rutiran kao bilo koji drugi provajder. ai.installationHosts navodi Vaše servere modela pod privatnim imenima, koje ruter smatra delom instalacije. GraphRAG takođe kreira embeddings preko rutera, kao organizacija čiji je to sadržaj. Podrazumevani model za embeddings radi u klasteru bez grafičke kartice; hostovani embeddings su izbor svake organizacije.

Bez telemetrije

Ništa ne napušta instalaciju ukoliko to Vi ne pošaljete. Vrednost telemetry.enabled chart-a može biti samo false; šema odbija sve ostalo. Sopstveno izveštavanje sloja podataka takođe je isključeno: Neo4j-ov izveštaj o korišćenju i Qdrant-ova telemetrija onemogućeni su u chart-u.

Kada je networkPolicy.enabled uključen, što je podrazumevano, nijedan pod ne može da dosegne internet ukoliko ne navedete odredište u networkPolicy.externalEgressCIDRs. Hostovani provajder modela je jedno takvo odredište, kao i Vaš mail relay.

Isto pravilo promenilo je jedno podrazumevano podešavanje koje ćete primetiti. CAPTCHA nexus-auth-a za registraciju zahteva internet servis, pa je na instalaciji isključena, a registracija nepoznate osobe čeka odobrenje administratora (403 SIGNUP_REQUIRES_APPROVAL). Provera koja blokira registracije sa hosting mreža takođe je isključena, jer zahteva licencirane baze podataka koje Nexus ne isporučuje. Tu proveru gubite.

Stanje instalacije
Stanje instalacije
Na Enterprise izdanju, stranica stanja prikazuje klaster ispod Nexus-a: koliko je opterećen svaki deo i koliko je kapaciteta preostalo, sa svakim upozorenjem pored onoga što treba preduzeti.