PrijavaRezervirajte predstavitev

Poglavje 2.1

Arhitektura

Kaj ima v lasti posamezna storitev v karti Nexus in katere shrambe so pod njo, nato pa pravila, ki jih povezujejo, od identitete med storitvami do poti, ki jo opravi vsak klic modela.

To stran je iz angleškega izvirnika prevedla UI. Če je karkoli nejasno, je referenca angleška stran. Preberite to stran v angleščini

19 min branja

Ko je Tomás Reilly zaključil prvo namestitev pri Harrow Port Authority, je kubectl -n nexus get pods prikazal deset objektov Deployment in sedem objektov StatefulSet ter tri objekte CronJob. Migracijski objekti Job, ki so zgradili podatkovno bazo, so že izginili, saj se vsak po uspešni izvedbi sam izbriše. Ta izpis predstavlja celotno platformo. Naučite se ga, saj se večina vprašanj pri nadaljnjem upravljanju začne s »kateri od teh je lastnik tistega?«

To poglavje ponuja odgovor za vsak posamezen del, sledi eni zahtevi skoznje in nato obravnava pravila, ki jih vsi upoštevajo. Preostanek 2. dela gradi na tej sliki.

Storitve in kaj ima vsaka v lasti

Paket je en sam paket Helm, nexus, različica 1.0.0-alpha.1, za Kubernetes 1.33 ali novejši. Vsaka delovna obremenitev teče pod lastnim računom ServiceAccount, kot nekorenski uporabnik, z vsemi odstranjenimi zmogljivostmi Linuxa. Klici v storitve, ki varujejo identiteto in ključe, potekajo prek obojestranskega TLS (Transport Layer Security), javni API (aplikacijski programski vmesnik) pa si deli proces z usmerjevalnikom UI (umetne inteligence).

Komponenta Deployment in Service Vrata storitve Česa je lastnik
Konzola nexus-alpha 3000 Strani, ki jih ljudje vidijo; streže HTML (Hypertext Markup Language) na gostitelju konzole
BFF (zaledje za začelje) nexus-alpha-bff 8080 Lastni podatki konzole, meni, ki ga dobi vsaka oseba, register izdaj
Auth nexus-auth 9101 (obojestranski TLS na 8443) Ljudje, organizacije, seje, žetoni, ključi API, nabor ključev modelov organizacije
Prehod nexus-gateway 9092, WebSocket 8093 Usmerjevalnik ponudnikov UI (AI Provider Router) in rob javnega API-ja za REST (prenos reprezentacijskega stanja) ter MCP (Model Context Protocol)
Orkestrator nexus-orchestrator 8080 Razpošiljanje UNO: sprejemanje vsakega opravila in uvrščanje v čakalno vrsto
Poteki dela nexus-workflows 8081 Izvajanje UNO: delavec, ki izvaja opravila iz čakalne vrste
GraphRAG nexus-graphrag 8090, WebSocket 8091 Spomin: graf znanja in pridobivanje podatkov iz njega
Probitas nexus-probitas 9151 (HTTPS) Dokazi: zapisi upravljanja in zapečatena glavna knjiga
Pogon veščin nexus-skills-engine 8095 Knjižnica veščin; iskanje in izvajanje veščin
Ključi nexus-keys 8080 (HTTPS, obojestranski TLS) Ključi posameznih organizacij v OpenBao, hramba, identiteta namestitve
Vtičniki nexus-plugins 9111 Register vtičnikov in kataloški zapisi; privzeto izklopljeno
Obdelava datotek nexus-fileprocess 9109 Branje naloženih dokumentov in slik; privzeto izklopljeno

Prvih deset je obveznih. Zadnja dva sta izbirna ter se vklopita z components.plugins.enabled in components.fileprocess.enabled, kjer ju uporablja namestitev Enterprise ali domenski paket. Še ena izbirna storitev, nexus-alive na vratih 8080, ima lastno stikalo, components.alive.enabled, in je prav tako privzeto izklopljena. Replike in viri za vsako se nahajajo pod components.<name>.

