Versioon 1.0.0-alpha.1uusim
Peatükk 2.1
Arhitektuur
Mida iga teenus Nexuse chartis omab ja millised andmehoidlad selle all asuvad, seejärel reeglid, mis neid koos hoiavad, alates teenustevahelisest identiteedist kuni teekonnani, mille iga mudelipäring läbib.
Selle lehe tõlkis AI ingliskeelsest originaalist. Kui miski jääb ebaselgeks, võtke aluseks ingliskeelne leht. Lugege seda lehte inglise keeles

Kui Tomás Reilly lõpetas esimese paigalduse Harrow Port Authoritys, kuvas kubectl -n nexus get pods kümme Deploymenti ja seitse StatefulSeti ning lisaks kolm CronJobi. Andmebaasi ehitanud migratsiooni Jobid olid juba kadunud, sest igaüks neist kustutab end eduka lõpetamise korral ise. See loend ongi kogu platvorm. Jätke see meelde, sest enamik igapäevase töö käigus tekkivaid küsimusi algab küsimusega „milline neist seda haldab?“
Käesolev peatükk vastab sellele iga komponendi kohta, jälgib ühe päringu teekonda läbi nende ning käsitleb seejärel reegleid, mida need kõik järgivad. Ülejäänud 2. osa tugineb sellele tervikpildile.
Teenused ja mida igaüks neist omab
Paigalduspakett on üks Helmi chart nexus, versioon 1.0.0-alpha.1, mis on mõeldud Kubernetese versioonile 1.33 või uuemale. Iga töökoormus töötab omaenda ServiceAccounti all mitte-juurkasutajana, kusjuures kõik Linuxi õigused (capabilities) on eemaldatud. Pöördumised identiteeti ja võtmeid kaitsvate teenuste poole toimuvad üle vastastikuse TLS-i (Transport Layer Security) ning avalik API (rakendusliides) jagab protsessi AI (tehisintellekti) ruuteriga.
| Komponent | Deployment ja Service | Service'i port | Mida see haldab |
|---|---|---|---|
| Konsool | nexus-alpha |
3000 | Lehed, mida kasutajad näevad; serveerib konsooli hostis HTML-i (Hypertext Markup Language) |
| BFF (taustasüsteem esiliidese jaoks) | nexus-alpha-bff |
8080 | Konsooli enda andmed, igale kasutajale kuvatav menüü, väljalaskeregister |
| Autentimine | nexus-auth |
9101 (vastastikune TLS pordil 8443) | Inimesed, organisatsioonid, seansid, lubamärgid (tokenid), API võtmed, organisatsiooni mudelivõtmete kogum |
| Lüüs (Gateway) | nexus-gateway |
9092, WebSocket 8093 | AI Provider Router ning avalik API servapunkt REST-i (representational state transfer) ja MCP (Model Context Protocol) jaoks |
| Orkestraator | nexus-orchestrator |
8080 | UNO tööde jaotamine: iga töö vastuvõtmine ja järjekorda suunamine |
| Töövood (Workflows) | nexus-workflows |
8081 | UNO täitmine: tööline (worker), mis käivitab järjekorras olevaid töid |
| GraphRAG | nexus-graphrag |
8090, WebSocket 8091 | Mälu: teadmusgraaf ja päringud sellelt |
| Probitas | nexus-probitas |
9151 (HTTPS) | Tõendusmaterjal: halduskirjed ja pitseeritud pearaamat |
| Oskuste mootor (Skills engine) | nexus-skills-engine |
8095 | Oskuste teek; oskuste leidmine ja käivitamine |
| Võtmed (Keys) | nexus-keys |
8080 (HTTPS, vastastikune TLS) | Organisatsioonipõhised võtmed OpenBaos, võtmehoid, paigalduse identiteet |
| Pluginad | nexus-plugins |
9111 | Pluginate register ja kataloogikirjed; vaikimisi välja lülitatud |
| Failitöötlus | nexus-fileprocess |
9109 | Üleslaaditud dokumentide ja piltide lugemine; vaikimisi välja lülitatud |
Esimesed kümme on kohustuslikud. Viimased kaks on valikulised ning need lülitatakse sisse võtmetega components.plugins.enabled ja components.fileprocess.enabled, kui Enterprise'i paigaldus või valdkonnapakett neid kasutab. Veel ühel valikulisel teenusel, nexus-alive pordil 8080, on oma lüliti components.alive.enabled ja ka see on vaikimisi välja lülitatud. Iga teenuse replikad ja ressursid asuvad jaotises components.<name>.
Konsool koosneb serveris renderdatavatest lehtedest ja sel puudub oma andmebaas. See suhtleb BFF-iga ja klastri sees teenusega nexus-auth, käimata kunagi väljas läbi avaliku authi hosti ja sealt tagasi sisse. See keeldub käivitumast ilma oma väljaandeta (edition), mille chart edastab muutujana NEXUS_EDITION ühestainsast edition väärtusest. Iga organisatsiooni liige töötab selles vastavalt oma rollile. Halduslehed on mõeldud omanikele ja administraatoritele ning tavaline liige, kes mõne neist avab, näeb lehte „Not an administrator“.
BFF on konsooli serveripoolne osa, mis on ehitatud platvormi pluginana ja registreeritud tootena Nexus Alpha. See hoiab konsooli enda tabeleid eraldi andmebaasis nexus_alpha ning otsustab, milliseid menüürühmi kasutaja näeb. Kui konsoolil on vaja mõni töö ära teha, pöördub BFF teenuse poole, mis seda valdkonda haldab.
nexus-auth on kirjutatud Go keeles ja on ainus teenus, mis vermib lubamärke (tokeneid). Juurdepääsulubamärgid kehtivad vaikimisi 15 minutit ja värskenduslubamärgid 12 tundi (auth.accessTokenTTL, auth.refreshTokenTTL). Teenus piirab iga sisseloginud kasutaja päringute arvu 5,000 päringuni minutis, enne kui vastab veakoodiga 429 (auth.rateLimitPerMinute). Sellel töötab kaks kuulajat: tavaline konteineri pordil 8080, kuhu suunab liikluse avalik Ingress, ja vastastikuse TLS-iga kuulaja pordil 8443, mida peab kasutama iga klastrisisene pöörduja. Teenus usaldab päist X-Forwarded-For ainult nendelt vahepunktidelt, mis on loetletud parameetris proxy.trustedCIDRs – see on Classless Inter-Domain Routingu (CIDR) vahemike loend, mille vaikeväärtus on k3s-i podide võrk 10.42.0.0/16. Kui teie ingressi kontroller töötab mujal, muutke seda. Vastasel juhul paistab iga sisselogimine nii, nagu see pärineks kontrollerilt.
Lüüsil (gateway) on kaks ülesannet, mis jagavad ühte protsessi. Klastri sees on see AI Provider Router (1. osas ja konsooli lehtedel nimetatud kui AI kommutaator), mis on organisatsiooni mudelimandaatide ainus hoidja (sellest lähemalt allpool). Võrgu serval on see teenus, kuhu api.<domain> välja jõuab: REST-i kliendid ja MCP kliendid, mille lubamärgid kannavad sihtrühma (audience) https://<hosts.api>/mcp ja pärinevad authi hostis asuvast OAuth 2.1 autoriseerimiserverist (OAuth on delegeeritud autoriseerimise avatud standard).
Orkestraator ja töövood moodustavad koos töövoomootori UNO. Kogu arvutustöö käib läbi nende. Orkestraator võtab töö vastu asukohas POST /api/v1/dispatch, vastab koodiga 202 koos väärtustega jobId, runId ja traceId ning paneb töö järjekorda. Otsest (inline) täitmisteed ei ole: klient küsitleb alati aadressi GET /api/v1/dispatch/{jobId} või kasutab tagasihelistamist (callback). Töövoogude tööline (worker) võtab töid järjekorrast vaikimisi neli tükki korraga iga replika kohta (workflows.concurrency) ja sel on täpselt üks HTTP marsruut: GET /health.
Probitas on tõendusmaterjali teenus. See teenindab TLS-i ise, kasutades charti väljastatud sertifikaati, ning hoiab oma tabeleid skeemis trust koos eraldi rolliga pearaamatu jaoks. Selle haldusfunktsioone lülitatakse parameetriga probitas.flags. Mitmed neist tarnitakse režiimis shadow: otsus arvutatakse ja salvestatakse, kuid midagi ei blokeerita enne, kui te lipu väärtust muudate.
nexus-keys on Go keeles kirjutatud platvormi võtmeteenus. See hoiab OpenBao võtmehoidlas iga organisatsiooni jaoks eraldi võtit ja roteerib neid igal ööl. Selle öised tööd hävitavad ka võtmed, mille säilitustähtaeg on kätte jõudnud, ja ekspordivad selle kviitungid teenuse enda andmemahule (volume). Organisatsiooni võtme kustutamine muudab selle abil lukustatud andmed jäädavalt loetamatuks. Samuti vermib see esmasel alglaadimisel (bootstrap) parameetri keys.installationName all paigalduse identiteedi ja see nimi on püsiv. Valige see hoolikalt: chart keeldub tühjast nimest (INSTALLATION_NAME_MISSING) ja keeldub ka omaenda näidisväärtustes olevast nimest (INSTALLATION_NAME_EXAMPLE).
Kolm avalikku hosti
Chart avaldab täpselt kolm hostinime, mis moodustavad koos paigalduse identiteedi. Kõik teenused keelduvad ilma nendeta käivitumast.
| Ingress | Hosti väärtus | Taustateenus (Backend) |
|---|---|---|
nexus-console |
hosts.console |
nexus-alpha, port 3000 |
nexus-api |
hosts.api |
nexus-gateway, port 9092 |
nexus-auth |
hosts.auth |
nexus-auth, port 9101 |
Selle raamatu näidetes on kasutusel console.harrow.example, api.harrow.example ja auth.harrow.example. Ingressid on tavalised networking.k8s.io/v1 objektid, millel igaühel on üks reegel ja asukoht (path) /. TLS võrgu serval järgib parameetrit tls.mode: existing (teie loodud Secret, mis on nimetatud parameetris tls.existingSecret), cert-manager (teie käitatav ClusterIssuer, mis on nimetatud parameetris tls.clusterIssuer) või none (TLS lõpeb klastri ees). Chart ei lisa omalt poolt ühtegi ümbersuunamist, nii et ACME (Automated Certificate Management Environment) HTTP kontrollpäring jõuab teie lahendajani muutmata kujul. Peatükk 2.11, Variatsioonid: välised hoidlad, TLS ja ingress, käsitleb kõiki neid režiime.
Midagi muud väljapoole ei avata. Andmehoidlad, OpenBao ja kõik sisemised teenused kuulavad ainult nimeruumi sees.
Päring, algusest lõpuni
Järgnevalt on kirjeldatud, mis juhtub siis, kui Harrow' IT-juht Aoife Brennan avab konsooli ja esitab assistendile küsimuse selle kuu sildumisgraafiku kohta.
- Tema brauser laadib aadressi
https://console.harrow.example.nexus-consoleIngress saadab selle pordil 3000 teenuselenexus-alpha. - Ta logib sisse oma pääsuvõtmega (passkey). Sisselogimislehed suhtlevad aadressiga
nexus-authläbiauth.harrow.examplening nexus-auth vermib talle juurdepääsulubamärgi, mis sisaldab tema kasutajat, organisatsiooni ja – kui tema seansil see on – ka tema äriüksust. - Konsooli server pöördub BFF-i poole, mis kontrollib tema lubamärki ja küsib teenuselt nexus-auth, kas tema organisatsioonil on see toode olemas ja kas tema roll on lubatud. Teenus vastab menüürühmadega, mida kasutaja tohib näha.
- Tema küsimus liigub BFF-ist orkestraatori tööde jaotamise marsruudile koos tema organisatsiooni ja kasutajaga, mis on võetud kontrollitud lubamärgist. Orkestraator vastab koodiga 202 ja paneb töö Valkeys asuvasse järjekorda.
- Töövoogude tööline (worker) võtab töö ette. Käivitatava oskuse lahendab oskuste mootor ning infootsing Harrow' dokumentidest suunatakse GraphRAG-ile, mis loeb Neo4j-d, Qdranti ja oma PostgreSQL-i skeemi.
- Mudelipäring läheb AI Provider Routerile aadressil
/internal/ai/chat. Ruuter valib Harrow' enda võtmekogumist ja marsruutimispoliitikast pakkuja ning mudeli, teeb Harrow' võtmega päringu ja tagastab tulemuse. - Tulemus jõuab töö käitusreale. BFF loeb selle sisse ja konsool kuvab vastuse koos viidetega.
Teenustevahelised pöördumised kannavad projitseeritud teenuselubamärke, ühendused teenustesse nexus-auth, nexus-keys ja Probitas toimuvad üle TLS-i, mis kasutab paigalduse enda sertifitseerimiskeskust, ning iga andmepöördus sammudes 4 kuni 6 on andmebaasis endas piiratud Harrow' organisatsiooniga. Allolevad jaotised selgitavad mõlemat põhimõtet.
Andmekiht
Nexus tarnib igast hoidlast omaenda allkirjastatud koopia ning komplektis on kaasas ka igaühe lähtekoodi pakkumine. Iga hoidla valiti nii selle litsentsi kui ka funktsionaalsuse järgi.
| Hoidla | Versioon | Litsents | Miks see seal on | Sadam | Vaikimisi andmemaht |
|---|---|---|---|---|---|
| PostgreSQL koos PostGIS-i ja pgvectoriga | PostgreSQL 16, PostGIS 3, pgvector 0.8 | PostgreSQL-i litsents; PostGIS GPL-2.0-or-later | Põhiandmehoidla iga teenuse jaoks; PostGIS kaardiandmete jaoks; pgvector ridade kõrval hoitavate vektorite jaoks | 5432 | 50 GiB |
| Valkey | 8.1 | BSD-3-Clause | UNO tööjärjekorrad ja lühiajalised vahemälud, näiteks teenuse nexus-auth API võtmete vahemälu | 6379 | 5 GiB |
| Neo4j Community Edition | 5.26 | GPL-3.0 | Teadmusgraaf, mida GraphRAG ehitab ja läbib | 7687 (Bolt) | 20 GiB |
| Qdrant | 1.15 | Apache-2.0 | Vektorotsing GraphRAG-i ja oskuste mootori jaoks | 6333 (HTTP), 6334 (gRPC kaugprotseduurikutsed) | 10 GiB |
| SeaweedFS | 4.48 | Apache-2.0 | Objektihoidla failide jaoks, ühildub teenusega Amazon Simple Storage Service (S3) | 8333 | 50 GiB |
| OpenBao | 2.6 | MPL-2.0 | Võtmehoidla ja selle lahtipitseerija teenuse nexus-keys jaoks | 8200 | 5 GiB ja 1 GiB |
Mõned valikud asendasid midagi tuttavamat. Valkey asendab Redis 7.4, mille praegustest litsentsidest käesolev väljalase keeldub. MinIO on AGPL-3.0 litsentsiga, mistõttu on objektihoidlaks SeaweedFS. GraphRAG suhtleb Neo4j Community Editioniga üle võrguprotokolli Bolt ja teenused suhtlevad PostGIS-iga üle PostgreSQL-i protokolli, nii et GPL-litsents jääb nende endi piiridesse. OpenBao on Linux Foundationi haru (fork) Vaultist, mis loodi enne Vaulti litsentsimuudatust.
Kõik hoidlad töötavad sisselülitatud autentimise ja genereeritud mandaatidega: parool Valkey jaoks, API võti Qdranti jaoks ja juurdepääsuvõtmed SeaweedFS-i jaoks.
Igaüks viiest parameetri dataTier all olevast hoidlast töötab kas klastris (mode: in-cluster, vaikeväärtus) või on hoidla, mida te juba ise haldate (mode: external koos parameetriga external.host ja Secretiga, millele viitab external.existingSecret). Välise PostgreSQL-i puhul määrake sslmode väärtuseks verify-full või verify-ca ja pange serveri sertifitseerimiskeskuse (CA) sertifikaat sellesse Secretisse; peatükk 2.11, Variatsioonid: välised hoidlad, TLS ja ingress, sisaldab üksikasju.
# 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-postgresOpenBao paar on erand: see töötab alati paigalduse sees, sest võtmehoiu Job initsialiseerib selle seal.
Teenustevaheline identiteet
Nexus töötab ilma teenusevõrguta (service mesh). Vastastikune TLS pärineb kohalikust sertifitseerimiskeskusest (CA), mille chart loob läbi cert-manageri, mis peab olema eelnevalt paigaldatud (testitud on versiooni v1.21.3).
Iseallkirjastatud Issuer loob ühe CA sertifikaadi nexus-local-ca, ECDSA (Elliptic Curve Digital Signature Algorithm) P-256, kehtivusega kümme aastat. Teine Issuer allkirjastab selle CA-ga. Iga töökoormus, mis pöördub paigalduse sees TLS-serveri poole, saab omaenda kliendisertifikaadi nimega <service-account>-client-tls, mis kehtib 90 päeva ja mida uuendatakse 15 päeva enne aegumist. Selle ainus nimi on ühtne ressursiidentifikaator (URI) SPIFFE identiteedi kujul:
spiffe://cluster.local/ns/<namespace>/sa/<service-account>
Iga töökoormus leiab CA avaliku sertifikaadi nimega ca.crt omaenda sertifikaadi Secretist. Ükski pod ei haagi (mount) CA võtit ja te ei vaja trust-manageri.
Kolm teenust kontrollivad pöördujaid sertifikaadi alusel. nexus-auth teeb seda oma teisel kuulajal, pordil 8443, ja iga klastrisisene pöörduja helistab sellele pordile. nexus-keys teeb seda oma ainsal kuulajal. Probitas teenindab TLS-i omaenda sertifikaadilt nexus-probitas-tls, mille see uuesti sisse loeb, kui cert-manager seda uuendab. Ükski neist ei usalda päist X-Forwarded-Client-Cert.
Iga töökoormus saab asukohta /var/run/secrets/nexus ka ühetunnised Kubernetese lubamärgid – ühe iga teenuse kohta, mille poole see pöördub, kusjuures sihtrühmaks (audience) on seesama teenus. ConfigMap nexus-service-identities seob iga <namespace>/<service-account> teenuse või plugina nimega ning töökoormusel, mis sealt puudub, pole identiteeti ja see lükatakse tagasi. Orkestraator ja Probitas kontrollivad neid lubamärke Kubernetese API abil. Töötavatest teenustest on ainult neil kahel määratud system:auth-delegator või haagitud API lubamärk; ainus teine lubamärgiga töökoormus on paigaldamisel käivituv võtmehoiu Job.
Võrgupoliitika sulgeb selle, mida identiteet ei sulge. Chart alustab vaikimisi keelamisest (default deny), seejärel lubab liikluse paigalduse enda podide vahel, DNS-i (Domain Name System), liikluse ingressi kontrolleri nimeruumist (networkPolicy.ingressNamespace, vaikimisi kube-system) kolme avaliku Service'ini ning API serveri kahe lubamärgikontrollija jaoks. OpenBao podidel on ülejäänud platvormist erinev silt (label), nii et avatud nimeruumisisene reegel nendeni ei ulatu: läbi pääsevad ainult nexus-keys, selle Jobid ja võtmehoiu Job pordil 8200. Kõik muu, milleni töökoormus peab väljaspool nimeruumi jõudma – näiteks teie meilirelee –, läheb parameetrisse networkPolicy.externalEgressCIDRs, mis on vaikimisi tühi.
Migratsioonid ja skeemiraamat
Migratsioonid töötavad Helmi haakidena (hooks) sündmustel post-install ja pre-upgrade. Paigaldusjärgne (post-install) haak käivitub pärast seda, kui väljalaske Deploymentid on loodud. Seega käivituvad teenused esmasel paigaldamisel ajal, mil nende skeeme pole veel olemas, ning need satuksid lõputusse krahhi- ja taaskäivitustsüklisse (crash-loop) vastu andmebaasi, kus pole rolli, parooli ega tabeleid. Nexus väldib seda pearaamatu abil.
Haagid käivituvad kaalu (weight) järjekorras ja Helm ootab iga Jobi lõppemist, enne kui järgmise kaaluga etapp algab:
| Kaal | Haak | Mida see teeb |
|---|---|---|
| -30 | nexus-migrations-env ja eeldused |
Loob ainult haakidele mõeldud Secreti migreerija mandaatidega ja kõik, mida võtmehoiu Job loeb |
| -20 | nexus-db-bootstrap |
Loob andmebaasid nexus ja nexus_alpha, migreerija rolli, iga teenuse käitusaja rolli, laiendused ja pearaamatu |
| -15 | nexus-openbao-custody-init |
Initsialiseerib võtmehoidla ja lahtipitseerija ning vermib paigalduse identiteedi |
| -12 | nexus-graphrag-migrations |
GraphRAG-i skeem, mis haldab objekte, millele teenuse nexus-auth baastase viitab |
| -10 | nexus-auth-migrations |
Identiteediskeem |
| -5 | orkestraatori, lüüsi ja Probitase migratsioonid | Nende skeemid; Probitas kontrollib esmalt, kas authi tabelid on olemas |
| 0 | nexus-alpha-bff-migrations |
Konsooli enda andmebaas |
Igal migratsiooni Jobil on backoffLimit: 0, nii et ebaõnnestunud migratsioon nurjab kogu paigalduse.
Pearaamat on üks tabel nexus_release.schema_applied, kus on rida iga ahela ja tõmmise räsi (image digest) kohta. Iga haak kirjutab oma rea alles pärast seda, kui selle migratsioonikäivitaja on töö lõpetanud. Igal PostgreSQL-i kasutaval Deploymentil on initsialiseerimiskonteiner (init container) wait-for-schema, mis loeb seda tabelit rollina, millel pole lubatud lugeda midagi muud (nexus_ledger_reader), ja ootab, kuni iga ahel, millest see sõltub, näitab rida käesoleva väljalaske tõmmise kohta. Seejärel teenus käivitub. Töövoogude tööline ootab orkestraatori ahelat, kuna see jagab sama andmebaasi, ning oskuste mootor ootab ainult alglaadimist.
See küsitleb tabelit iga 3 sekundi järel (schemaWait.intervalSeconds) ja loobub 1800 sekundi pärast (schemaWait.timeoutSeconds), väljastades rea, mis nimetab endiselt puuduvad ahelad. Teenuse enda konteiner ei käivitu kunagi vale skeemi vastu.
kubectl -n nexus logs deploy/nexus-gateway -c wait-for-schemaSeetõttu ei tohi te kunagi käivitada käsku helm install --wait. Võtmega --wait ootab Helm Deploymentide valmimist, enne kui käivitab paigaldusjärgsed haagid, ja Deploymentid omakorda ootavad haake. Kumbki ei liigu paigast. Paigaldage ilma selle võtmeta ja oodake pärast; peatükk 2.6, Community paigaldamine Kubernetesele, annab täpse käsu.
Isolatsioon kolmel teljel
Iga lugemine, kirjutamine, tööriistakutse ja oskuse käivitamine Nexuses on piiritletud kolmel teljel.
| Telg | Väli | Mida see eraldab |
|---|---|---|
| Üürnik (Tenant) | organization_id |
Ühe organisatsiooni teisest, range piir |
| Omanik | owner_user_id |
Ühe inimese asjad kõigi teiste omadest, isegi ühe organisatsiooni sees |
| Üksus | business_unit_id |
Organisatsiooni allüksus, valikuline |
Omaniku telg üllatab inimesi. Postkast või isiklik märkmik on selle omaniku jaoks privaatne isegi sama üksuse ja sama rolliga kolleegide eest. Administraator määrab poliitika ega loe sisu.
Teljed pärinevad autenditud päringust ja mitte kusagilt mujalt. Ükski keskkonnamuutuja, päis, päringuparameeter ega asukohasegment ei saa neid määrata. Päringu keha, mis nimetab organisatsiooni, lükatakse tagasi veaga TENANT_NOT_A_PARAMETER. Liidesepind, mis ei suuda öelda, millisele üürnikule, omanikule ja üksusele rida kuulub, keeldub koodiga 403 SCOPE_PREDICATE_MISSING ning vastuse kehas loetletakse, millised teljed lahendati ja millised mitte. Süsteem ei lange kunagi tagasi laiema lugemisõiguse peale.
See kehtib korraga kahes kohas.
Andmebaasis. Iga teenus loob ühenduse omaenda käitusaja rollina: nexus_auth, auth_app ja auth_platform identiteediteenuse jaoks, nexus_probitas ja nexus_probitas_ledger Probitase jaoks ning nexus_gateway, nexus_graphrag, nexus_skills, orchestrator_app, workflows_app ja ülejäänud teiste teenuste jaoks. Ükski neist pole superkasutaja ega oma õigust BYPASSRLS. Samuti ei oma ükski neist tabeleid, mida ta kasutab, mistõttu kehtib neile iga reataseme turvalisuse (RLS) poliitika. Rollid jagavad rühma nexus_runtime, mis annab ühenduse ja skeemi kasutamise õiguse, kuid mitte ühtegi tabeliõigust; igale teenusele antakse õigused tema enda tabelitele tema enda migratsioonide käigus. Üürniku sätteid, mida RLS-i poliitikad loevad, saab määrata ainult läbi iga teenuse funktsiooni bind_scope, mis töötab selle omaniku õigustes. Alglaadimine tühistab kõigilt teistelt õiguse set_config ning orkestraator ja Probitas keelduvad käivitumast, kui nende käitusaja roll saaks seda otse välja kutsuda (Probitas nimetab seda veaks DB_ROLE_SETS_SCOPE_DIRECTLY). Ainsad superkasutaja ühendused kogu paigalduses kuuluvad alglaadimise Jobile ja BFF-i ettevalmistusetapile (provisioning).
Jagatud piiritletud päringu primitiivis. Iga platvormi hoidla (repository) ja iga SDK-le (tarkvaraarenduskomplektile) ehitatud plugin pärib ühe piirde, mis koostab lahendatud skoobist SQL-i predikaadi. Selle skoobifunktsioon võtab sisendiks kontrollitud identiteedi ja sel puudub organisatsiooni parameeter, mistõttu pöörduja ei saa seda ette anda ja ükski marsruut ei saa sellest kõrvale hiilida.
Üürniku piiri ületamiseks on täpselt üks viis ja see on kitsas: salvestatud luba (grant). Kaks inimest ridu omavas organisatsioonis panevad kirja, milline organisatsioon tohib milliseid tabeleid lugeda ja mis ajani. Iga lugemine toimub kirjutuskaitstud (read-only) transaktsioonis ja logitakse mõlemas üürnikus. Omanikud ja administraatorid ei loe kunagi üle piiri ning lugeja ei saa luba laiendada.
AI teekond
Pöördujad avaldavad soove. AI Provider Router omab mandaati ja teeb lõpliku valiku.
Iga mudelipäring Nexuses käib läbi ruuteri /internal/ai/* marsruutide ja ruuter laseb läbi ainult nimetatud pöördujaid. Chart määrab lüüsis kolm loendit:
| Marsruudid | Kes tohib pöörduda |
|---|---|
| Vestlus ja vestluse voogedastus | nexus-orchestrator, nexus-workflows, nexus-skills-engine |
| Manused (embeddings) ja ümberjärjestamine (rerank) | nexus-graphrag, nexus-skills-engine, nexus-workflows |
| Kõik muu, sealhulgas tööriistade käivitamine | nexus-orchestrator, nexus-workflows |
Ilma pöörduja identiteedita päring lükatakse tagasi koodiga 403 MISSING_CALLER_IDENTITY ja loendisse mittekuuluv pöörduja koodiga 403 UNAUTHORIZED_CALLER. Pluginaid pole üheski loendis ja see on taotluslik: plugina mudelipäringud tehakse tema nimel läbi UNO tööde jaotuse.
See, mida pöörduja võib saata, on soov: eelistatud pakkuja ja mudel koos võimekuse profiiliga, nagu näiteks minimaalne kontekstipikkus või tööriistakasutus. Ruuter täidab soovi ainult siis, kui organisatsioonil on see pakkuja lubatud ja mandaadiga varustatud; vastasel juhul asendab ta selle, esmalt sama pakkuja piires ja seejärel organisatsiooni teiste pakkujate seast. Võimekuse profiil ainult filtreerib ja selles sisalduv andmete asukoha (data-residency) nõue on range. Kui miski ei sobi, siis varumudelit ei ole: pöörduja saab vastuseks 422 MODEL_CAPABILITY_UNAVAILABLE või 422 NO_PROVIDER_FOR_ROLE koos parandusjuhise stringiga, mida konsool kuvab administraatorile.
Võtmed kuuluvad organisatsioonile. Iga organisatsiooni administraatorid panevad oma pakkujate võtmed konsooli kaudu organisatsiooni võtmekogumisse ja ruuter lahendab need päringu hetkel. Ükski mudelivõti ei ole charti väärtus ja ühtegi võtit Nexusega kaasa ei tarnita. Ilma võtmeta organisatsioon ei saa ühtegi AI vastust ja konsool ütleb seda selgelt; miski ei täida seda tühimikku kusagilt mujalt.
Ruuterit kujundavad kaks Helm charti väärtust. ai.localProvider.baseUrl nimetab teie käitatavat OpenAI-ga ühilduvat mudeliserverit, mida suunatakse nagu iga teist pakkujat. ai.installationHosts loetleb teie mudeliserverid privaatsetel nimedel, mida ruuter käsitleb paigaldussisesena. GraphRAG teostab manustamist samuti ruuteri kaudu, tegutsedes selle organisatsioonina, kelle sisuga on tegu. Vaikimisi manustamismudel töötab klastris ilma graafikakaardita; majutatud manustused on iga organisatsiooni enda valik.
Telemeetria puudub
Miski ei lahku paigaldusest, kui te seda ise ei saada. Helm charti telemetry.enabled väärtus saab olla ainult false; skeem keeldub kõigest muust. Andmekihi enda aruandlus on samuti välja lülitatud: Neo4j kasutusaruanne ja Qdranti telemeetria on Helm chartis keelatud.
Kui networkPolicy.enabled on sisse lülitatud (vaikeväärtus), ei pääse ükski pod internetti, välja arvatud juhul, kui loetlete sihtkoha loendis networkPolicy.externalEgressCIDRs. Majutatud mudelipakkuja on üks selline sihtkoht ja sama on teie meilirelee.
Sama reegel muutis ühte vaikeväärtust, mida te märkate. Teenuse nexus-auth CAPTCHA registreerumiste jaoks vajab internetiteenust, mistõttu on see paigalduses välja lülitatud ning võõra kasutaja registreerumine jääb ootama administraatori kinnitust (403 SIGNUP_REQUIRES_APPROVAL). Filter, mis blokeerib registreerumisi majutusvõrkudest, on samuti välja lülitatud, kuna see vajab litsentsitud andmebaase, mida Nexus kaasa ei pane. Te kaotate selle eelkontrolli.

