HyniRezervoni një prezantim

Kapitulli 2.1

Arkitektura

Çfarë zotëron secili shërbim në grafikun e Nexus dhe cilat depoja të dhënash qëndrojnë poshtë tij, dhe më pas rregullat që i mbajnë ato bashkë, nga identiteti midis shërbimeve deri te rruga që ndjek çdo thirrje modeli.

Kjo faqe u përkthye nga AI prej origjinalit në anglisht. Nëse diçka është e paqartë, faqja në anglisht shërben si referencë. Lexoni këtë faqe në anglisht

19 minuta lexim

Kur Tomás Reilly përfundoi instalimin e parë në Harrow Port Authority, kubectl -n nexus get pods tregoi dhjetë Deployments dhe shtatë StatefulSets, plus tre CronJobs. Jobs e migrimit që ndërtuan bazën e të dhënave ishin larguar tashmë, sepse secili fshin veten kur përfundon me sukses. Ai listim është e gjithë platforma. Mësojeni atë, sepse shumica e pyetjeve të ditës së dytë fillojnë me "cila nga këto e zotëron atë?"

Ky kapitull i përgjigjet kësaj pyetjeje për secilën pjesë, ndjek një kërkesë përmes tyre dhe më pas mbulon rregullat që ato të gjitha zbatojnë. Pjesa tjetër e Pjesës 2 ndërtohet mbi këtë pamje.

Shërbimet dhe çfarë zotëron secili

Grafiku është një grafik Helm, nexus, versioni 1.0.0-alpha.1, për Kubernetes 1.33 ose më të ri. Çdo ngarkesë pune (workload) ekzekutohet nën ServiceAccount e vet, si përdorues jo-root, me të gjitha aftësitë (capabilities) e Linux të hequra. Thirrjet drejt shërbimeve që ruajnë identitetin dhe çelësat kryhen përmes TLS të ndërsjellë (Transport Layer Security), dhe API publik (ndërfaqja e programimit të aplikacioneve) ndan një proces me ruterin e AI (inteligjencës artificiale).

Komponenti Deployment dhe Service Porta e shërbimit Çfarë zotëron
Konsola nexus-alpha 3000 Faqet që shohin njerëzit; shërben HTML (Hypertext Markup Language) te hosti i konsolës
BFF (backend for frontend) nexus-alpha-bff 8080 Të dhënat e vetë konsolës, menyja që merr çdo person, regjistri i lëshimeve (release)
Auth nexus-auth 9101 (TLS i ndërsjellë në 8443) Njerëzit, organizatat, sesionet, tokenat, çelësat API, grupi i çelësave të modeleve të organizatës
Gateway nexus-gateway 9092, WebSocket 8093 AI Provider Router, dhe skaji i API-t publik për REST (representational state transfer) dhe MCP (Model Context Protocol)
Orkestruesi nexus-orchestrator 8080 Dërgimi UNO: pranimi i çdo pune (job) dhe vendosja e saj në radhë
Rrjedhat e punës (Workflows) nexus-workflows 8081 Ekzekutimi UNO: punëtori (worker) që ekzekuton punët në radhë
GraphRAG nexus-graphrag 8090, WebSocket 8091 Kujtesa: grafiku i njohurive dhe rikuperimi i të dhënave mbi të
Probitas nexus-probitas 9151 (HTTPS) Dëshmia: regjistrat e qeverisjes dhe libri kryesor i vulosur (sealed ledger)
Motori i aftësive (Skills engine) nexus-skills-engine 8095 Biblioteka e aftësive; gjetja dhe ekzekutimi i aftësive
Çelësat nexus-keys 8080 (HTTPS, TLS i ndërsjellë) Çelësat për çdo organizatë në OpenBao, kujdestaria (custody), identiteti i instalimit
Shtojcat (Plugins) nexus-plugins 9111 Regjistri i shtojcave dhe regjistrimet e katalogut; i çaktivizuar si parazgjedhje
Përpunimi i skedarëve nexus-fileprocess 9109 Leximi i dokumenteve dhe imazheve të ngarkuara; i çaktivizuar si parazgjedhje

Dhjetë të parat janë të detyrueshme. Dy të fundit janë opsionale, të aktivizuara me components.plugins.enabled dhe components.fileprocess.enabled kur një instalim Enterprise ose një paketë domeni i përdor ato. Edhe një shërbim tjetër opsional, nexus-alive në portën 8080, ka çelësin e vet, components.alive.enabled, dhe është gjithashtu i çaktivizuar si parazgjedhje. Replikat dhe burimet për secilin ndodhen nën components.<name>.