Konzola obsega strežniško upodobljene strani brez podatkovne baze. Komunicira z BFF in s storitvijo nexus-auth znotraj gruče, nikoli pa navzven prek javnega gostitelja za avtentikacijo in nazaj noter. Brez svoje izdaje, ki jo paket posreduje kot NEXUS_EDITION iz ene same vrednosti edition, se noče zagnati. Vsak član organizacije v njej dela v skladu s svojo vlogo. Skrbniške strani so namenjene lastnikom in skrbnikom, član, ki odpre katero od njih, pa dobi stran »Niste skrbnik«.

BFF je strežniška polovica konzole in je zgrajen kot vtičnik platforme, registriran kot produkt Nexus Alpha. Lastne tabele konzole hrani v ločeni podatkovni bazi, nexus_alpha, in odloča, katere skupine menijev posamezna oseba vidi. Ko konzola potrebuje izvedbo dela, BFF zaprosi storitev, ki je lastnica tega dela.

nexus-auth je napisan v jeziku Go in je edina storitev, ki izdaja žetone. Žetoni za dostop privzeto veljajo 15 minut, žetoni za osvežitev pa 12 ur (auth.accessTokenTTL, auth.refreshTokenTTL). Vsako prijavljeno osebo omeji na 5.000 zahtev na minuto, preden odgovori s 429 (auth.rateLimitPerMinute). Izvaja dva poslušalnika: navadnega na vratih vsebnika 8080, ki ga doseže javni Ingress, in poslušalnika z obojestranskim TLS na 8443, ki ga mora uporabiti vsak klicatelj znotraj gruče. Vrednosti X-Forwarded-For verjame samo iz skokov v proxy.trustedCIDRs, seznamu razponov brezrazrednega meddomenskega usmerjanja (CIDR), ki je privzeto nastavljen na 10.42.0.0/16, omrežje podov k3s. Če se vaš krmilnik vstopnih točk (ingress controller) izvaja drugje, to spremenite. Sicer bo vsaka prijava videti, kot da prihaja iz krmilnika.

Prehod ima dve nalogi, ki si delita en proces. Znotraj gruče je usmerjevalnik ponudnikov UI (stikalna plošča UI v 1. delu in na straneh konzole), edini imetnik poverilnic za modele organizacije (več o tem spodaj). Na robu je tisto, kar doseže api.<domain>: odjemalci REST in odjemalci MCP, katerih žetoni nosijo ciljno skupino https://<hosts.api>/mcp in prihajajo iz avtorizacijskega strežnika OAuth 2.1 na gostitelju za avtentikacijo (OAuth je odprti standard za delegirano avtorizacijo).

Orkestrator in poteki dela skupaj tvorijo UNO, pogon za poteke dela. Vsa računska obdelava teče prek njiju. Orkestrator sprejme opravilo na POST /api/v1/dispatch, odgovori z 202 z jobId, runId in traceId ter ga uvrsti v čakalno vrsto. Neposredne poti izvajanja ni: odjemalec vedno preverja stanje na GET /api/v1/dispatch/{jobId} ali sprejme povratni klic. Delavec za poteke dela jemlje opravila iz čakalne vrste, privzeto po štiri hkrati na repliko (workflows.concurrency), in ima natanko eno pot HTTP, GET /health.

Probitas je storitev za dokaze. Sama streže TLS iz potrdila, ki ga izda paket, in hrani svoje tabele v shemi trust z ločeno vlogo za glavno knjigo. Njene funkcije upravljanja se preklapljajo z probitas.flags. Več jih je dobavljenih v načinu shadow: odločitev se izračuna in zabeleži, vendar se nič ne blokira, dokler ne spremenite zastavice.

