BejelentkezésBemutató kérése

2.1. fejezet

Architektúra

Melyik szolgáltatás miért felel a Nexus chartban, milyen adattárolók találhatók alattuk, és milyen szabályok tartják össze őket, a szolgáltatások közötti identitástól kezdve az útvonalig, amelyet minden modellhívás bejár.

Ezt az oldalt AI fordította az eredeti angol szövegből. Ha bármi nem egyértelmű, az angol nyelvű oldal az irányadó. Oldal olvasása angolul

19 perc olvasási idő

Amikor Tomás Reilly végzett az első telepítéssel a Harrow Port Authoritynél, a kubectl -n nexus get pods tíz Deploymentet és hét StatefulSetet, valamint három CronJobot mutatott. Az adatbázist felépítő migrációs Jobok már eltűntek, mivel sikeres futás után mindegyik törli önmagát. Ez a lista a teljes platform. Érdemes megtanulni, mert a mindennapi üzemeltetési kérdések többsége így kezdődik: „ezek közül melyik felel azért?”

Ez a fejezet minden egyes elemre megválaszolja ezt a kérdést, végigkövet rajtuk egy kérést, majd bemutatja a szabályokat, amelyeknek mindegyikük engedelmeskedik. A 2. rész további fejezetei erre a képre építenek.

A szolgáltatások és amiért felelnek

A chart egyetlen Helm chart, a nexus, 1.0.0-alpha.1 verzió, Kubernetes 1.33 vagy újabb rendszerhez. Minden számítási feladat saját ServiceAccount alatt, nem root felhasználóként fut, az összes Linux capability eldobásával. A személyazonosságot és a kulcsokat védő szolgáltatásokba irányuló hívások kölcsönös TLS (Transport Layer Security) kapcsolaton keresztül zajlanak, a nyilvános API (alkalmazásprogramozási felület) pedig közös folyamatban fut az AI-útválasztóval (mesterséges intelligencia).

Komponens Deployment és Service Szolgáltatásport Amiért felel
Konzol nexus-alpha 3000 A felhasználók által látott oldalak; HTML-t (Hypertext Markup Language) szolgál ki a konzol hosztján
BFF (backend for frontend, a frontendet kiszolgáló backend) nexus-alpha-bff 8080 A konzol saját adatai, az egyes felhasználók menüje, a kiadási nyilvántartás
Hitelesítés nexus-auth 9101 (kölcsönös TLS a 8443-on) Személyek, szervezetek, munkamenetek, tokenek, API-kulcsok, a szervezet modellkulcs-készlete
Átjáró (Gateway) nexus-gateway 9092, WebSocket 8093 Az AI Provider Router, valamint a nyilvános API-végpont a REST (representational state transfer) és az MCP (Model Context Protocol) számára
Orchestrator nexus-orchestrator 8080 UNO feladatindítás: minden feladat fogadása és sorba állítása
Munkafolyamatok nexus-workflows 8081 UNO végrehajtás: a sorba állított feladatokat futtató feldolgozó (worker)
GraphRAG nexus-graphrag 8090, WebSocket 8091 Memória: a tudásgráf és a rajta végzett visszakeresés
Probitas nexus-probitas 9151 (HTTPS) Bizonyítékok: irányítási (governance) rekordok és a lezárt főkönyv
Skill-motor nexus-skills-engine 8095 A képességtár (skill library); képességek keresése és futtatása
Kulcsok nexus-keys 8080 (HTTPS, kölcsönös TLS) Szervezetenkénti kulcsok az OpenBao-ban, kulcsőrzés (custody), a telepítési identitás
Bővítmények (Plugins) nexus-plugins 9111 A bővítmény-nyilvántartás és a katalógusrekordok; alapértelmezetten kikapcsolva
Fájlfeldolgozás nexus-fileprocess 9109 Feltöltött dokumentumok és képek olvasása; alapértelmezetten kikapcsolva

Az első tíz kötelező. Az utolsó kettő opcionális, a components.plugins.enabled és components.fileprocess.enabled beállításokkal kapcsolható be ott, ahol egy Enterprise telepítés vagy egy szakterületi csomag (domain pack) használja őket. Egy további opcionális szolgáltatás, a 8080-as porton futó nexus-alive saját kapcsolóval rendelkezik (components.alive.enabled), és alapértelmezetten szintén ki van kapcsolva. Az egyes elemek replikái és erőforrásai a components.<name> alatt találhatók.

