PrijavaRezervirajte prezentaciju

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

19 min čitanja

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).

Ova instalacija (Community)
Ova instalacija (Community)
Vlastita stranica instalacije izdanja Community prikazuje njezinu verziju i stanje pogona. Jasno navodi da licencija nije potrebna. Dijelovi stranice za izdanje Enterprise prikazani su kao najave.

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.

Tri vodoravne trake. Gornja traka je „Edge” s tri Ingress okvira označena kao console, api i auth, od kojih svaki pokazuje prema dolje na svoj Service (nexus-alpha :3000, nexus-gateway :9092, nexus-auth :9101). Srednja traka je „Platform services”: okvir za nexus-alpha-bff; nexus-orchestrator pored nexus-workflows, grupirani i označeni kao UNO; zatim nexus-graphrag, nexus-probitas, nexus-skills-engine, nexus-keys; te dva isprekidana okvira za opcijske nexus-plugins i nexus-fileprocess. Donja traka je „Data tier” s jednim okvirom po spremištu (PostgreSQL, Valkey, Neo4j, Qdrant, SeaweedFS) te zasebnim ograđenim okvirom označenim kao „Key store” koji sadrži openbao i openbao-unsealer, a kojem pristupa samo nexus-keys.
Komponente instalacije sustava Nexus i spremišta ispod njih.

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.

  1. Njezin preglednik učitava https://console.harrow.example. Resurs Ingress nexus-console šalje zahtjev na nexus-alpha na priključku 3000.
  2. Prijavljuje se svojim pristupnim ključem. Stranice za prijavu komuniciraju s nexus-auth putem auth.harrow.example, a nexus-auth joj izdaje pristupni token koji nosi njezina korisnika, njezinu organizaciju i, kada ga njezina sesija ima, njezinu poslovnu jedinicu.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. 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.

Slijed slijeva nadesno. Okvir preglednika šalje „1 page” na Ingress console, a zatim na nexus-alpha. Bočna strelica „2 sign-in” ide iz preglednika kroz Ingress auth do nexus-auth. nexus-alpha šalje „3 menu” na nexus-alpha-bff, koji vrši provjeru s nexus-auth. nexus-alpha-bff šalje „4 dispatch, 202” na nexus-orchestrator, koji zapisuje u ikonu Valkey reda čekanja. nexus-workflows povlači „5 job” iz reda čekanja i poziva nexus-skills-engine i nexus-graphrag (njegova tri spremišta nacrtana su ispod GraphRAG-a). nexus-workflows šalje „6 chat” na nexus-gateway, označen kao „AI Provider Router: organisation key pool”, koji šalje jednu strelicu izvan granice klastera prema „model provider”. Isprekidana povratna strelica „7 result on run row” vraća se natrag na nexus-alpha-bff.
Jedno pitanje asistentu, od preglednika do pružatelja modela i natrag.

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

Par 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-schema

Zbog 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.

Stanje instalacije
Stanje instalacije
Na Enterprise izdanju, stranica stanja sustava prikazuje klaster pod Nexusom: koliko je pojedini dio opterećen i koliko je kapaciteta preostalo, uz svako upozorenje pored upute što poduzeti u vezi s tim.