nexus-keys je storitev za ključe platforme, napisana v jeziku Go. V shrambi ključev OpenBao hrani po en ključ za vsako organizacijo in jih vsako noč rotira. Njena nočna opravila prav tako uničijo ključe, katerih datum hrambe je potekel, in izvozijo potrdila na lasten nosilec podatkov. Izbris ključa organizacije povzroči, da so podatki, zaklenjeni z njim, za vedno neberljivi. Prav tako ustvari identiteto namestitve ob prvem začetnem zagonu pod keys.installationName, in to ime je trajno. Izberite ga skrbno: paket zavrne prazno ime (INSTALLATION_NAME_MISSING) in zavrne ime iz lastnih primerov vrednosti (INSTALLATION_NAME_EXAMPLE).

Ta namestitev (Community)
Ta namestitev (Community)
Lastna stran namestitve Community prikazuje njeno različico in stanje pogona. Jasno navaja, da licenca ni potrebna. Deli strani za različico Enterprise so izrisani kot dražilniki.

Trije javni gostitelji

Paket objavi natanko tri imena gostiteljev, ki skupaj predstavljajo identiteto namestitve. Brez njih se nobena storitev noče zagnati.

Ingress Vrednost gostitelja Zaledje
nexus-console hosts.console nexus-alpha, vrata 3000
nexus-api hosts.api nexus-gateway, vrata 9092
nexus-auth hosts.auth nexus-auth, vrata 9101

Primeri v tej knjigi uporabljajo console.harrow.example, api.harrow.example in auth.harrow.example. Objekti Ingress so navadni objekti networking.k8s.io/v1 s po enim pravilom in potjo /. TLS na robu sledi tls.mode: existing (Secret, ki ste ga ustvarili, imenovan v tls.existingSecret), cert-manager (ClusterIssuer, ki ga izvajate, imenovan v tls.clusterIssuer) ali none (TLS se zaključi pred gručo). Paket ne dodaja lastnih preusmeritev, zato izziv HTTP protokola ACME (Automated Certificate Management Environment) doseže vaš razreševalnik nespremenjen. Poglavje 2.11, Različice: zunanje shrambe, TLS in ingress, obravnava vsak način.

Nič drugega ni izpostavljeno. Podatkovne shrambe, OpenBao in vsaka notranja storitev poslušajo samo znotraj imenskega prostora.

Trije vodoravni pasovi. Zgornji pas je »Edge« s tremi okviri Ingress z oznakami console, api in auth, pri čemer vsak kaže navzdol na svojo storitev Service (nexus-alpha :3000, nexus-gateway :9092, nexus-auth :9101). Srednji pas je »Platform services«: okvir za nexus-alpha-bff; nexus-orchestrator poleg nexus-workflows, združena in označena kot UNO; nato nexus-graphrag, nexus-probitas, nexus-skills-engine, nexus-keys; ter dva črtkana okvira za izbirna nexus-plugins in nexus-fileprocess. Spodnji pas je »Data tier« z enim okvirom za vsako shrambo (PostgreSQL, Valkey, Neo4j, Qdrant, SeaweedFS) in ločenim ograjenim okvirom z oznako »Key store«, ki vsebuje openbao in openbao-unsealer ter je dosegljiv samo za nexus-keys.
Komponente namestitve Nexus in shrambe pod njimi.

Zahteva, od začetka do konca