Konsola përbëhet nga faqe të renderuara në server pa bazë të dhënash. Ajo komunikon me BFF-në dhe me nexus-auth brenda klasterit, kurrë duke dalë jashtë përmes hostit publik të autentikimit dhe duke u rikthyer brenda. Ajo refuzon të niset pa edicionin e saj, të cilin grafiku e kalon si NEXUS_EDITION nga vlera e vetme edition. Çdo anëtar i një organizate punon në të sipas rolit të tij. Faqet e administrimit janë për pronarët dhe administratorët, dhe një anëtar që hap njërën prej tyre merr faqen "Not an administrator".

BFF është gjysma e serverit të konsolës dhe është ndërtuar si një shtojcë e platformës, e regjistruar si produkti Nexus Alpha. Ai mban tabelat e vetë konsolës në një bazë të dhënash të veçantë, nexus_alpha, dhe vendos se cilat grupe menysh sheh një person. Kur konsola ka nevojë të kryhet një punë, BFF ia kërkon shërbimit që e zotëron atë.

nexus-auth është shkruar në Go dhe është i vetmi shërbim që prodhon tokena. Tokenat e aksesit zgjasin 15 minuta dhe tokenat e rifreskimit 12 orë si parazgjedhje (auth.accessTokenTTL, auth.refreshTokenTTL). Ai kufizon çdo person të identifikuar në 5,000 kërkesa në minutë përpara se të përgjigjet me 429 (auth.rateLimitPerMinute). Ai ekzekuton dy dëgjues (listeners): atë të thjeshtë në portën e kontejnerit 8080 ku arrin Ingress publik, dhe një me TLS të ndërsjellë në 8443 që çdo thirrës brenda klasterit duhet të përdorë. Ai i beson X-Forwarded-For vetëm nga hapat (hops) në proxy.trustedCIDRs, një listë e diapazoneve Classless Inter-Domain Routing (CIDR), e cila ka si parazgjedhje 10.42.0.0/16, rrjetin e pod-eve k3s. Nëse kontrolluesi juaj ingress ekzekutohet diku tjetër, ndryshojeni atë. Përndryshe, çdo identifikim duket sikur ka ardhur nga kontrolluesi.

Gateway ka dy detyra që ndajnë një proces të vetëm. Brenda klasterit ai është AI Provider Router (centrali i AI në Pjesën 1 dhe në faqet e konsolës), mbajtësi i vetëm i kredencialeve të modeleve të një organizate (më shumë rreth kësaj më poshtë). Në skaj (edge) është ajo ku arrin api.<domain>: klientët REST dhe klientët MCP, tokenat e të cilëve mbajnë audiencën https://<hosts.api>/mcp dhe vijnë nga serveri i autorizimit OAuth 2.1 te hosti i autentikimit (OAuth është standardi i hapur për autorizim të deleguar).

Orkestruesi dhe rrjedhat e punës së bashku përbëjnë UNO-n, motorin e rrjedhës së punës. E gjithë përllogaritja ekzekutohet përmes tyre. Orkestruesi pranon një punë në POST /api/v1/dispatch, përgjigjet me 202 me një jobId, runId dhe traceId, dhe e vendos atë në radhë. Nuk ka rrugë ekzekutimi të drejtpërdrejtë (inline): një klient gjithmonë pyet periodikisht (polls) GET /api/v1/dispatch/{jobId} ose merr një thirrje kthimi (callback). Punëtori i rrjedhave të punës tërheq punët nga radha, katër njëherësh për çdo replikë si parazgjedhje (workflows.concurrency), dhe ka saktësisht një rrugë HTTP, GET /health.

Probitas është shërbimi i dëshmive. Ai shërben vetë TLS, nga një certifikatë që lëshon grafiku, dhe i mban tabelat e tij në skemën trust me një rol të veçantë për librin kryesor (ledger). Veçoritë e tij të qeverisjes ndërrohen nga probitas.flags. Disa prej tyre vijnë në modalitetin shadow: verdikti llogaritet dhe regjistrohet, dhe asgjë nuk bllokohet derisa të ndryshoni flamurin (flag).