A konzol szerveroldalon renderelt oldalakból áll, adatbázis nélkül. A BFF-fel, valamint a klaszteren belül a nexus-auth szolgáltatással kommunikál, soha nem megy ki a nyilvános auth hoszton keresztül, majd vissza. Nem indul el a kiadási típusa (edition) nélkül, amelyet a chart NEXUS_EDITION értékként ad át az egyetlen edition értékből. Egy szervezet minden tagja a saját szerepkörének megfelelően dolgozik benne. Az adminisztrációs oldalak a tulajdonosoknak és az adminisztrátoroknak szólnak; ha egy egyszerű tag nyit meg egy ilyet, a „Nem adminisztrátor” oldalt kapja.

A BFF a konzol szerveroldali fele, amely a platform bővítményeként épül fel, és Nexus Alpha termékként van regisztrálva. A konzol saját tábláit egy külön adatbázisban, a nexus_alpha adatbázisban tárolja, és ez dönti el, hogy egy felhasználó mely menücsoportokat látja. Amikor a konzolnak el kell végeztetnie egy munkát, a BFF megkéri rá az azért felelős szolgáltatást.

A nexus-auth Go nyelven íródott, és ez az egyetlen szolgáltatás, amely tokeneket bocsát ki. A hozzáférési tokenek élettartama alapértelmezetten 15 perc, a frissítési tokeneké pedig 12 óra (auth.accessTokenTTL, auth.refreshTokenTTL). Minden bejelentkezett felhasználót percenként 5000 kérésre korlátoz, mielőtt 429-es válasszal térne vissza (auth.rateLimitPerMinute). Két figyelőprocesst (listener) futtat: egy egyszerűt a 8080-as konténerporton, amelyet a nyilvános Ingress ér el, és egy kölcsönös TLS-t használót a 8443-as porton, amelyet minden klaszteren belüli hívónak használnia kell. A X-Forwarded-For fejlécnek csak a proxy.trustedCIDRs listában szereplő ugrásoktól (hop) hisz; ez egy Classless Inter-Domain Routing (CIDR) tartományokból álló lista, amelynek alapértelmezett értéke 10.42.0.0/16, a k3s podhálózata. Ha az Ön ingress vezérlője máshol fut, módosítsa ezt az értéket. Ellenkező esetben minden bejelentkezés úgy fog kinézni, mintha a vezérlőtől érkezett volna.

Az átjáró (gateway) két feladatot lát el egyetlen közös folyamatban. A klaszteren belül ez az AI Provider Router (az 1. részben és a konzol oldalain szereplő AI-kapcsolóközpont), a szervezet modell-hitelesítő adatainak egyedüli birtokosa (erről bővebben alább). A peremhálózaton (edge) ezt éri el a api.<domain>: a REST-kliensek és az MCP-kliensek, amelyek tokenjei a https://<hosts.api>/mcp célközönséget (audience) hordozzák, és az auth hoszton futó OAuth 2.1 engedélyezési szervertől származnak (az OAuth a delegált engedélyezés nyílt szabványa).

Az orchestrator és a workflows együtt alkotják az UNO munkafolyamat-motort. Minden számítási művelet rajtuk keresztül fut. Az orchestrator a POST /api/v1/dispatch útvonalon fogadja a feladatokat, 202-es kóddal, valamint egy jobId, runId és traceId értékkel válaszol, majd sorba állítja a feladatot. Nincs közvetlen (inline) végrehajtási útvonal: a kliens mindig lekérdezi (poll) a GET /api/v1/dispatch/{jobId} útvonalat, vagy visszahívást (callback) fogad. A workflows feldolgozó (worker) kiveszi a feladatokat a sorból – alapértelmezetten replikánként egyszerre négyet (workflows.concurrency) –, és pontosan egyetlen HTTP-útvonallal rendelkezik: GET /health.

A Probitas a bizonyítékszolgáltatás. Maga szolgálja ki a TLS-t egy olyan tanúsítványból, amelyet a chart bocsát ki, tábláit pedig a trust sémában tartja, külön szerepkörrel a főkönyv számára. Irányítási (governance) funkcióit a probitas.flags kapcsolja. Több funkció is shadow módban érkezik: a rendszer kiszámítja és rögzíti a döntést, de semmit sem blokkol, amíg Ön át nem állítja a jelzőt (flag).

