InnskráningBóka kynningu

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

19 mínútna lestur

Þ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).

Þessi uppsetning (Community)
Þessi uppsetning (Community)
Eigin síða Community-uppsetningar sýnir útgáfu hennar og heilbrigði vélarinnar. Þar kemur skýrt fram að ekkert leyfi sé nauðsynlegt. Enterprise-hlutar síðunnar eru birtir sem kynningardæmi.

Þ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.

Þrjú lárétt belti. Efsta beltið er „Edge“ með þremur Ingress-reitum sem eru merktir console, api og auth, og vísar hver þeirra niður á sína þjónustu (Service) (nexus-alpha :3000, nexus-gateway :9092, nexus-auth :9101). Miðbeltið er „Platform services“: reitur fyrir nexus-alpha-bff; nexus-orchestrator við hlið nexus-workflows, hópað saman og merkt UNO; síðan nexus-graphrag, nexus-probitas, nexus-skills-engine, nexus-keys; og tveir reitir með brotalínu fyrir valkvæðu einingarnar nexus-plugins og nexus-fileprocess. Neðsta beltið er „Data tier“ með einum reit fyrir hverja gagnageymslu (PostgreSQL, Valkey, Neo4j, Qdrant, SeaweedFS), og aðskildum afgirtum reit merktum „Key store“ sem geymir openbao og openbao-unsealer, sem aðeins nexus-keys nær til.
Einingar Nexus-uppsetningar og gagnageymslurnar undir þeim.

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.

  1. Vafrinn hennar hleður https://console.harrow.example. nexus-console Ingress-leiðin sendir það á nexus-alpha á gátt 3000.
  2. Hún skráir sig inn með aðgangslyklinum sínum (passkey). Innskráningarsíðurnar tala við nexus-auth í gegnum auth.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.
  3. 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á.
  4. 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.
  5. 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.
  6. 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.
  7. 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.

Runa frá vinstri til hægri. Vafrareitur sendir „1 page“ á Ingress console, og þaðan á nexus-alpha. Hliðarör „2 sign-in“ fer frá vafranum í gegnum Ingress auth til nexus-auth. nexus-alpha sendir „3 menu“ til nexus-alpha-bff, sem sannreynir hjá nexus-auth. nexus-alpha-bff sendir „4 dispatch, 202“ til nexus-orchestrator, sem skrifar í táknmynd fyrir Valkey-biðröð. nexus-workflows sækir „5 job“ úr biðröðinni og kallar á nexus-skills-engine og nexus-graphrag (þrjár gagnageymslur þess eru teiknaðar undir GraphRAG). nexus-workflows sendir „6 chat“ til nexus-gateway, sem er merkt „AI Provider Router: organisation key pool“, sem sendir eina ör út fyrir mörk klasans til „model provider“. Punktalínuör til baka, „7 result on run row“, fer aftur til nexus-alpha-bff.
Ein spurning til aðstoðarmanns, frá vafranum til líkanaveitunnar og til baka.

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-postgres

OpenBao-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.

Staða uppsetningarinnar
Staða uppsetningarinnar
Í Enterprise sýnir heilsufarssíðan klasann undir Nexus: hversu mikið álag er á hverjum hluta og hversu mikið afkastageta er eftir, ásamt hverri viðvörun við hlið þess sem hægt er að gera í málinu.