nexus-keys është shërbimi i çelësave të platformës, i shkruar në Go. Ai mban një çelës për çdo organizatë në një depo çelësash OpenBao dhe i rrotullon ato çdo natë. Punët e tij të natës gjithashtu shkatërrojnë çelësat, data e mbajtjes së të cilëve ka ardhur, dhe eksportojnë faturat e tij në një vëllim (volume) të vetin. Fshirja e çelësit të një organizate i bën të dhënat e kyçura nën të të palexueshme përgjithmonë. Ai gjithashtu prodhon identitetin e instalimit në nisjen e parë (bootstrap), nën keys.installationName, dhe ai emër është i përhershëm. Zgjidheni me kujdes: grafiku refuzon një emër bosh (INSTALLATION_NAME_MISSING) dhe refuzon emrin në vlerat e veta të shembullit (INSTALLATION_NAME_EXAMPLE).

Ky instalim (Community)
Ky instalim (Community)
Faqja e vetë një instalimi Community tregon versionin e tij dhe gjendjen e motorit. Ajo thotë qartë se nuk nevojitet asnjë licencë. Pjesët Enterprise të faqes paraqiten si ngacmues reklamues (teasers).

Tre hoste publike

Grafiku publikon saktësisht tre emra hostesh, të cilët së bashku përbëjnë identitetin e instalimit. Çdo shërbim refuzon të niset pa to.

Ingress Vlera e hostit Backend
nexus-console hosts.console nexus-alpha, porta 3000
nexus-api hosts.api nexus-gateway, porta 9092
nexus-auth hosts.auth nexus-auth, porta 9101

Shembujt në këtë libër përdorin console.harrow.example, api.harrow.example dhe auth.harrow.example. Ingress-et janë objekte të thjeshta networking.k8s.io/v1 me një rregull secili, shtegu /. TLS në skaj ndjek tls.mode: existing (një Secret që keni krijuar ju, i emërtuar në tls.existingSecret), cert-manager (një ClusterIssuer që ekzekutoni ju, i emërtuar në tls.clusterIssuer) ose none (TLS përfundon përpara klasterit). Grafiku nuk shton asnjë ridrejtim të vetin, kështu që një sfidë HTTP e ACME (Automated Certificate Management Environment) arrin te zgjidhësi juaj e pandryshuar. Kapitulli 2.11, Variacione: depot e jashtme, TLS dhe ingress, mbulon secilin modalitet.

Asgjë tjetër nuk ekspozohet. Depot e të dhënave, OpenBao dhe çdo shërbim i brendshëm dëgjojnë vetëm brenda hapësirës së emrave (namespace).

Tre breza horizontalë. Brezi i sipërm është "Edge" me tre kuti Ingress të etiketuara console, api dhe auth, ku secila tregon poshtë drejt Service-it të saj (nexus-alpha :3000, nexus-gateway :9092, nexus-auth :9101). Brezi i mesëm është "Platform services": një kuti për nexus-alpha-bff; nexus-orchestrator pranë nexus-workflows, të grupuara dhe të etiketuara UNO; pastaj nexus-graphrag, nexus-probitas, nexus-skills-engine, nexus-keys; dhe dy kuti me vija të ndërprera për shërbimet opsionale nexus-plugins dhe nexus-fileprocess. Brezi i poshtëm është "Data tier" me nga një kuti për çdo depo ruajtjeje (PostgreSQL, Valkey, Neo4j, Qdrant, SeaweedFS), dhe një kuti të veçantë të rrethuar të etiketuar "Key store" që mban openbao dhe openbao-unsealer, e arritshme vetëm nga nexus-keys.
Komponentët e një instalimi Nexus dhe depot nën to.

Një kërkesë, nga fillimi në fund