Tukaj je opisano, kaj se zgodi, ko Aoife Brennan, vodja IT pri družbi Harrow, odpre konzolo in pomočniku zastavi vprašanje o urniku privezov za ta mesec.

  1. Njen brskalnik naloži https://console.harrow.example. Ingress nexus-console to pošlje na nexus-alpha na vratih 3000.
  2. Prijavi se s svojim potrdilnim ključem. Prijavne strani komunicirajo z nexus-auth prek auth.harrow.example, nexus-auth pa ji izda žeton za dostop, ki vsebuje njenega uporabnika, njeno organizacijo in, kadar jo njena seja ima, njeno poslovno enoto.
  3. Strežnik konzole pokliče BFF, ki preveri njen žeton in vpraša nexus-auth, ali ima njena organizacija ta produkt in ali je njena vloga dovoljena. Odgovori s skupinami menijev, ki jih sme videti.
  4. Njeno vprašanje potuje od BFF do poti za razpošiljanje orkestratorja, pri čemer se njena organizacija in uporabnik vzameta iz preverjenega žetona. Orkestrator odgovori z 202 in uvrsti opravilo v čakalno vrsto v shrambi Valkey.
  5. Delavec za poteke dela prevzame opravilo. Veščino, ki jo izvaja, razreši pogon veščin, pridobivanje podatkov iz dokumentov družbe Harrow pa gre v GraphRAG, ki bere Neo4j, Qdrant in svojo shemo PostgreSQL.
  6. Klic modela gre v usmerjevalnik ponudnikov UI na /internal/ai/chat. Usmerjevalnik izbere ponudnika in model iz lastnega nabora ključev in politike usmerjanja družbe Harrow, opravi klic s ključem družbe Harrow in vrne dopolnitev.
  7. Rezultat pristane v vrstici izvajanja opravila. BFF ga prebere, konzola pa izriše odgovor skupaj z navedbami virov.

Skoki med storitvami prenašajo projicirane žetone storitev, tisti v nexus-auth, nexus-keys in Probitas potekajo prek TLS iz lastne overiteljske agencije namestitve, vsak dostop do podatkov v korakih od 4 do 6 pa je omejen na organizacijo Harrow v sami podatkovni bazi. Spodnja razdelka pojasnjujeta oboje.

Zaporedje od leve proti desni. Okvir brskalnika pošlje »1 page« v Ingress console, nato v nexus-alpha. Stranska puščica »2 sign-in« vodi iz brskalnika prek Ingress auth do nexus-auth. nexus-alpha pošlje »3 menu« v nexus-alpha-bff, ki preveri pri nexus-auth. nexus-alpha-bff pošlje »4 dispatch, 202« v nexus-orchestrator, ki zapiše v ikono čakalne vrste Valkey. nexus-workflows povleče »5 job« iz čakalne vrste ter pokliče nexus-skills-engine in nexus-graphrag (njegove tri shrambe so narisane pod GraphRAG). nexus-workflows pošlje »6 chat« v nexus-gateway z oznako »AI Provider Router: organisation key pool«, ki pošlje eno samo puščico izven meje gruče do »model provider«. Pikčasta povratna puščica »7 result on run row« vodi nazaj v nexus-alpha-bff.
Eno vprašanje za pomočnika, od brskalnika do ponudnika modela in nazaj.

Podatkovna raven

Nexus v svežnju dobavlja lastno podpisano kopijo vsake shrambe skupaj s ponudbo izvorne kode za vsako. Vsaka je bila izbrana tako zaradi svoje licence kot zaradi svoje funkcije.

Shramba Različica Licenca Zakaj je tam Vrata Privzeti nosilec podatkov
PostgreSQL s PostGIS in pgvector PostgreSQL 16, PostGIS 3, pgvector 0.8 Licenca PostgreSQL; PostGIS GPL-2.0-or-later Sistem zapisov za vsako storitev; PostGIS za kartografske podatke; pgvector za vektorje, hranjene ob vrsticah 5432 50 GiB
Valkey 8.1 BSD-3-Clause Čakalne vrste opravil UNO in kratkotrajni predpomnilniki, kot je predpomnilnik ključev API storitve nexus-auth 6379 5 GiB
Neo4j Community Edition 5.26 GPL-3.0 Graf znanja, ki ga GraphRAG gradi in pregleduje 7687 (Bolt) 20 GiB
Qdrant 1.15 Apache-2.0 Vektorsko iskanje za GraphRAG in pogon veščin 6333 (HTTP), 6334 (oddaljeni klici procedur gRPC) 10 GiB
SeaweedFS 4.48 Apache-2.0 Objektna shramba za datoteke, združljiva z Amazon Simple Storage Service (S3) 8333 50 GiB
OpenBao 2.6 MPL-2.0 Shramba ključev in njeno orodje za odpečatenje, za nexus-keys 8200 5 GiB in 1 GiB