A nexus-keys a platform Go nyelven írt kulcsszolgáltatása. Szervezetenként egy kulcsot tárol egy OpenBao kulcstárban, és éjszakánként forgatja (rotálja) őket. Éjszakai feladatai emellett megsemmisítik azokat a kulcsokat, amelyek megőrzési ideje lejárt, és a nyugtákat egy saját kötetre exportálják. Egy szervezet kulcsának törlése véglegesen olvashatatlanná teszi az alatta zárolt adatokat. Emellett az első rendszerindításkor (bootstrap) a keys.installationName alatt kibocsátja a telepítési identitást is, és ez a név végleges. Válassza meg körültekintően: a chart elutasítja az üres nevet (INSTALLATION_NAME_MISSING), és elutasítja a saját példaértékeiben szereplő nevet is (INSTALLATION_NAME_EXAMPLE).

Ez a telepítés (Community)
Ez a telepítés (Community)
Egy Community telepítés saját oldala megjeleníti a verziót és a motor állapotát. Világosan kijelenti, hogy nincs szükség licencre. Az oldal Enterprise részei kedvcsinálóként (teaser) jelennek meg.

Három nyilvános állomásnév (host)

A chart pontosan három hosztnevet tesz közzé, amelyek együtt alkotják a telepítési identitást. Ezek nélkül minden szolgáltatás megtagadja az elindulást.

Ingress Hosztnév értéke Backend
nexus-console hosts.console nexus-alpha, 3000-es port
nexus-api hosts.api nexus-gateway, 9092-es port
nexus-auth hosts.auth nexus-auth, 9101-es port

A könyvben szereplő példák a console.harrow.example, api.harrow.example és auth.harrow.example értékeket használják. Az Ingressek egyszerű networking.k8s.io/v1 objektumok, egyenként egy szabállyal és / útvonallal. A peremhálózati TLS a tls.mode beállítást követi: existing (egy Ön által létrehozott Secret, amelynek neve a tls.existingSecret alatt szerepel), cert-manager (egy Ön által futtatott ClusterIssuer, amelynek neve a tls.clusterIssuer alatt szerepel) vagy none (a TLS a klaszter előtt ér véget). A chart nem ad hozzá saját átirányítást, így az ACME (Automated Certificate Management Environment) HTTP-kihívások változatlanul elérik a megoldót (solver). A 2.11. fejezet (Variációk: külső adattárak, TLS és ingress) minden módot részletesen bemutat.

Semmi más nincs kitéve a külvilág felé. Az adattárak, az OpenBao és minden belső szolgáltatás kizárólag a névtéren belül figyel.

Három vízszintes sáv. A felső sáv az „Edge”, három Ingress dobozzal (console, api és auth felirattal), amelyek mindegyike lefelé mutat a saját Service elemére (nexus-alpha :3000, nexus-gateway :9092, nexus-auth :9101). A középső sáv a „Platform services”: egy doboz a nexus-alpha-bff számára; a nexus-orchestrator a nexus-workflows mellett, csoportosítva és UNO felirattal ellátva; majd a nexus-graphrag, a nexus-probitas, a nexus-skills-engine és a nexus-keys; valamint két szaggatott vonalú doboz az opcionális nexus-plugins és nexus-fileprocess számára. Az alsó sáv a „Data tier”, adattáranként egy-egy dobozzal (PostgreSQL, Valkey, Neo4j, Qdrant, SeaweedFS), valamint egy külön elkerített, „Key store” feliratú dobozzal, amely az openbao és az openbao-unsealer elemeket tartalmazza, és amelyet kizárólag a nexus-keys ér el.
Egy Nexus-telepítés komponensei és az alattuk lévő adattárak.

Egy kérés útja az elejétől a végéig