Ja çfarë ndodh kur Aoife Brennan, drejtuese e IT-së në Harrow, hap konsolën dhe i bën asistentit një pyetje rreth orarit të ankorimit të këtij muaji.

  1. Shfletuesi i saj ngarkon https://console.harrow.example. Ingress-i nexus-console e dërgon atë te nexus-alpha në portën 3000.
  2. Ajo identifikohet me passkey-n e saj. Faqet e identifikimit komunikojnë me nexus-auth përmes auth.harrow.example, dhe nexus-auth prodhon për të një token aksesi që mban përdoruesin e saj, organizatën e saj dhe, kur sesioni i saj ka një të tillë, njësinë e saj të biznesit.
  3. Serveri i konsolës thërret BFF-në, i cili kontrollon tokenin e saj dhe pyet nexus-auth nëse organizata e saj e zotëron produktin dhe nëse roli i saj pranohet. Ai përgjigjet me grupet e menyve që ajo mund të shohë.
  4. Pyetja e saj shkon nga BFF-ja te rruga e dërgimit e orkestruesit, me organizatën dhe përdoruesin e saj të marrë nga tokeni i verifikuar. Orkestruesi përgjigjet me 202 dhe e vendos punën në një radhë në Valkey.
  5. Një punëtor i rrjedhave të punës e merr punën. Aftësia që ai ekzekuton zgjidhet nga motori i aftësive, dhe rikuperimi i të dhënave mbi dokumentet e Harrow shkon te GraphRAG, i cili lexon Neo4j, Qdrant dhe skemën e tij PostgreSQL.
  6. Thirrja e modelit shkon te AI Provider Router në /internal/ai/chat. Ruteri zgjedh ofruesin dhe modelin nga grupi i çelësave dhe politika e rrugëzimit e vetë Harrow-it, bën thirrjen me çelësin e Harrow-it dhe kthen plotësimin (completion).
  7. Rezultati vendoset në rreshtin e ekzekutimit të punës. BFF-ja e lexon atë dhe konsola shfaq përgjigjen, së bashku me citimet e saj.

Hapat nga shërbimi në shërbim mbajnë tokena shërbimi të projektuar, ata drejt nexus-auth, nexus-keys dhe Probitas ekzekutohen mbi TLS nga autoriteti i certifikatave i vetë instalimit, dhe çdo akses në të dhëna në hapat 4 deri në 6 është i kufizuar te organizata e Harrow-it në vetë bazën e të dhënave. Seksionet më poshtë i shpjegojnë të dyja.

Një sekuencë nga e majta në të djathtë. Një kuti shfletuesi dërgon "1 page" te Ingress console, pastaj te nexus-alpha. Një shigjetë anësore "2 sign-in" shkon nga shfletuesi përmes Ingress auth te nexus-auth. nexus-alpha dërgon "3 menu" te nexus-alpha-bff, i cili verifikon me nexus-auth. nexus-alpha-bff dërgon "4 dispatch, 202" te nexus-orchestrator, i cili shkruan në një ikonë radhe Valkey. nexus-workflows tërheq "5 job" nga radha dhe thërret nexus-skills-engine dhe nexus-graphrag (me tri depot e tij të vizatuara nën GraphRAG). nexus-workflows dërgon "6 chat" te nexus-gateway, të etiketuar "AI Provider Router: organisation key pool", i cili dërgon një shigjetë të vetme jashtë kufirit të klasterit drejt "model provider". Një shigjetë kthimi me pika "7 result on run row" kthehet prapa te nexus-alpha-bff.
Një pyetje për asistentin, nga shfletuesi te ofruesi i modelit dhe kthim.

Shtresa e të dhënave

Nexus shpërndan kopjen e vet të nënshkruar të çdo depoje, me ofertën e kodit burimor për secilën në paketë. Secila u zgjodh sa për licencën aq edhe për funksionin e saj.

Depoja Versioni Licenca Pse ndodhet aty Porta Vëllimi i parazgjedhur
PostgreSQL me PostGIS dhe pgvector PostgreSQL 16, PostGIS 3, pgvector 0.8 PostgreSQL Licence; PostGIS GPL-2.0-or-later Sistemi i regjistrimit për çdo shërbim; PostGIS për të dhënat e hartave; pgvector për vektorët e mbajtur pranë rreshtave 5432 50 GiB
Valkey 8.1 BSD-3-Clause Radhët e punëve UNO dhe memoriet e përkohshme (caches) jetëshkurtra, siç është memoria e përkohshme e çelësave API e nexus-auth 6379 5 GiB
Neo4j Community Edition 5.26 GPL-3.0 Grafiku i njohurive që GraphRAG ndërton dhe përshkon 7687 (Bolt) 20 GiB
Qdrant 1.15 Apache-2.0 Kërkimi vektorial për GraphRAG dhe motorin e aftësive 6333 (HTTP), 6334 (thirrjet e procedurave në distancë gRPC) 10 GiB
SeaweedFS 4.48 Apache-2.0 Ruajtja e objekteve për skedarët, e përputhshme me Amazon Simple Storage Service (S3) 8333 50 GiB
OpenBao 2.6 MPL-2.0 Depoja e çelësave dhe çvulosësi i saj, për nexus-keys 8200 5 GiB dhe 1 GiB