Nekatere izbire so nadomestile nekaj bolj znanega. Valkey nadomešča Redis 7.4, čigar trenutne licence izdaja zavrača. MinIO ima licenco AGPL-3.0, zato je objektna shramba SeaweedFS. GraphRAG doseže Neo4j Community Edition prek omrežnega protokola Bolt, storitve pa dosežejo PostGIS prek protokola PostgreSQL, tako da licenca GPL ostane pri vsakem od njiju. OpenBao je razcep projekta Vault fundacije Linux Foundation iz časa pred spremembo licence za Vault.

Vsaka shramba teče z vklopljeno avtentikacijo in ustvarjenimi poverilnicami: geslom za Valkey, ključem API za Qdrant, dostopnimi ključi za SeaweedFS.

Vsaka od petih shramb pod dataTier teče v gruči (mode: in-cluster, privzeto) ali pa je shramba, ki jo že upravljate (mode: external, s external.host in objektom Secret, poimenovanim z external.existingSecret). Za zunanji PostgreSQL nastavite sslmode na verify-full ali verify-ca in v ta Secret vstavite potrdilo overiteljske agencije (CA) strežnika; poglavje 2.11, Različice: zunanje shrambe, TLS in ingress, vsebuje podrobnosti.

# 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 izjema: vedno teče znotraj namestitve, ker ga tam inicializira opravilo Job za hrambo.

Identiteta med storitvami

Nexus teče brez mreže storitev (service mesh). Obojestranski TLS prihaja iz lokalne overiteljske agencije (CA), ki jo paket ustvari prek orodja cert-manager, ki mora biti nameščeno predhodno (preizkušena je različica v1.21.3).

Samopodpisani Issuer ustvari eno potrdilo CA, nexus-local-ca, ECDSA (Elliptic Curve Digital Signature Algorithm) P-256, veljavno deset let. Drugi Issuer podpisuje s tem CA. Vsaka delovna obremenitev, ki kliče strežnik TLS znotraj namestitve, dobi lastno odjemalsko potrdilo, imenovano <service-account>-client-tls, veljavno 90 dni in obnovljeno 15 dni pred potekom. Njegovo edino ime je enotni identifikator vira (URI) v obliki identitete SPIFFE:

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

Vsaka delovna obremenitev najde javno potrdilo CA kot ca.crt v lastnem objektu Secret s potrdilom. Noben pod ne priklopi ključa CA in ne potrebujete orodja trust-manager.

Tri storitve preverjajo klicatelje s potrdilom. nexus-auth to počne na svojem drugem poslušalniku, vratih 8443, in vsak klicatelj znotraj gruče kliče tega. nexus-keys to počne na svojem edinem poslušalniku. Probitas streže TLS iz lastnega potrdila, nexus-probitas-tls, ki ga ponovno prebere, ko ga cert-manager obnovi. Nobena ne zaupa glavi X-Forwarded-Client-Cert.

Vsaka delovna obremenitev dobi tudi enourne žetone Kubernetes na /var/run/secrets/nexus, po enega za vsako storitev, ki jo kliče, s to storitvijo kot ciljno skupino. ConfigMap nexus-service-identities preslika vsak <namespace>/<service-account> v ime storitve ali vtičnika, delovna obremenitev, ki v njem manjka, pa nima identitete in je zavrnjena. Orkestrator in Probitas preverjata te žetone z API-jem Kubernetes. Med delujočimi storitvami imata samo ti dve system:auth-delegator ali priklopljen žeton API; edina druga delovna obremenitev z žetonom je opravilo Job za hrambo, ki se izvede ob namestitvi.