Íme, mi történik, amikor Aoife Brennan, a Harrow IT-vezetője megnyitja a konzolt, és feltesz egy kérdést az asszisztensnek az e havi kikötőhely-beosztásról.

  1. A böngészője betölti a https://console.harrow.example címet. A nexus-console Ingress ezt a 3000-es porton figyelő nexus-alpha szolgáltatáshoz küldi.
  2. Bejelentkezik az azonosítókulcsával (passkey). A bejelentkezési oldalak a auth.harrow.example útvonalon keresztül kommunikálnak a nexus-auth szolgáltatással, a nexus-auth pedig kibocsát számára egy hozzáférési tokent, amely tartalmazza a felhasználóját, a szervezetét, és – ha a munkamenetnek van ilyen – az üzleti egységét.
  3. A konzol szervere meghívja a BFF-et, amely ellenőrzi a tokent, és megkérdezi a nexus-auth szolgáltatást, hogy a szervezete rendelkezik-e a termékkel, és a szerepköre jogosult-e a hozzáférésre. Válaszként megkapja azokat a menücsoportokat, amelyeket a felhasználó láthat.
  4. A kérdése a BFF-től az orchestrator feladatindító (dispatch) útvonalára kerül, a szervezet és a felhasználó adatait pedig az ellenőrzött tokenből veszi a rendszer. Az orchestrator 202-es kóddal válaszol, és beteszi a feladatot egy Valkey-alapú várakozási sorba.
  5. Egy workflows feldolgozó (worker) átveszi a feladatot. A futtatott képességet (skill) a skills engine oldja fel, a Harrow dokumentumain végzett visszakeresés pedig a GraphRAG-hoz fut be, amely a Neo4j-t, a Qdrantot és a saját PostgreSQL sémáját olvassa.
  6. A modellhívás a /internal/ai/chat címen elérhető AI Provider Routerhez kerül. Az útválasztó kiválasztja a szolgáltatót és a modellt a Harrow saját kulcskészletéből és útválasztási szabályzatából, végrehajtja a hívást a Harrow kulcsával, majd visszaadja a választ (completion).
  7. Az eredmény a feladat futási sorába kerül. A BFF kiolvassa azt, a konzol pedig kirajzolja a választ a hivatkozásokkal együtt.

A szolgáltatások közötti ugrások (hop) kivetített (projected) szolgáltatástokeneket hordoznak, a nexus-auth, a nexus-keys és a Probitas felé irányuló hívások a telepítés saját hitelesítésszolgáltatójától (CA) származó TLS-en keresztül futnak, a 4–6. lépésekben történő minden adathozzáférés pedig már magában az adatbázisban a Harrow szervezetére van korlátozva. Az alábbi szakaszok mindkettőt elmagyarázzák.

Balról jobbra haladó folyamat. Egy böngésző doboz „1 page” kérést küld az Ingress console-nak, majd a nexus-alpha-nak. Egy oldalsó, „2 sign-in” feliratú nyíl a böngészőből az Ingress auth-on keresztül a nexus-auth-hoz vezet. A nexus-alpha „3 menu” kérést küld a nexus-alpha-bff-nek, amely egyeztet a nexus-auth-tal. A nexus-alpha-bff „4 dispatch, 202” üzenetet küld a nexus-orchestrator-nak, amely egy Valkey várakozási sor ikonba ír. A nexus-workflows lekéri az „5 job” feladatot a sorból, és meghívja a nexus-skills-engine-t és a nexus-graphrag-ot (amelynek három adattára a GraphRAG alatt látható). A nexus-workflows „6 chat” kérést küld az „AI Provider Router: organisation key pool” feliratú nexus-gateway-nek, amely egyetlen nyilat küld ki a fürt határán túlra a „model provider” felé. Egy pontozott, „7 result on run row” feliratú visszatérő nyíl vezet vissza a nexus-alpha-bff-hez.
Egyetlen asszisztensi kérdés útja a böngészőtől a modellszolgáltatóig és vissza.

Az adatréteg

A Nexus minden adattárból saját, aláírt példányt szállít, a csomagban pedig mindegyikhez megtalálható a forráskódra vonatkozó felajánlás. Mindegyiket legalább annyira választottuk a licence, mint a funkciója miatt.

Adattár Verzió Licenc Miért van rá szükség Kikötő Alapértelmezett kötet
PostgreSQL PostGIS-szel és pgvectorral PostgreSQL 16, PostGIS 3, pgvector 0.8 PostgreSQL Licence; PostGIS GPL-2.0-or-later Hiteles nyilvántartási rendszer (system of record) minden szolgáltatás számára; PostGIS a térképadatokhoz; pgvector a sorok mellett tárolt vektorokhoz 5432 50 GiB
Valkey 8.1 BSD-3-Clause Az UNO feladatsorok és a rövid élettartamú gyorsítótárak, például a nexus-auth API-kulcs gyorsítótára 6379 5 GiB
Neo4j Community Edition 5.26 GPL-3.0 A GraphRAG által épített és bejárt tudásgráf 7687 (Bolt) 20 GiB
Qdrant 1.15 Apache-2.0 Vektoros keresés a GraphRAG és a skills engine számára 6333 (HTTP), 6334 (gRPC távoli eljáráshívások) 10 GiB
SeaweedFS 4.48 Apache-2.0 Objektumtároló fájlok számára, kompatibilis az Amazon Simple Storage Service (S3) szolgáltatással 8333 50 GiB
OpenBao 2.6 MPL-2.0 A kulcstár és a hozzá tartozó feloldó (unsealer), a nexus-keys számára 8200 5 GiB és 1 GiB