Disa zgjedhje zëvendësuan diçka më të njohur. Valkey zëvendëson Redis 7.4, licencat aktuale të të cilit lëshimi i refuzon. MinIO është AGPL-3.0, kështu që depoja e objekteve është SeaweedFS. GraphRAG arrin Neo4j Community Edition përmes Bolt, një protokoll rrjeti, dhe shërbimet arrijnë PostGIS përmes protokollit PostgreSQL, kështu që GPL qëndron me secilin prej tyre. OpenBao është degëzimi (fork) i Vault nga Linux Foundation përpara ndryshimit të licencës së Vault.

Çdo depo ekzekutohet me autentikim të aktivizuar dhe kredenciale të gjeneruara: një fjalëkalim për Valkey, një çelës API për Qdrant, çelësa aksesi për SeaweedFS.

Secila nga pesë depot nën dataTier ekzekutohet në klaster (mode: in-cluster, parazgjedhja) ose është një që ju tashmë e operoni (mode: external, me external.host dhe një Secret të emërtuar nga external.existingSecret). Për një PostgreSQL të jashtëm, vendosni sslmode në verify-full ose verify-ca, dhe vendosni certifikatën e autoritetit të certifikatave (CA) të serverit në atë Secret; kapitulli 2.11, Variacione: depot e jashtme, TLS dhe ingress, përmban detajet.

# 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

Çifti OpenBao është përjashtimi: ai gjithmonë ekzekutohet brenda instalimit, sepse Job-i i kujdestarisë (custody) e inicializon atë atje.

Identiteti midis shërbimeve

Nexus ekzekutohet pa një rrjetë shërbimesh (service mesh). TLS i ndërsjellë vjen nga një autoritet lokal certifikatash (CA) që grafiku krijon përmes cert-manager, i cili duhet të instalohet i pari (v1.21.3 është i testuar).

Një Issuer i vetë-nënshkruar krijon një certifikatë CA, nexus-local-ca, ECDSA (Elliptic Curve Digital Signature Algorithm) P-256, e vlefshme për dhjetë vjet. Një Issuer i dytë nënshkruan me atë CA. Çdo ngarkesë pune që thërret një server TLS brenda instalimit merr certifikatën e vet të klientit, të quajtur <service-account>-client-tls, e vlefshme për 90 ditë dhe e rinovuar 15 ditë para skadimit. Emri i saj i vetëm është një identifikues uniform i burimeve (URI) në formën e identitetit SPIFFE:

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

Çdo ngarkesë pune gjen certifikatën publike të CA-së si ca.crt në Secret-in e vet të certifikatës. Asnjë pod nuk monton çelësin e CA-së dhe nuk keni nevojë për trust-manager.

Tre shërbime i verifikojnë thirrësit me certifikatë. nexus-auth e bën këtë në dëgjuesin e tij të dytë, porta 8443, dhe çdo thirrës brenda klasterit lidhet me atë. nexus-keys e bën këtë në dëgjuesin e tij të vetëm. Probitas shërben TLS nga certifikata e vet, nexus-probitas-tls, të cilën e rilexon kur cert-manager e rinovon atë. Asnjë nuk i beson një koke (header) X-Forwarded-Client-Cert.

Çdo ngarkesë pune merr gjithashtu tokena njëorësh të Kubernetes në /var/run/secrets/nexus, një për çdo shërbim që thërret, me atë shërbim si audiencë. ConfigMap nexus-service-identities lidh çdo <namespace>/<service-account> me një emër shërbimi ose shtojce, dhe një ngarkesë pune që mungon në të nuk ka identitet dhe refuzohet. Orkestruesi dhe Probitas i kontrollojnë këta tokena me API-n e Kubernetes. Nga shërbimet që ekzekutohen, vetëm ata të dy mbajnë system:auth-delegator ose kanë një token API të montuar; e vetmja ngarkesë tjetër pune me një token është Job-i i kujdestarisë që ekzekutohet gjatë instalimit.