Omrežna politika zapre tisto, česar identiteta ne. Paket začne s privzeto zavrnitvijo, nato pa dovoli promet med lastnimi podi namestitve, DNS (Domain Name System), imenskim prostorom krmilnika vstopnih točk (networkPolicy.ingressNamespace, privzeto kube-system) do treh javnih storitev Service in strežnikom API za oba pregledovalnika žetonov. Podi OpenBao nosijo drugačno oznako kot preostanek platforme, zato jih odprto pravilo znotraj imenskega prostora ne doseže: skozi pridejo samo nexus-keys, njegova opravila Job in opravilo Job za hrambo, na vratih 8200. Vse drugo, kar mora delovna obremenitev doseči zunaj imenskega prostora, na primer vaš poštni posrednik, gre v networkPolicy.externalEgressCIDRs, ki je privzeto prazen.

Migracije in glavna knjiga shem

Migracije se izvajajo kot kavlji Helm, na post-install in pre-upgrade. Kavelj po namestitvi (post-install) se izvede po tem, ko so bili ustvarjeni objekti Deployment izdaje. Tako se ob prvi namestitvi storitve zaženejo, ko njihove sheme še ne obstajajo, in bi se v zanki sesedanja zaganjale ob podatkovni bazi brez vloge, brez gesla in brez tabel. Nexus se temu izogne z glavno knjigo.

Kavlji se izvajajo po vrstnem redu uteži in Helm počaka na vsako opravilo Job, preden se začne naslednja utež:

Utež Kavelj Kaj naredi
-30 nexus-migrations-env in predpogoji Ustvari Secret samo za kavlje s poverilnicami migratorja in vse, kar bere opravilo Job za hrambo
-20 nexus-db-bootstrap Ustvari podatkovni bazi nexus in nexus_alpha, vlogo migratorja, izvajalno vlogo vsake storitve, razširitve in glavno knjigo
-15 nexus-openbao-custody-init Inicializira shrambo ključev in orodje za odpečatenje ter ustvari identiteto namestitve
-12 nexus-graphrag-migrations Shema za GraphRAG, ki je lastnica objektov, na katere se sklicuje osnovna linija storitve nexus-auth
-10 nexus-auth-migrations Shema identitete
-5 Migracije za orkestrator, prehod in Probitas Njihove sheme; Probitas najprej preveri, ali tabele za avtentikacijo obstajajo
0 nexus-alpha-bff-migrations Lastna podatkovna baza konzole

Vsako migracijsko opravilo Job ima backoffLimit: 0, zato neuspela migracija prekine namestitev.

Glavna knjiga je ena sama tabela, nexus_release.schema_applied, z vrstico za vsako verigo in izvleček slike. Vsak kavelj zapiše svojo vrstico šele po tem, ko se njegov izvajalnik migracij zaključi. Vsak Deployment, ki uporablja PostgreSQL, vsebuje inicializacijski vsebnik, wait-for-schema, ki bere to tabelo kot vloga, ki ne sme brati ničesar drugega (nexus_ledger_reader), in čaka, dokler vsaka veriga, od katere je odvisen, ne prikaže vrstice za sliko te izdaje. Nato se storitev zažene. Delavec za poteke dela čaka na verigo orkestratorja, saj si deli to podatkovno bazo, pogon veščin pa čaka samo na začetni zagon.

Stanje preverja vsake 3 sekunde (schemaWait.intervalSeconds) in obupa po 1.800 (schemaWait.timeoutSeconds) z vrstico, ki imenuje še vedno manjkajoče verige. Lastni vsebnik storitve se nikoli ne zažene ob napačni shemi.

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

Zato nikoli ne smete zagnati helm install --wait. Z --wait Helm čaka na objekte Deployment, preden izvede kavlje po namestitvi, objekti Deployment pa čakajo na kavlje. Nič se ne premakne. Namestite brez tega in počakajte zatem; poglavje 2.6, Nameščanje izdaje Community v okolju Kubernetes, podaja točen ukaz.

Izolacija na treh oseh