Néhány választás valamilyen ismerősebb megoldást váltott ki. A Valkey a Redis 7.4 helyett áll, amelynek jelenlegi licenceit a kiadás elutasítja. A MinIO AGPL-3.0 licencű, így az objektumtároló a SeaweedFS lett. A GraphRAG a Bolt hálózati protokollon keresztül éri el a Neo4j Community Editiont, a szolgáltatások pedig a PostgreSQL protokollon keresztül érik el a PostGIS-t, így a GPL mindkettő esetében elszigetelt marad. Az OpenBao a Vault Linux Foundation által gondozott leágazása (fork), amely még a Vault licencváltása előtt jött létre.

Minden adattár bekapcsolt hitelesítéssel és generált hitelesítő adatokkal fut: jelszóval a Valkey, API-kulccsal a Qdrant, hozzáférési kulcsokkal a SeaweedFS esetében.

A dataTier alatti öt adattár mindegyike futhat a klaszteren belül (mode: in-cluster, ez az alapértelmezett), vagy lehet olyan is, amelyet Ön már eleve üzemeltet (mode: external, a external.host beállítással és egy external.existingSecret által megnevezett Secrettel). Külső PostgreSQL esetén állítsa a sslmode értéket verify-full vagy verify-ca értékre, és helyezze el a szerver hitelesítésszolgáltatói (CA) tanúsítványát ebben a Secretben; a részleteket a 2.11. fejezet (Variációk: külső adattárak, TLS és ingress) tartalmazza.

# 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

Az OpenBao páros kivétel: mindig a telepítésen belül fut, mivel a kulcsőrzési (custody) Job ott inicializálja.

Szolgáltatások közötti identitás

A Nexus service mesh nélkül fut. A kölcsönös TLS-t egy helyi hitelesítésszolgáltató (CA) biztosítja, amelyet a chart hoz létre a cert-manageren keresztül; ez utóbbit előzetesen telepíteni kell (a v1.21.3-as verzió tesztelt).

Egy önaláírt Issuer létrehoz egyetlen, tíz évig érvényes, ECDSA (Elliptic Curve Digital Signature Algorithm) P-256 típusú CA-tanúsítványt (nexus-local-ca). Egy második Issuer ezzel a CA-val ír alá. Minden olyan számítási feladat, amely a telepítésen belül egy TLS-szervert hív meg, saját ügyféltanúsítványt kap <service-account>-client-tls néven, amely 90 napig érvényes, és a lejárat előtt 15 nappal megújul. Egyetlen neve egy SPIFFE identitásformátumú egységes erőforrás-azonosító (URI):

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

Minden számítási feladat ca.crt néven találja meg a CA nyilvános tanúsítványát a saját tanúsítvány-Secretjében. Egyetlen pod sem csatolja fel a CA kulcsát, és nincs szükség trust-managerre sem.

Három szolgáltatás ellenőrzi tanúsítvány alapján a hívókat. A nexus-auth ezt a második figyelőprocesszén (listener), a 8443-as porton teszi, és minden klaszteren belüli hívó ezt tárcsázza. A nexus-keys az egyetlen figyelőprocesszén végzi ezt. A Probitas a saját tanúsítványából (nexus-probitas-tls) szolgálja ki a TLS-t, amelyet újra beolvas, amikor a cert-manager megújítja. Egyikük sem bízik meg a X-Forwarded-Client-Cert fejlécben.

Minden számítási feladat egyórás Kubernetes-tokeneket is kap a /var/run/secrets/nexus útvonalon – minden általa hívott szolgáltatáshoz egyet, az adott szolgáltatást megjelölve célközönségként (audience). A nexus-service-identities ConfigMap minden <namespace>/<service-account> értéket hozzárendel egy szolgáltatás- vagy bővítménynévhez; az ebből hiányzó számítási feladatok nem rendelkeznek identitással, és a rendszer elutasítja őket. Az orchestrator és a Probitas a Kubernetes API segítségével ellenőrzi ezeket a tokeneket. A futó szolgáltatások közül csak ez a kettő rendelkezik system:auth-delegator jogosultsággal vagy felcsatolt API-tokennel; az egyetlen másik, tokennel rendelkező feladat a telepítéskor lefutó kulcsőrzési (custody) Job.