Politika e rrjetit mbyll atë që nuk e mbyll identiteti. Grafiku fillon nga refuzimi i parazgjedhur (default deny), më pas pranon trafikun midis pod-eve të vetë instalimit, DNS (Domain Name System), hapësirës së emrave të kontrolluesit ingress (networkPolicy.ingressNamespace, kube-system si parazgjedhje) drejt tre Services publike, dhe serverit API për dy rishikuesit e tokenave. Pod-et e OpenBao mbajnë një etiketë të ndryshme nga pjesa tjetër e platformës, kështu që rregulli i hapur brenda hapësirës së emrave nuk arrin tek ato: vetëm nexus-keys, Jobs e tij dhe Job-i i kujdestarisë depërtojnë, në portën 8200. Çdo gjë tjetër që një ngarkesë pune duhet të arrijë jashtë hapësirës së emrave, siç është releja juaj e postës elektronike, shkon në networkPolicy.externalEgressCIDRs, e cila është bosh si parazgjedhje.

Migrimet dhe regjistri i skemës

Migrimet ekzekutohen si grepa (hooks) të Helm, në post-install dhe pre-upgrade. Një grep pas-instalimit ekzekutohet pasi të jenë krijuar Deployments e lëshimit. Kështu që në një instalim të parë shërbimet nisen ndërsa skemat e tyre nuk ekzistojnë ende, dhe ato do të hynin në cikël dështimi (crash-loop) përballë një baze të dhënash pa rol, pa fjalëkalim dhe pa tabela. Nexus e shmang këtë me një libër kryesor (ledger).

Grepat ekzekutohen sipas rendit të peshës, dhe Helm pret për çdo Job përpara se të fillojë pesha tjetër:

Pesha Grepi (Hook) Çfarë bën
-30 nexus-migrations-env dhe parakushtet Krijon Secret-in vetëm për grepin me kredencialet e migruesit, dhe gjithçka që lexon Job-i i kujdestarisë
-20 nexus-db-bootstrap Krijon bazat e të dhënave nexus dhe nexus_alpha, rolin e migruesit, rolin e kohës së ekzekutimit (runtime) të çdo shërbimi, zgjerimet dhe librin kryesor
-15 nexus-openbao-custody-init Inicializon depon e çelësave dhe çvulosësin dhe prodhon identitetin e instalimit
-12 nexus-graphrag-migrations Skema e GraphRAG, e cila zotëron objektet të cilave u referohet baza (baseline) e nexus-auth
-10 nexus-auth-migrations Skema e identitetit
-5 migrimet e orkestruesit, gateway-t dhe Probitas Skemat e tyre; Probitas kontrollon fillimisht nëse ekzistojnë tabelat e autentikimit
0 nexus-alpha-bff-migrations Baza e të dhënave e vetë konsolës

Çdo Job migrimi ka backoffLimit: 0, kështu që një migrim i dështuar dështon instalimin.

Libri kryesor është një tabelë e vetme, nexus_release.schema_applied, me një rresht për çdo zinxhir dhe përmbledhje imazhi (image digest). Çdo grep e shkruan rreshtin e tij vetëm pasi të jetë kthyer ekzekutuesi i tij i migrimit. Çdo Deployment që përdor PostgreSQL mban një kontejner init, wait-for-schema, i cili e lexon atë tabelë si një rol që nuk lejohet të lexojë asgjë tjetër (nexus_ledger_reader) dhe pret derisa çdo zinxhir nga i cili varet të tregojë një rresht për imazhin e këtij lëshimi. Më pas shërbimi niset. Punëtori i rrjedhave të punës pret për zinxhirin e orkestruesit, pasi ndan atë bazë të dhënash, dhe motori i aftësive pret vetëm për nisjen (bootstrap).

Ai pyet periodikisht çdo 3 sekonda (schemaWait.intervalSeconds) dhe dorëzohet pas 1,800 sekondash (schemaWait.timeoutSeconds) me një rresht që emërton zinxhirët që ende mungojnë. Kontejneri i vetë shërbimit nuk niset kurrë kundrejt një skeme të gabuar.

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

Kjo është arsyeja pse nuk duhet të ekzekutoni kurrë helm install --wait. Me --wait, Helm pret për Deployments përpara se të ekzekutojë grepat pas-instalimit, dhe Deployments presin për grepat. Asnjëra nuk lëviz. Instaloni pa të dhe prisni më pas; kapitulli 2.6, Instalimi i Community në Kubernetes, jep komandën e saktë.

Izolimi në tri boshte

Çdo lexim, shkrim, thirrje mjeti dhe dërgim aftësie në Nexus është i kufizuar në fushëveprim (scoped) në tre boshte.

