Útgáfa 1.0.0-alpha.1nýjast
Kafli 2.1
Kerfishönnun
Hvað hver þjónusta í Nexus-kortinu á og hvaða gagnageymslur liggja undir henni, og síðan reglurnar sem halda þeim saman, allt frá auðkenningu milli þjónusta til leiðarinnar sem hvert líkanakall fer.
Þessi síða var þýdd með gervigreind úr enska frumtextanum. Ef eitthvað er óljóst gildir enska síðan til viðmiðunar. Lesa þessa síðu á ensku

Þegar Tomás Reilly lauk fyrstu uppsetningunni hjá Harrow Port Authority sýndi kubectl -n nexus get pods tíu Deployments og sjö StatefulSets, auk þriggja CronJobs. Flutningsverkin (migration Jobs) sem byggðu gagnagrunninn voru þegar horfin, því hvert þeirra eyðir sjálfu sér þegar það heppnast. Þessi listi er allt kerfið. Lærið hann, því flestar spurningar eftir uppsetningu byrja á „hvert þessara á þetta?“
Þessi kafli svarar því fyrir hverja einingu, fylgir einni beiðni í gegnum þær og fjallar síðan um reglurnar sem þær hlíta allar. Afgangurinn af 2. hluta byggir á þessari mynd.
Þjónusturnar og hvað hver þeirra á
Uppsetningarpakkinn er eitt Helm-kort (chart), nexus, útgáfa 1.0.0-alpha.1, fyrir Kubernetes 1.33 eða nýrra. Hvert vinnsluálag (workload) keyrir undir sínu eigin ServiceAccount, sem almennur notandi (non-root), þar sem öllum Linux-heimildum (capabilities) hefur verið sleppt. Köll í þær þjónustur sem vernda auðkenni og lykla fara fram yfir gagnkvæmt TLS (Transport Layer Security), og opinbera forritaskilin (API, application programming interface) deila ferli með beini (router) fyrir gervigreind (AI).
| Eining | Deployment og Service | Þjónustugátt | Hvað hún á |
|---|---|---|---|
| Stjórnborð (Console) | nexus-alpha |
3000 | Síðurnar sem fólk sér; birtir HTML (Hypertext Markup Language) á hýsilvélinni fyrir stjórnborðið |
| BFF (bakendi fyrir framenda) | nexus-alpha-bff |
8080 | Eigin gögn stjórnborðsins, valmyndin sem hver notandi fær, útgáfuskráin |
| Auth | nexus-auth |
9101 (gagnkvæmt TLS á 8443) | Fólk, stofnanir, lotur, tókar, API-lyklar, safn líkanalykla stofnunarinnar |
| Gátt (Gateway) | nexus-gateway |
9092, WebSocket 8093 | Gervigreindarbeinirinn (AI Provider Router), og opinberi API-jaðarinn fyrir REST (representational state transfer) og MCP (Model Context Protocol) |
| Samhæfari (Orchestrator) | nexus-orchestrator |
8080 | UNO-afgreiðsla: tekur við hverju verki og setur það í biðröð |
| Verkferlar (Workflows) | nexus-workflows |
8081 | UNO-keyrsla: þjónninn (worker) sem keyrir verk í biðröð |
| GraphRAG | nexus-graphrag |
8090, WebSocket 8091 | Minni: þekkingarnetið og uppfletting í því |
| Probitas | nexus-probitas |
9151 (HTTPS) | Sönnunargögn: stjórnarháttaskrár og innsiglaða færslubókin (ledger) |
| Færnivél (Skills engine) | nexus-skills-engine |
8095 | Færnisafnið; að finna og keyra færniþætti (skills) |
| Lyklar (Keys) | nexus-keys |
8080 (HTTPS, gagnkvæmt TLS) | Lyklar fyrir hverja stofnun í OpenBao, varsla, auðkenni uppsetningarinnar |
| Viðbætur (Plugins) | nexus-plugins |
9111 | Viðbótaskráin og vörulistaupplýsingar; sjálfgefið óvirkt |
| Skráavinnsla | nexus-fileprocess |
9109 | Lestur innsendra skjala og mynda; sjálfgefið óvirkt |
Fyrstu tíu eru nauðsynlegar. Síðustu tvær eru valkvæðar, virkjaðar með components.plugins.enabled og components.fileprocess.enabled þar sem Enterprise-uppsetning eða sviðspakki (domain pack) notar þær. Ein valkvæð þjónusta í viðbót, nexus-alive á gátt 8080, er með sinn eigin rofa, components.alive.enabled, og er einnig sjálfgefið óvirk. Eftirrit (replicas) og tilföng fyrir hverja þjónustu eru undir components.<name>.
Stjórnborðið samanstendur af síðum sem eru myndgerðar á netþjóni án gagnagrunns. Það talar við BFF og við nexus-auth innan klasans, aldrei út í gegnum opinbera auðkenningarhýsilinn og aftur inn. Það neitar að ræsa sig án útgáfu sinnar (edition), sem kortið sendir sem NEXUS_EDITION út frá hinu eina edition gildi. Hver meðlimur stofnunar vinnur í því í samræmi við hlutverk sitt. Stjórnunarsíðurnar eru fyrir eigendur og kerfisstjóra, og almennur meðlimur sem opnar eina slíka fær síðuna „Ekki kerfisstjóri“.
BFF er netþjónshluti stjórnborðsins og er smíðaður sem viðbót við kerfið, skráður sem varan Nexus Alpha. Hann geymir eigin töflur stjórnborðsins í aðskildum gagnagrunni, nexus_alpha, og ákveður hvaða valmyndahópa notandi sér. Þegar stjórnborðið þarf að láta vinna verk biður BFF þá þjónustu sem á verkið um það.
nexus-auth er skrifað í Go og er eina þjónustan sem gefur út tóka. Aðgangstókar lifa í 15 mínútur og endurnýjunartókar í 12 klukkustundir samkvæmt sjálfgefnum stillingum (auth.accessTokenTTL, auth.refreshTokenTTL). Þjónustan takmarkar hvern innskráðan notanda við 5.000 beiðnir á mínútu áður en hún svarar með 429 (auth.rateLimitPerMinute). Hún keyrir tvo hlustara (listeners): þann óbreytta á gátt 8080 í gámnum sem opinbera Ingress-leiðin nær til, og annan með gagnkvæmu TLS á 8443 sem allir kallarar innan klasans verða að nota. Hún treystir X-Forwarded-For aðeins frá stökkunum (hops) í proxy.trustedCIDRs, sem er listi yfir CIDR-svið (Classless Inter-Domain Routing) og er sjálfgefið 10.42.0.0/16, pod-net k3s. Ef ingress-stýringin ykkar keyrir annars staðar skuluð þið breyta þessu. Annars lítur hver innskráning út fyrir að hafa komið frá stýringunni.
Gáttin sinnir tveimur hlutverkum sem deila einu ferli. Innan klasans er hún gervigreindarbeinirinn (AI Provider Router, gervigreindarskiptiborðið í 1. hluta og á síðum stjórnborðsins), eini handhafi líkanaskilríkja stofnunar (nánar um það hér að neðan). Á jaðrinum er hún það sem api.<domain> nær til: REST-biðlarar og MCP-biðlarar, en tókar þeirra bera markhópinn (audience) https://<hosts.api>/mcp og koma frá OAuth 2.1 heimildarþjóninum á auðkenningarhýslinum (OAuth er opni staðallinn fyrir framselda heimildarveitingu).
Samhæfarinn og verkferlarnir mynda saman UNO, verkferlavélina. Öll reiknivinnsla fer í gegnum þau. Samhæfarinn tekur við verki á POST /api/v1/dispatch, svarar með 202 ásamt jobId, runId og traceId, og setur það í biðröð. Það er engin bein keyrsluleið (inline execution path): biðlari spyr (polls) alltaf GET /api/v1/dispatch/{jobId} eða tekur við endurkalli (callback). Verkferlaþjónninn sækir verk úr biðröðinni, fjögur í einu á hvert eftirrit samkvæmt sjálfgefnum stillingum (workflows.concurrency), og hefur nákvæmlega eina HTTP-leið, GET /health.
Probitas er sönnunargagnaþjónustan. Hún afgreiðir TLS sjálf, út frá skilríki sem kortið gefur út, og geymir töflur sínar í trust skemanu með aðskildu hlutverki fyrir færslubókina. Stjórnarháttaeiginleikum hennar er stýrt með probitas.flags. Nokkrir þeirra koma sjálfgefið í shadow ham: niðurstaðan er reiknuð og skráð, og ekkert er stöðvað fyrr en þið breytið flagginu.
nexus-keys er lyklaþjónusta kerfisins, skrifuð í Go. Hún geymir einn lykil fyrir hverja stofnun í OpenBao-lyklageymslu og endurnýjar þá (rotates) á hverri nóttu. Næturverk hennar eyða einnig lyklum þegar varðveisludagur þeirra er runninn upp og flytja kvittanir hennar út á hennar eigið gagnasvæði (volume). Ef lykli stofnunar er eytt verða gögnin sem læst eru með honum ólesanleg fyrir fullt og allt. Hún býr einnig til auðkenni uppsetningarinnar við fyrstu frumstillingu (bootstrap), undir keys.installationName, og það nafn er varanlegt. Veljið það af kostgæfni: kortið hafnar tómu nafni (INSTALLATION_NAME_MISSING) og hafnar nafninu í sínum eigin sýnigildum (INSTALLATION_NAME_EXAMPLE).
Þrír opinberir hýsingarstaðir
Kortið gefur út nákvæmlega þrjú hýsilnöfn, sem saman mynda auðkenni uppsetningarinnar. Allar þjónustur neita að ræsa sig án þeirra.
| Ingress | Hýsilgildi | Bakendi |
|---|---|---|
nexus-console |
hosts.console |
nexus-alpha, gátt 3000 |
nexus-api |
hosts.api |
nexus-gateway, gátt 9092 |
nexus-auth |
hosts.auth |
nexus-auth, gátt 9101 |
Dæmin í þessari bók nota console.harrow.example, api.harrow.example og auth.harrow.example. Ingress-einingarnar eru einfaldir networking.k8s.io/v1 hlutir með einni reglu hver, slóð /. TLS á jaðrinum fylgir tls.mode: existing (Secret sem þið bjugguð til, nefnt í tls.existingSecret), cert-manager (ClusterIssuer sem þið keyrið, nefndur í tls.clusterIssuer) eða none (TLS endar fyrir framan klasann). Kortið bætir engri endurbeiningu við af sjálfu sér, þannig að ACME (Automated Certificate Management Environment) HTTP-áskorun berst óbreytt til lausnarans (solver) ykkar. Kafli 2.11, Tilbrigði: ytri gagnageymslur, TLS og ingress, fjallar um hvern ham.
Ekkert annað er opið út á við. Gagnageymslurnar, OpenBao og allar innri þjónustur hlusta eingöngu innan nafnrýmisins.
Beiðni, frá upphafi til enda
Hér er það sem gerist þegar Aoife Brennan, yfirmaður upplýsingatæknideildar hjá Harrow, opnar stjórnborðið og spyr aðstoðarmanninn spurningar um leguplássaáætlun þessa mánaðar.
- Vafrinn hennar hleður
https://console.harrow.example.nexus-consoleIngress-leiðin sendir það ánexus-alphaá gátt 3000. - Hún skráir sig inn með aðgangslyklinum sínum (passkey). Innskráningarsíðurnar tala við
nexus-authí gegnumauth.harrow.example, og nexus-auth býr til aðgangstóka handa henni sem inniheldur notanda hennar, stofnun hennar og, þegar lotan hennar hefur slíka, rekstrareiningu hennar. - Netþjónn stjórnborðsins kallar á BFF, sem athugar tókann hennar og spyr nexus-auth hvort stofnun hennar eigi vöruna og hvort hlutverk hennar hafi aðgang. Hann svarar með þeim valmyndahópum sem hún má sjá.
- Spurningin hennar fer frá BFF á afgreiðsluleið samhæfarans, þar sem stofnun hennar og notandi eru tekin úr staðfesta tókanum. Samhæfarinn svarar með 202 og setur verkið í biðröð í Valkey.
- Verkferlaþjónn tekur verkið. Færniþátturinn sem hann keyrir er leystur af færnivélinni, og uppfletting í skjölum Harrow fer til GraphRAG, sem les Neo4j, Qdrant og sitt eigið PostgreSQL-skema.
- Líkanakallið fer til gervigreindarbeinisins (AI Provider Router) á
/internal/ai/chat. Beinirinn velur þjónustuveitu og líkan úr eigin lyklasafni og beiningarstefnu Harrow, framkvæmir kallið með lykli Harrow og skilar svarinu. - Niðurstaðan lendir í keyrsluröð verksins. BFF les hana og stjórnborðið birtir svarið, ásamt tilvísunum.
Stökkin á milli þjónusta bera framreiknaða þjónustutóka (projected service tokens), köllin inn í nexus-auth, nexus-keys og Probitas fara yfir TLS frá eigin vottunarstöð (certificate authority) uppsetningarinnar, og allur gagnaaðgangur í skrefum 4 til 6 er afmarkaður við stofnun Harrow í gagnagrunninum sjálfum. Kaflarnir hér að neðan útskýra hvort tveggja.
Gagnalagið
Nexus fylgir sitt eigið undirritaða eintak af hverri gagnageymslu, ásamt frumkóðatilboði fyrir hverja þeirra í pakkanum. Hver og ein var valin jafnt fyrir leyfisskilmála sína og virkni.
| Gagnageymsla | Útgáfa | Leyfi | Hvers vegna hún er þar | Gátt | Sjálfgefið gagnasvæði |
|---|---|---|---|---|---|
| PostgreSQL með PostGIS og pgvector | PostgreSQL 16, PostGIS 3, pgvector 0.8 | PostgreSQL-leyfið; PostGIS GPL-2.0-or-later | Frumgagnakerfi (system of record) fyrir allar þjónustur; PostGIS fyrir kortagögn; pgvector fyrir vigra sem geymdir eru við hlið raða | 5432 | 50 GiB |
| Valkey | 8.1 | BSD-3-Clause | Verkbiðraðir UNO og skammlíf skyndiminni, svo sem skyndiminni fyrir API-lykla í nexus-auth | 6379 | 5 GiB |
| Neo4j Community Edition | 5.26 | GPL-3.0 | Þekkingarnetið sem GraphRAG byggir og ferðast um | 7687 (Bolt) | 20 GiB |
| Qdrant | 1.15 | Apache-2.0 | Vigleit (vector search) fyrir GraphRAG og færnivélina | 6333 (HTTP), 6334 (gRPC fjarköll) | 10 GiB |
| SeaweedFS | 4.48 | Apache-2.0 | Hlutageymsla (object storage) fyrir skrár, samhæfð við Amazon Simple Storage Service (S3) | 8333 | 50 GiB |
| OpenBao | 2.6 | MPL-2.0 | Lyklageymslan og aflæsir hennar, fyrir nexus-keys | 8200 | 5 GiB og 1 GiB |
Sumir valkostir komu í stað einhvers kunnuglegra. Valkey kemur í stað Redis 7.4, en útgáfan hafnar núverandi leyfisskilmálum þess. MinIO er með AGPL-3.0, þannig að hlutageymslan er SeaweedFS. GraphRAG nær til Neo4j Community Edition yfir Bolt, sem er netsamskiptaregla, og þjónusturnar ná til PostGIS yfir PostgreSQL-samskiptaregluna, þannig að GPL-leyfið helst hjá hvoru þeirra um sig. OpenBao er klofningur (fork) Linux Foundation af Vault frá því fyrir leyfisbreytingu Vault.
Hver gagnageymsla keyrir með virka auðkenningu og framkölluð skilríki: lykilorð fyrir Valkey, API-lykil fyrir Qdrant, aðgangslykla fyrir SeaweedFS.
Hver hinna fimm gagnageymslna undir dataTier keyrir í klasanum (mode: in-cluster, sjálfgefið) eða er geymsla sem þið rekið nú þegar (mode: external, með external.host og Secret sem nefnt er í external.existingSecret). Fyrir ytri PostgreSQL skuluð þið stilla sslmode á verify-full eða verify-ca, og setja skilríki vottunarstöðvar (CA) netþjónsins í það Secret; kafli 2.11, Tilbrigði: ytri gagnageymslur, TLS og ingress, inniheldur nánari upplýsingar.
# 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-parið er undantekningin: það keyrir alltaf inni í uppsetningunni, vegna þess að vörsluverkið (custody Job) frumstillir það þar.
Auðkenning milli þjónusta
Nexus keyrir án þjónustunets (service mesh). Gagnkvæmt TLS kemur frá staðbundinni vottunarstöð (CA) sem kortið býr til í gegnum cert-manager, sem verður að setja upp fyrst (v1.21.3 er prófað).
Sjálfundirritaður útgefandi (Issuer) býr til eitt CA-skilríki, nexus-local-ca, ECDSA (Elliptic Curve Digital Signature Algorithm) P-256, sem gildir í tíu ár. Annar útgefandi undirritar með þeirri vottunarstöð. Hvert vinnsluálag sem kallar á TLS-þjón inni í uppsetningunni fær sitt eigið biðlaraskilríki, nefnt <service-account>-client-tls, sem gildir í 90 daga og er endurnýjað 15 dögum áður en það rennur út. Eina nafn þess er auðkenni (URI, uniform resource identifier) á SPIFFE-auðkennisforminu:
spiffe://cluster.local/ns/<namespace>/sa/<service-account>
Hvert vinnsluálag finnur opinbert skilríki vottunarstöðvarinnar sem ca.crt í sínu eigin skilríkis-Secret. Enginn pod tengir (mounts) lykil vottunarstöðvarinnar og þið þurfið ekki trust-manager.
Þrjár þjónustur sannreyna kallara með skilríkjum. nexus-auth gerir það á öðrum hlustara sínum, gátt 8443, og allir kallarar innan klasans hringja í hann. nexus-keys gerir það á eina hlustara sínum. Probitas afgreiðir TLS frá sínu eigin skilríki, nexus-probitas-tls, sem það les aftur þegar cert-manager endurnýjar það. Engin þeirra treystir X-Forwarded-Client-Cert haus.
Hvert vinnsluálag fær einnig klukkustundarlanga Kubernetes-tóka á /var/run/secrets/nexus, einn fyrir hverja þjónustu sem það kallar á, með þá þjónustu sem markhóp (audience). ConfigMap-einingin nexus-service-identities varpar hverju <namespace>/<service-account> á nafn þjónustu eða viðbótar, og vinnsluálag sem vantar í hana hefur ekkert auðkenni og er hafnað. Samhæfarinn og Probitas sannreyna þessa tóka með Kubernetes API. Af keyrandi þjónustum eru aðeins þessar tvær með system:auth-delegator eða hafa tengdan API-tóka; eina hitt vinnsluálagið með tóka er vörsluverkið sem keyrir við uppsetningu.
Netreglur (Network policy) loka því sem auðkenni lokar ekki. Kortið byrjar á sjálfgefinni höfnun (default deny), en hleypir síðan í gegn umferð á milli eigin pod-eininga uppsetningarinnar, DNS (Domain Name System), nafnrýmis ingress-stýringarinnar (networkPolicy.ingressNamespace, sjálfgefið kube-system) til opinberu þjónustanna þriggja, og API-þjónsins fyrir tókayfirlesarana tvo. OpenBao pod-einingarnar bera annað merki (label) en restin af kerfinu, þannig að opna reglan innan nafnrýmisins nær ekki til þeirra: aðeins nexus-keys, verk þess og vörsluverkið komast í gegn, á gátt 8200. Allt annað sem vinnsluálag þarf að ná til utan nafnrýmisins, svo sem póstmiðlarinn ykkar, fer í networkPolicy.externalEgressCIDRs, sem er sjálfgefið tómt.
Uppfærslufærslur og skemabókin
Gagnaflutningar (migrations) keyra sem Helm-krókar (hooks), á post-install og pre-upgrade. Krókur eftir uppsetningu (post-install hook) keyrir eftir að Deployments útgáfunnar hafa verið búin til. Þannig að við fyrstu uppsetningu ræsast þjónusturnar á meðan skemu þeirra eru ekki enn til, og þær myndu lenda í hrunlykkju (crash-loop) gagnvart gagnagrunni án hlutverks, án lykilorðs og án taflna. Nexus kemur í veg fyrir þetta með færslubók.
Krókarnir keyra í vægisröð (weight order) og Helm bíður eftir hverju verki (Job) áður en næsta vægi hefst:
| Vægi | Krókur | Hvað hann gerir |
|---|---|---|
| -30 | nexus-migrations-env og forkröfur |
Býr til Secret sem er eingöngu fyrir króka með skilríkjum flutningsþjónsins, og allt sem vörsluverkið les |
| -20 | nexus-db-bootstrap |
Býr til nexus og nexus_alpha gagnagrunnana, hlutverk flutningsþjónsins, keyrsluhlutverk hverrar þjónustu, viðbæturnar (extensions) og færslubókina |
| -15 | nexus-openbao-custody-init |
Frumstillir lyklageymsluna og aflæsinn og býr til auðkenni uppsetningarinnar |
| -12 | nexus-graphrag-migrations |
Skema GraphRAG, sem á hluti sem grunnkeyrsla nexus-auth vísar til |
| -10 | nexus-auth-migrations |
Auðkennisskemað |
| -5 | Gagnaflutningar fyrir samhæfara, gátt og Probitas | Skemu þeirra; Probitas athugar fyrst hvort auth-töflurnar séu til |
| 0 | nexus-alpha-bff-migrations |
Eigin gagnagrunnur stjórnborðsins |
Hvert flutningsverk er með backoffLimit: 0, þannig að mistekinn flutningur veldur því að uppsetningin mistekst.
Færslubókin er ein tafla, nexus_release.schema_applied, með einni röð fyrir hverja keðju og myndarsummu (image digest). Hver krókur skrifar sína röð aðeins eftir að flutningskeyrslu hans er lokið. Hvert Deployment sem notar PostgreSQL inniheldur frumstillingargám (init container), wait-for-schema, sem les þá töflu sem hlutverk sem hefur leyfi til að lesa ekkert annað (nexus_ledger_reader) og bíður þar til hver keðja sem það er háð sýnir röð fyrir mynd þessarar útgáfu. Þá ræsist þjónustan. Verkferlaþjónninn bíður eftir keðju samhæfarans, þar sem hann deilir þeim gagnagrunni, og færnivélin bíður aðeins eftir frumstillingunni.
Hann spyr (polls) á 3 sekúndna fresti (schemaWait.intervalSeconds) og gefst upp eftir 1.800 (schemaWait.timeoutSeconds) með línu sem nefnir þær keðjur sem enn vantar. Eigin gámur þjónustunnar ræsist aldrei gagnvart röngu skema.
kubectl -n nexus logs deploy/nexus-gateway -c wait-for-schemaÞetta er ástæðan fyrir því að þið megið aldrei keyra helm install --wait. Með --wait bíður Helm eftir Deployments áður en það keyrir krókana eftir uppsetningu, og Deployments bíða eftir krókunum. Hvorugt hreyfist. Setjið upp án þess og bíðið á eftir; kafli 2.6, Uppsetning á Community á Kubernetes, sýnir nákvæma skipun.
Einangrun á þremur ásum
Hver lestur, skrif, verkfærakall og færniafgreiðsla í Nexus er afmörkuð á þremur ásum.
| Ás | Reitur | Hvað hann aðskilur |
|---|---|---|
| Leigjandi (Tenant) | organization_id |
Eina stofnun frá annarri, hörð mörk |
| Eigandi (Owner) | owner_user_id |
Hluti eins einstaklings frá hlutum allra annarra, jafnvel innan sömu stofnunar |
| Eining (Unit) | business_unit_id |
Undireining stofnunar, valkvætt |
Eigandaásinn kemur fólki á óvart. Pósthólf eða persónuleg minnisbók er einkamál eiganda síns, jafnvel gagnvart samstarfsfólki í sömu einingu með sama hlutverk. Kerfisstjóri setur reglur en les ekki efni.
Ásarnir koma úr auðkenndu beiðninni og hvergi annars staðar frá. Engin umhverfisbreyta, haus, fyrirspurnarbreyta eða slóðarhluti getur stillt þá. Meginmáli beiðni sem nefnir stofnun er hafnað með TENANT_NOT_A_PARAMETER. Yfirborð sem getur ekki tilgreint hvaða leigjanda, eiganda og einingu röð tilheyrir hafnar með 403 SCOPE_PREDICATE_MISSING, og meginmálið telur upp hvaða ásar leystust og hverjir ekki. Það fellur aldrei aftur í víðari lestur.
Þetta gildir á tveimur stöðum í einu.
Í gagnagrunninum. Hver þjónusta tengist sem sín eigin keyrsluhlutverk: nexus_auth, auth_app og auth_platform fyrir auðkennisþjónustuna, nexus_probitas og nexus_probitas_ledger fyrir Probitas, og nexus_gateway, nexus_graphrag, nexus_skills, orchestrator_app, workflows_app og afgangurinn fyrir hinar. Ekkert þeirra er ofurnotandi (superuser) eða hefur BYPASSRLS. Ekkert þeirra á heldur töflurnar sem það notar, þannig að allar öryggisreglur á raðastigi (RLS, row-level security) gilda um það. Hlutverkin deila hóp, nexus_runtime, sem veitir rétt til tengingar og skemanotkunar en engin töfluréttindi; hverri þjónustu er veittur aðgangur að sínum eigin töflum með sínum eigin gagnaflutningum. Leigjendastillingarnar sem RLS-reglur lesa er aðeins hægt að stilla í gegnum bind_scope fall hverrar þjónustu, sem keyrir sem eigandi hennar. Frumstillingin afturkallar set_config frá öllum öðrum, og samhæfarinn og Probitas neita að ræsa sig ef keyrsluhlutverk þeirra gæti kallað beint á það (Probitas nefnir það DB_ROLE_SETS_SCOPE_DIRECTLY). Einu ofurnotendatengingarnar í allri uppsetningunni tilheyra frumstillingarverkinu og úthlutunarskrefi BFF.
Í sameiginlegu frumeiningunni fyrir afmarkaðar fyrirspurnir. Hvert gagnasafn (repository) í kerfinu og hver viðbót sem byggð er á þróunarsetti (SDK, software development kit) erfir eina girðingu sem byggir SQL-forsenduna (predicate) út frá leystu umfangi. Umfangsfall hennar tekur við staðfesta auðkenninu og hefur enga stofnunarbreytu, þannig að kallari getur ekki sent slíka inn, og engin leið getur komist hjá þessu.
Það er nákvæmlega ein leið yfir leigjendamörkin, og hún er þröng: skráð heimild (recorded grant). Tveir aðilar hjá stofnuninni sem á raðirnar skrá hvaða stofnun megi lesa hvaða töflur, og fram til hvaða tíma. Hver lestur keyrir í skrifvarinni færslu (read-only transaction) og er skráður í atburðaskrá hjá báðum leigjendum. Eigendur og kerfisstjórar lesa aldrei á milli, og lesandinn getur ekki víkkað út heimild.
Leið gervigreindarinnar
Kallarar lýsa óskum. Gervigreindarbeinirinn (AI Provider Router) á skilríkið og tekur lokaákvörðunina.
Hvert líkanakall í Nexus fer í gegnum /internal/ai/* leiðir beinisins, og beinirinn hleypir aðeins nefndum köllurum að. Kortið stillir þrjá lista á gáttinni:
| Leiðir | Hver má kalla |
|---|---|
| Spjall og spjallstreymi | nexus-orchestrator, nexus-workflows, nexus-skills-engine |
| Vigranir (embeddings) og endurröðun (rerank) | nexus-graphrag, nexus-skills-engine, nexus-workflows |
| Allt annað, þar á meðal keyrsla verkfæra | nexus-orchestrator, nexus-workflows |
Kalli án auðkennis kallara er hafnað með 403 MISSING_CALLER_IDENTITY, og kallara sem ekki er á listanum með 403 UNAUTHORIZED_CALLER. Viðbætur eru ekki á neinum lista, og það er af ásettu ráði: líkanaköll viðbótar eiga sér stað fyrir hennar hönd, í gegnum UNO-afgreiðslu.
Það sem kallari má senda er ósk: æskileg þjónustuveita og líkan, auk getusniðs (capability profile) svo sem lágmarkssamhengislengdar eða verkfæranotkunar. Beinirinn verður aðeins við ósk þegar stofnunin hefur þá þjónustuveitu virka og með skilríkjum; annars setur hann annað í staðinn, fyrst innan sömu þjónustuveitu, síðan þvert á aðrar þjónustuveitur stofnunarinnar. Getusnið síar aðeins, og krafa um gagnastaðsetningu (data-residency) í því er ófrávíkjanleg. Þegar ekkert passar er ekkert varalíkan: kallarinn fær 422 MODEL_CAPABILITY_UNAVAILABLE eða 422 NO_PROVIDER_FOR_ROLE, ásamt úrbótastreng sem stjórnborðið sýnir kerfisstjóra.
Lyklar tilheyra stofnuninni. Kerfisstjórar hverrar stofnunar setja sína eigin þjónustuveitulykla í safn hennar í gegnum stjórnborðið, og beinirinn leysir þá á tíma kallsins. Enginn líkanalykill er gildi í kortinu og enginn fylgir með Nexus. Stofnun án lykils fær engin gervigreindarsvör, og stjórnborðið segir það skýrt; ekkert fyllir upp í eyðuna annars staðar frá.
Tvö gildi í Helm-kortinu (chart) móta beininn (router). ai.localProvider.baseUrl tilgreinir OpenAI-samhæfðan líkanaþjón sem þú rekur og er beint til hans líkt og hvers annars þjónustuaðila. ai.installationHosts telur upp líkanaþjónana þína á innri nöfnum, sem beinirinn lítur á sem hluta af uppsetningunni. GraphRAG býr einnig til innfellingar (embeddings) í gegnum beininn, í nafni þeirrar stofnunar sem á efnið. Sjálfgefna innfellingarlíkanið keyrir í klasanum án skjákorts; hýstar innfellingar eru val hverrar stofnunar.
Engin fjarmæling
Ekkert fer út úr uppsetningu nema þú sendir það. Gildið telemetry.enabled í kortinu getur aðeins verið false; skemað hafnar öllu öðru. Eigin skýrslugjöf gagnalagsins er líka óvirk: notkunarskýrsla Neo4j og fjarmælingar (telemetry) Qdrant eru óvirkjaðar í kortinu.
Þegar networkPolicy.enabled er virkt, sem er sjálfgefið, nær enginn podur sambandi við internetið nema þú skráir áfangastaðinn í networkPolicy.externalEgressCIDRs. Hýstur líkanaþjónustuaðili er einn slíkur áfangastaður og póstmiðlarinn þinn (mail relay) sömuleiðis.
Sama regla breytti einu sjálfgefnu gildi sem þú munt taka eftir. CAPTCHA í nexus-auth fyrir nýskráningar krefst netþjónustu, þannig að í staðbundinni uppsetningu er slökkt á því og nýskráning ókunnugra bíður samþykkis kerfisstjóra (403 SIGNUP_REQUIRES_APPROVAL). Vörnin sem lokar á nýskráningar frá hýsingarnetum er einnig óvirk, vegna þess að hún þarfnast leyfisskyldra gagnagrunna sem fylgja ekki með Nexus. Þú missir þá síun.