Vsako branje, pisanje, klic orodja in razpošiljanje veščine v sistemu Nexus je zamejeno na treh oseh.

Os Polje Kaj ločuje
Najemnik organization_id Eno organizacijo od druge, stroga meja
Lastnik owner_user_id Stvari ene osebe od stvari vseh drugih, tudi znotraj ene organizacije
Enota business_unit_id Podrazdelek organizacije, izbirno

Os lastnika ljudi preseneti. Poštni predal ali osebni zvezek je zaseben za svojega lastnika celo pred sodelavci v isti enoti z isto vlogo. Skrbnik določa politiko in ne bere vsebine.

Osi izvirajo iz avtenticirane zahteve in od nikoder drugod. Nobena okoljska spremenljivka, glava, parameter poizvedbe ali segment poti jih ne more nastaviti. Telo zahteve, ki imenuje organizacijo, je zavrnjeno z TENANT_NOT_A_PARAMETER. Površina, ki ne more določiti, kateremu najemniku, lastniku in enoti pripada vrstica, zavrne zahtevo s 403 SCOPE_PREDICATE_MISSING, telo pa navede, katere osi so bile razrešene in katere ne. Nikoli ne preklopi na širše branje.

To velja na dveh mestih hkrati.

V podatkovni bazi. Vsaka storitev se poveže kot lastne izvajalne vloge: nexus_auth, auth_app in auth_platform za storitev identitete, nexus_probitas in nexus_probitas_ledger za Probitas ter nexus_gateway, nexus_graphrag, nexus_skills, orchestrator_app, workflows_app in preostale za druge. Nobena ni superuporabnik niti nima pravice BYPASSRLS. Nobena tudi ni lastnica tabel, ki jih uporablja, zato zanjo velja vsaka politika varnosti na ravni vrstic (RLS). Vloge si delijo skupino, nexus_runtime, ki podeljuje povezavo in uporabo sheme ter nobenih pravic na tabelah; vsaki storitvi so lastne tabele podeljene prek lastnih migracij. Nastavitve najemnika, ki jih berejo politike RLS, je mogoče nastaviti samo prek funkcije bind_scope vsake storitve, ki se izvaja kot njen lastnik. Začetni zagon prekliče set_config vsem drugim, orkestrator in Probitas pa se nočeta zagnati, če bi jo njuna izvajalna vloga lahko poklicala neposredno (Probitas to imenuje DB_ROLE_SETS_SCOPE_DIRECTLY). Edine povezave superuporabnika v celotni namestitvi pripadajo opravilu Job za začetni zagon in koraku priprave v BFF.

V skupnem osnovnem gradniku za zamejene poizvedbe. Vsako skladišče v platformi in vsak vtičnik, zgrajen na SDK (kompletu za razvoj programske opreme), podeduje eno ograjo, ki zgradi predikat SQL iz razrešenega obsega. Njegova funkcija obsega sprejme preverjeno identiteto in nima parametra organizacije, zato ga klicatelj ne more posredovati in nobena pot se ne more izvzeti.

Obstaja natanko en prehod meje najemnika, in ta je ozek: zabeležena odobritev. Dve osebi v organizaciji, ki ima vrstice, zabeležita, katera organizacija sme brati katere tabele in do kdaj. Vsako branje poteka v transakciji samo za branje in se beleži v dnevnik pri obeh najemnikih. Lastniki in skrbniki nikoli ne berejo navzkrižno, bralec pa odobritve ne more razširiti.

Pot UI

Klicatelji izrazijo želje. Usmerjevalnik ponudnikov UI je lastnik poverilnice in sprejme končno odločitev.