Boshti Fusha Çfarë ndan
Qiramarrësi (Tenant) organization_id Një organizatë nga një tjetër, një kufi i fortë
Pronari owner_user_id Gjërat e një personi nga të gjithë të tjerëve, edhe brenda një organizate të vetme
Njësia business_unit_id Një nëndarje e një organizate, opsionale

Boshti i pronarit i befason njerëzit. Një kuti postare ose një bllok shënimesh personal është privat për pronarin e tij edhe ndaj kolegëve në të njëjtën njësi me të njëjtin rol. Një administrator cakton politikat dhe nuk lexon përmbajtjen.

Boshtet vijnë nga kërkesa e autentikuar dhe nga askund tjetër. Asnjë variabël mjedisi, kokë (header), parametër pyetësori (query) ose segment shtegu nuk mund t'i caktojë ato. Një trup kërkese që emërton një organizatë refuzohet me TENANT_NOT_A_PARAMETER. Një sipërfaqe që nuk mund të deklarojë se cilit qiramarrës, pronar dhe njësi i përket një rresht, refuzon me 403 SCOPE_PREDICATE_MISSING, dhe trupi liston se cilat boshte u zgjidhën dhe cilat jo. Ai kurrë nuk bie në një lexim më të gjerë.

Kjo vlen në dy vende njëherësh.

Në bazën e të dhënave. Çdo shërbim lidhet si rolet e veta të kohës së ekzekutimit (runtime): nexus_auth, auth_app dhe auth_platform për shërbimin e identitetit, nexus_probitas dhe nexus_probitas_ledger për Probitas, dhe nexus_gateway, nexus_graphrag, nexus_skills, orchestrator_app, workflows_app dhe pjesa tjetër për të tjerët. Asnjë nuk është superpërdorues ose nuk ka BYPASSRLS. Asnjë nuk zotëron as tabelat që përdor, kështu që çdo politikë e sigurisë në nivel rreshti (RLS) zbatohet për të. Rolet ndajnë një grup, nexus_runtime, që jep të drejtën e lidhjes dhe përdorimit të skemës dhe asnjë të drejtë tabele; çdo shërbimi i jepen tabelat e veta nga migrimet e veta. Cilësimet e qiramarrësit që lexojnë politikat RLS mund të caktohen vetëm përmes funksionit bind_scope të çdo shërbimi, i cili ekzekutohet si pronari i tij. Nisja (bootstrap) revokon set_config nga të gjithë të tjerët, dhe orkestruesi dhe Probitas refuzojnë të nisen nëse roli i tyre i kohës së ekzekutimit mund ta thërrasë atë drejtpërdrejt (Probitas e quan atë DB_ROLE_SETS_SCOPE_DIRECTLY). Të vetmet lidhje superpërdoruesi në të gjithë instalimin i përkasin Job-it të nisjes dhe hapit të provizionimit të BFF-së.

Në primitivin e përbashkët të pyetësorëve me fushëveprim të kufizuar. Çdo depo (repository) në platformë dhe çdo shtojcë e ndërtuar mbi SDK (software development kit) trashëgon një kufizim (fence) që ndërton kallëzuesin SQL nga një fushëveprim i zgjidhur. Funksioni i tij i fushëveprimit merr identitetin e verifikuar dhe nuk ka parametër organizate, kështu që një thirrës nuk mund të kalojë një të tillë, dhe asnjë rrugë nuk mund të përjashtohet.

Ka saktësisht një kalim të kufirit të qiramarrësit, dhe ai është i ngushtë: një autorizim (grant) i regjistruar. Dy persona në organizatën që mban rreshtat regjistrojnë se cila organizatë mund të lexojë cilat tabela, dhe deri kur. Çdo lexim ekzekutohet në një transaksion vetëm për lexim dhe regjistrohet në të dy qiramarrësit. Pronarët dhe administratorët nuk lexojnë kurrë tej kufirit, dhe lexuesi nuk mund ta zgjerojë një autorizim.

Rruga e AI

Thirrësit shprehin dëshira. AI Provider Router zotëron kredencialet dhe bën zgjedhjen përfundimtare.