A hálózati szabályzat (NetworkPolicy) lezárja azt, amit az identitáskezelés nem. A chart az alapértelmezett tiltásból (default deny) indul ki, majd engedélyezi a forgalmat a telepítés saját podjai között, a DNS (Domain Name System) felé, az ingress vezérlő névteréből (networkPolicy.ingressNamespace, alapértelmezetten kube-system) a három nyilvános Service felé, valamint az API-szerver felé a két tokenellenőrző számára. Az OpenBao podok a platform többi részétől eltérő címkét (label) viselnek, így a névtéren belüli nyílt szabály nem terjed ki rájuk: csak a nexus-keys, a hozzá tartozó Jobok és a kulcsőrzési (custody) Job jutnak át, a 8200-as porton. Minden mást, amit egy számítási feladatnak a névtéren kívül el kell érnie – például az Ön levelezési továbbítóját (mail relay) –, a networkPolicy.externalEgressCIDRs alatt kell megadni, amely alapértelmezetten üres.

Migrációk és a sémanapló

A migrációk Helm hookokként futnak, post-install és pre-upgrade eseményeken. A post-install hook azután fut le, hogy a kiadás Deploymentjei létrejöttek. Így az első telepítéskor a szolgáltatások úgy indulnak el, hogy a sémáik még nem léteznek, és folyamatos összeomlási ciklusba (crash-loop) kerülnének egy olyan adatbázissal szemben, amelyben nincs szerepkör, nincs jelszó és nincsenek táblák. A Nexus ezt egy főkönyv (ledger) segítségével kerüli el.

A hookok súlyozási (weight) sorrendben futnak, és a Helm minden Jobot bevár, mielőtt a következő súlyérték elindulna:

Súly Hook Mit csinál
-30 nexus-migrations-env és előfeltételek Létrehozza a kizárólag hookok által használt Secretet a migráló hitelesítő adataival, valamint mindent, amit a kulcsőrzési (custody) Job olvas
-20 nexus-db-bootstrap Létrehozza a nexus és nexus_alpha adatbázisokat, a migráló szerepkört, minden szolgáltatás futásidejű szerepkörét, a kiterjesztéseket és a főkönyvet
-15 nexus-openbao-custody-init Inicializálja a kulcstárat és a feloldót (unsealer), valamint kibocsátja a telepítési identitást
-12 nexus-graphrag-migrations A GraphRAG sémája, amely olyan objektumokat birtokol, amelyekre a nexus-auth alapállapota (baseline) hivatkozik
-10 nexus-auth-migrations Az identitásséma
-5 Az orchestrator, a gateway és a Probitas migrációi A saját sémáik; a Probitas először ellenőrzi, hogy léteznek-e az auth táblák
0 nexus-alpha-bff-migrations A konzol saját adatbázisa

Minden migrációs Job backoffLimit: 0 beállítással rendelkezik, így egy sikertelen migráció megszakítja a telepítést.

A főkönyv egyetlen tábla (nexus_release.schema_applied), lánconként és képfájl-lenyomatonként (image digest) egy-egy sorral. Minden hook csak azután írja be a saját sorát, hogy a migrációfuttatója visszatért. Minden PostgreSQL-t használó Deployment tartalmaz egy init konténert (wait-for-schema), amely egy olyan szerepkörként olvassa ezt a táblát, amely semmi mást nem olvashat (nexus_ledger_reader), és addig vár, amíg minden lánc, amelytől függ, nem mutat egy sort az adott kiadás képfájljához. Ekkor a szolgáltatás elindul. A workflows feldolgozó az orchestrator láncára vár, mivel osztozik vele az adatbázison, a skills engine pedig kizárólag a rendszerindításra (bootstrap) vár.

3 másodpercenként kérdez le (schemaWait.intervalSeconds), és 1800 másodperc után (schemaWait.timeoutSeconds) feladja egy olyan naplósorral, amely megnevezi a még hiányzó láncokat. A szolgáltatás saját konténere soha nem indul el hibás sémával.

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

Ezért nem szabad soha helm install --wait parancsot futtatnia. A --wait kapcsolóval a Helm a post-install hookok futtatása előtt vár a Deploymentekre, a Deploymentek pedig a hookokra várnak. Egyik sem mozdul. Telepítsen nélküle, és várjon utána; a 2.6. fejezet (A Community kiadás telepítése Kubernetesre) megadja a pontos parancsot.

Izoláció három tengely mentén

A Nexusban minden olvasás, írás, eszközhívás és képességindítás (skill dispatch) három tengely mentén van hatókörbe sorolva.