Vsak klic modela v sistemu Nexus gre prek poti /internal/ai/* usmerjevalnika, usmerjevalnik pa sprejme samo imenovane klicatelje. Paket na prehodu nastavi tri sezname:

Poti Kdo sme klicati
Klepet in pretakanje klepeta nexus-orchestrator, nexus-workflows, nexus-skills-engine
Vdelave in prerazvrščanje nexus-graphrag, nexus-skills-engine, nexus-workflows
Vse drugo, vključno z izvajanjem orodij nexus-orchestrator, nexus-workflows

Klic brez identitete klicatelja je zavrnjen s 403 MISSING_CALLER_IDENTITY, klicatelj, ki ni na seznamu, pa s 403 UNAUTHORIZED_CALLER. Vtičnikov ni na nobenem seznamu, in to je namerno: klici modelov vtičnika se izvajajo v njegovem imenu, prek razpošiljanja UNO.

Kar klicatelj sme poslati, je želja: želeni ponudnik in model ter profil zmogljivosti, kot je najmanjša dolžina konteksta ali uporaba orodij. Usmerjevalnik upošteva željo le, ko ima organizacija tega ponudnika omogočenega in opremljenega s poverilnicami; sicer ga nadomesti, najprej znotraj istega ponudnika, nato med drugimi ponudniki organizacije. Profil zmogljivosti samo filtrira, zahteva glede lokacije hrambe podatkov v njem pa je stroga. Ko nič ne ustreza, ni rezervnega modela: klicatelj dobi 422 MODEL_CAPABILITY_UNAVAILABLE ali 422 NO_PROVIDER_FOR_ROLE, z nizom za odpravo težave, ki ga konzola prikaže skrbniku.

Ključi pripadajo organizaciji. Skrbniki vsake organizacije vstavijo lastne ključe ponudnikov v njen nabor prek konzole, usmerjevalnik pa jih razreši ob času klica. Noben ključ modela ni vrednost paketa in noben se ne dobavlja s sistemom Nexus. Organizacija brez ključa ne dobi nobenih odgovorov UI, in konzola to jasno pove; nič od drugod ne zapolni vrzeli.

Dve vrednosti paketa Helm oblikujeta usmerjevalnik. ai.localProvider.baseUrl poimenuje strežnik modelov, združljiv z OpenAI, ki ga upravljate vi, in je usmerjen kot kateri koli drug ponudnik. ai.installationHosts navaja vaše strežnike modelov na zasebnih imenih, ki jih usmerjevalnik šteje kot del namestitve. Tudi GraphRAG ustvarja vložitve prek usmerjevalnika, v imenu organizacije, katere vsebina to je. Privzeti model za vložitve se izvaja v gruči brez grafične kartice; gostovane vložitve so izbira vsake posamezne organizacije.

Brez telemetrije

Nič ne zapusti namestitve, razen če to pošljete sami. Vrednost telemetry.enabled v paketu Helm je lahko le false; shema zavrne vse drugo. Izklopljeno je tudi lastno poročanje podatkovnega sloja: poročilo o uporabi Neo4j in telemetrija Qdrant sta v paketu onemogočena.

Ko je vklopljena možnost networkPolicy.enabled, kar je privzeto, noben pod ne more doseči interneta, razen če cilj navedete v networkPolicy.externalEgressCIDRs. Ponudnik gostovanih modelov je eden takšnih ciljev, prav tako vaš poštni posrednik.

Isto pravilo je spremenilo eno privzeto nastavitev, ki jo boste opazili. CAPTCHA storitve nexus-auth za prijave novih uporabnikov potrebuje internetno storitev, zato je na namestitvi izklopljena, prijava neznanca pa čaka na odobritev skrbnika (403 SIGNUP_REQUIRES_APPROVAL). Zaslon, ki blokira prijave iz gostiteljskih omrežij, je prav tako izklopljen, saj potrebuje licenčne podatkovne baze, ki jih Nexus ne vključuje. To preverjanje tako izgubite.

Stanje namestitve
Stanje namestitve
V izdaji Enterprise stran s stanjem prikazuje gručo pod sistemom Nexus: kako obremenjen je posamezen del in koliko zmogljivosti je še na voljo, pri čemer je ob vsakem opozorilu navedeno, kako ukrepati.