Çdo thirrje modeli në Nexus kalon përmes rrugëve /internal/ai/* të ruterit, dhe ruteri pranon vetëm thirrës të emërtuar. Grafiku cakton tre lista në gateway:

Rrugët Kush mund të thërrasë
Biseda (Chat) dhe transmetimi i bisedës (chat streaming) nexus-orchestrator, nexus-workflows, nexus-skills-engine
Embeddings dhe rirenditja (rerank) nexus-graphrag, nexus-skills-engine, nexus-workflows
Çdo gjë tjetër, përfshirë ekzekutimin e mjeteve nexus-orchestrator, nexus-workflows

Një thirrje pa identitet thirrësi refuzohet me 403 MISSING_CALLER_IDENTITY, dhe një thirrës që nuk është në listë me 403 UNAUTHORIZED_CALLER. Shtojcat nuk janë në asnjë listë, dhe kjo është e qëllimshme: thirrjet e modeleve të një shtojce ndodhin në emër të saj, përmes dërgimit UNO.

Ajo që një thirrës mund të dërgojë është një dëshirë: një ofrues dhe model i preferuar, plus një profil aftësish siç është një gjatësi minimale konteksti ose përdorimi i mjeteve. Ruteri e respekton një dëshirë vetëm kur organizata e ka atë ofrues të aktivizuar dhe të pajisur me kredenciale; përndryshe ai e zëvendëson, fillimisht brenda të njëjtit ofrues, e më pas midis ofruesve të tjerë të organizatës. Një profil aftësish vetëm filtron, dhe një kërkesë për vendndodhjen e të dhënave (data-residency) në të është e panegociueshme. Kur asgjë nuk përshtatet, nuk ka model rezervë: thirrësi merr 422 MODEL_CAPABILITY_UNAVAILABLE ose 422 NO_PROVIDER_FOR_ROLE, me një varg korrigjimi që konsola ia tregon një administratori.

Çelësat i përkasin organizatës. Administratorët e çdo organizate vendosin çelësat e tyre të ofruesve në grupin e saj nga konsola, dhe ruteri i zgjidh ata në momentin e thirrjes. Asnjë çelës modeli nuk është vlerë e grafikut dhe asnjë nuk vjen i paracaktuar me Nexus. Një organizatë pa çelës nuk merr përgjigje nga AI, dhe konsola e thotë këtë qartë; asgjë nuk e mbush boshllëkun nga diku tjetër.

Dy vlera të chart-it formësojnë ruterin. ai.localProvider.baseUrl emërton një server modelesh të përputhshëm me OpenAI që ju e operoni, i cili drejtohet si çdo ofrues tjetër. ai.installationHosts rendit serverët tuaj të modeleve me emra privatë, të cilët ruteri i llogarit si brenda instalimit. GraphRAG gjithashtu krijon embedding-e përmes ruterit, në emër të organizatës së cilës i përket përmbajtja. Modeli i parazgjedhur i embedding-ut ekzekutohet në klaster pa kartë grafike; embedding-et e hostuara janë zgjedhje e secilës organizatë.

Pa telemetri

Asgjë nuk del nga një instalim nëse nuk e dërgoni ju. Vlera telemetry.enabled e chart-it mund të jetë vetëm false; skema refuzon çdo gjë tjetër. Raportimi i vetë shtresës së të dhënave është gjithashtu i çaktivizuar: raporti i përdorimit të Neo4j dhe telemetria e Qdrant janë të çaktivizuara në chart.

Me networkPolicy.enabled të aktivizuar, që është parazgjedhja, asnjë pod nuk mund të lidhet me internetin përveç nëse e rendisni destinacionin te networkPolicy.externalEgressCIDRs. Një ofrues i modeleve të hostuara është një destinacion i tillë, siç është edhe stafetuesi juaj i postës (mail relay).

I njëjti rregull ndryshoi një parazgjedhje që do ta vini re. CAPTCHA e nexus-auth për regjistrimet kërkon një shërbim interneti, ndaj në një instalim ajo është e çaktivizuar, dhe regjistrimi i një të panjohuri pret miratimin e një administratori (403 SIGNUP_REQUIRES_APPROVAL). Filtri që bllokon regjistrimet nga rrjetet e hostimit është gjithashtu i çaktivizuar, sepse kërkon baza të dhënash të licencuara që Nexus nuk i përfshin. Ju e humbisni atë filtrim.

Si po funksionon instalimi
Si po funksionon instalimi
Në Enterprise, faqja e gjendjes tregon klasterin nën Nexus: sa e ngarkuar është secila pjesë dhe sa kapacitet ka mbetur, me secilin paralajmërim pranë veprimit që duhet ndërmarrë për të.