Tengely Mező Mit választ el
Bérlő (Tenant) organization_id Az egyik szervezetet a másiktól; szigorú határ
Tulajdonos (Owner) owner_user_id Egy személy dolgait mindenki másétól, még egyazon szervezeten belül is
Egység (Unit) business_unit_id Egy szervezet alegysége, opcionális

A tulajdonosi tengely sokakat meglep. Egy postafiók vagy egy személyes jegyzetfüzet kizárólag a tulajdonosa számára privát, még az ugyanabban az egységben, azonos szerepkörben dolgozó kollégák elől is. Egy adminisztrátor szabályzatokat állít be, és nem olvas tartalmat.

A tengelyek a hitelesített kérésből származnak, és sehonnan máshonnan. Semmilyen környezeti változó, fejléc, lekérdezési paraméter vagy útvonalszegmens nem állíthatja be őket. A szervezetet megnevező kéréstörzseket a rendszer TENANT_NOT_A_PARAMETER hibával elutasítja. Az olyan felületek, amelyek nem tudják megállapítani, hogy egy sor melyik bérlőhöz, tulajdonoshoz és egységhez tartozik, 403 SCOPE_PREDICATE_MISSING hibával utasítják el a kérést, a törzs pedig felsorolja, hogy mely tengelyeket sikerült feloldani és melyeket nem. A rendszer soha nem lép vissza egy tágabb olvasási jogosultságra.

Ez egyszerre két helyen is érvényesül.

Az adatbázisban. Minden szolgáltatás a saját futásidejű szerepköreként csatlakozik: nexus_auth, auth_app és auth_platform az identitásszolgáltatás esetében, nexus_probitas és nexus_probitas_ledger a Probitas esetében, valamint nexus_gateway, nexus_graphrag, nexus_skills, orchestrator_app, workflows_app és a többi a további szolgáltatásoknál. Egyik sem superuser, és egyik sem rendelkezik BYPASSRLS jogosultsággal. Egyik sem birtokolja az általa használt táblákat sem, így minden sorszintű biztonsági (RLS) szabályzat vonatkozik rájuk. A szerepkörök egy közös csoporton (nexus_runtime) osztoznak, amely csatlakozási és sémahasználati jogot ad, de semmilyen táblajogosultságot nem biztosít; minden szolgáltatás a saját migrációin keresztül kap jogot a saját tábláihoz. Az RLS-szabályzatok által olvasott bérlői beállításokat kizárólag az egyes szolgáltatások saját bind_scope függvényén keresztül lehet beállítani, amely a saját tulajdonosaként fut. A rendszerindító (bootstrap) folyamat mindenki mástól visszavonja a set_config jogosultságot, az orchestrator és a Probitas pedig megtagadja az indulást, ha a futásidejű szerepkörük közvetlenül meg tudná hívni azt (a Probitas ezt DB_ROLE_SETS_SCOPE_DIRECTLY néven illeti). A teljes telepítésben az egyetlen superuser-kapcsolatok a rendszerindító Jobhoz és a BFF előkészítési (provisioning) lépéséhez tartoznak.

A megosztott, hatókörhöz kötött lekérdezési alapkomponensben (primitive). A platform minden adattára (repository) és az SDK-ra (szoftverfejlesztő készlet) épülő minden bővítmény örököl egy közös védőkorlátot, amely a feloldott hatókörből építi fel az SQL-predikátumot. A hatókörfüggvény az ellenőrzött identitást fogadja, és nincs szervezeti paramétere, így a hívó nem adhat át ilyet, és egyetlen útvonal sem kerülheti meg.

A bérlői határnak pontosan egyetlen átlépési módja van, és az is szűk: egy rögzített engedély (grant). A sorokat birtokló szervezet két munkatársa rögzíti, hogy melyik szervezet mely táblákat olvashatja, és meddig. Minden olvasás csak olvasható (read-only) tranzakcióban fut, és mindkét bérlőnél naplózásra kerül. A tulajdonosok és az adminisztrátorok soha nem látnak át a határon, az olvasó fél pedig nem tágíthatja ki az engedélyt.

Az AI-útvonal

A hívók kívánságokat fogalmaznak meg. Az AI Provider Router birtokolja a hitelesítő adatokat, és ő hozza meg a végső döntést.

A Nexusban minden modellhívás az útválasztó /internal/ai/* útvonalain keresztül zajlik, és az útválasztó csak megnevezett hívókat enged be. A chart három listát állít be az átjárón:

Útvonalak Ki hívhatja
Csevegés és csevegés-adatfolyam (streaming) nexus-orchestrator, nexus-workflows, nexus-skills-engine
Beágyazások (embeddings) és újrarangsorolás (rerank) nexus-graphrag, nexus-skills-engine, nexus-workflows
Minden más, beleértve az eszközvégrehajtást is nexus-orchestrator, nexus-workflows

A hívóidentitás nélküli hívásokat a rendszer 403 MISSING_CALLER_IDENTITY hibával, a listán nem szereplő hívókat pedig 403 UNAUTHORIZED_CALLER hibával utasítja el. A bővítmények egyik listán sem szerepelnek, és ez szándékos: egy bővítmény modellhívásai az ő nevében, az UNO feladatindításon keresztül történnek.

Amit a hívó küldhet, az egy kívánság: egy előnyben részesített szolgáltató és modell, valamint egy képességprofil, például minimális kontextushossz vagy eszközhasználat. Az útválasztó csak akkor teljesíti a kívánságot, ha a szervezetnél az adott szolgáltató engedélyezve van, és rendelkezik hitelesítő adatokkal; ellenkező esetben helyettesít, először ugyanazon szolgáltatón belül, majd a szervezet többi szolgáltatója között. A képességprofil csak szűr, a benne szereplő adathelyhez kötöttségi (data-residency) követelmény pedig szigorú feltétel. Ha semmi sem felel meg, nincs tartalék (fallback) modell: a hívó 422 MODEL_CAPABILITY_UNAVAILABLE vagy 422 NO_PROVIDER_FOR_ROLE hibát kap, egy hibaelhárítási szöveggel együtt, amelyet a konzol megjelenít az adminisztrátornak.

A kulcsok a szervezethez tartoznak. Minden szervezet adminisztrátorai a konzolon keresztül teszik be a saját szolgáltatói kulcsaikat a szervezet készletébe, az útválasztó pedig a hívás pillanatában oldja fel őket. Egyetlen modellkulcs sem szerepel chart-értékként, és a Nexus egyet sem szállít beépítve. A kulccsal nem rendelkező szervezet nem kap AI-válaszokat, és a konzol ezt nyíltan ki is írja; semmi sem pótolja a hiányt máshonnan.

Két chart-érték határozza meg az útválasztó működését. A ai.localProvider.baseUrl egy Ön által üzemeltetett, OpenAI-kompatibilis modellszervert nevez meg, amelyhez az irányítás ugyanúgy történik, mint bármely más szolgáltatóhoz. A ai.installationHosts a privát neveken elérhető modellszervereit sorolja fel, amelyeket az útválasztó a telepítésen belülinek tekint. A GraphRAG is az útválasztón keresztül végzi a beágyazást (embedding), azon szervezet nevében, amelyhez a tartalom tartozik. Az alapértelmezett beágyazási modell grafikus kártya nélkül fut a fürtben; a kiszervezett (hosted) beágyazások használata az egyes szervezetek saját döntése.

Nincs telemetria

Semmi sem hagyja el a telepítést, hacsak Ön nem küldi el. A chart telemetry.enabled értéke kizárólag false lehet; a séma minden mást elutasít. Az adatréteg saját jelentésküldése is ki van kapcsolva: a Neo4j használati jelentése és a Qdrant telemetriája le van tiltva a chartban.

Amikor a networkPolicy.enabled be van kapcsolva – ami az alapértelmezés –, egyetlen pod sem érheti el az internetet, hacsak Ön fel nem veszi a célhelyet a networkPolicy.externalEgressCIDRs listába. Ilyen célhely például egy külső modellszolgáltató, ahogyan az Ön levelezési továbbítója (mail relay) is.

Ugyanez a szabály megváltoztatott egy alapértelmezett beállítást, amelyet észre fog venni. A nexus-auth regisztrációs CAPTCHA-jához internetes szolgáltatásra van szükség, ezért egy telepítésen ez ki van kapcsolva, az ismeretlenek regisztrációja pedig rendszergazdai jóváhagyásra vár (403 SIGNUP_REQUIRES_APPROVAL). A tárhelyszolgáltatói hálózatokból érkező regisztrációkat blokkoló szűrés szintén ki van kapcsolva, mivel olyan licencelt adatbázisokat igényel, amelyeket a Nexus nem tartalmaz. Ezt az előszűrést így elveszíti.

A telepítés állapota
A telepítés állapota
Enterprise kiadás esetén az állapotoldal megmutatja a Nexus alatti fürtöt: mennyire leterheltek az egyes részek, mennyi kapacitás maradt, és minden figyelmeztetés mellett ott szerepel a szükséges teendő is.