IdħolIbbukkja laqgħa informattiva

Kapitlu 2.1

Arkitettura

X'jippossjedi kull servizz fiċ-chart ta' Nexus u liema ħażniet jinsabu taħtu, imbagħad ir-regoli li jżommuhom flimkien, mill-identità bejn is-servizzi sal-mogħdija li tieħu kull sejħa tal-mudell.

Din il-paġna ġiet tradotta bl-IA mill-oriġinal bl-Ingliż. Jekk xi ħaġa mhijiex ċara, il-paġna bl-Ingliż hija r-referenza. Aqra din il-paġna bl-Ingliż

19 minuti qari

Meta Tomás Reilly lesta l-ewwel installazzjoni f'Harrow Port Authority, kubectl -n nexus get pods wera għaxar Deployments u seba' StatefulSets, flimkien ma' tliet CronJobs. Il-Jobs ta' migrazzjoni li bnew id-database kienu diġà telqu, għaliex kull wieħed iħassar lilu nnifsu meta jirnexxi. Dik il-lista hija l-pjattaforma kollha. Tgħallmuha, għaliex il-biċċa l-kbira tal-mistoqsijiet tat-tieni jum jibdew b'"liema minn dawn huwa s-sid ta' dak?"

Dan il-kapitlu jwieġeb dan għal kull parti, isegwi talba waħda minnhom, u mbagħad ikopri r-regoli li jobdu kollha kemm huma. Il-bqija tat-Taqsima 2 tibni fuq din l-istampa.

Is-servizzi u x'jippossjedi kull wieħed

Iċ-chart hija chart waħda ta' Helm, nexus, verżjoni 1.0.0-alpha.1, għal Kubernetes 1.33 jew aktar tard. Kull workload jaħdem taħt is-ServiceAccount tiegħu stess, bħala utent non-root, bil-kapaċitajiet kollha ta' Linux imneħħija. Is-sejħiet lejn is-servizzi li jħarsu l-identità u l-keys jgħaddu minn mutual TLS (Transport Layer Security), u l-API (application programming interface) pubblika taqsam proċess mar-router tal-IA (intelliġenza artifiċjali).

Komponent Deployment u Service Port tas-Service ta' xiex huwa sid
Console nexus-alpha 3000 Il-paġni li jaraw in-nies; iservi HTML (Hypertext Markup Language) fil-host tal-console
BFF (backend for frontend) nexus-alpha-bff 8080 Id-data tal-console stess, il-menu li jikseb kull persuna, ir-reġistru tar-rilaxxi
Auth nexus-auth 9101 (mutual TLS fuq 8443) Nies, organizzazzjonijiet, sessjonijiet, tokens, API keys, il-pool ta' model keys tal-organizzazzjoni
Gateway nexus-gateway 9092, WebSocket 8093 L-AI Provider Router, u t-tarf tal-API pubblika għal REST (representational state transfer) u MCP (Model Context Protocol)
Orchestrator nexus-orchestrator 8080 UNO dispatch: jaċċetta kull job u jpoġġih fil-kju
Workflows nexus-workflows 8081 UNO execution: il-worker li jħaddem il-jobs li jkunu fil-kju
GraphRAG nexus-graphrag 8090, WebSocket 8091 Memorja: il-knowledge graph u l-irkupru minnu
Probitas nexus-probitas 9151 (HTTPS) Evidenza: rekords ta' governanza u l-ledger issiġillat
Skills engine nexus-skills-engine 8095 Il-librerija tal-iskills; is-sejba u t-tħaddim tal-iskills
Keys nexus-keys 8080 (HTTPS, mutual TLS) Keys għal kull organizzazzjoni f'OpenBao, kustodja, l-identità tal-installazzjoni
Plugins nexus-plugins 9111 Ir-reġistru tal-plugins u r-rekords tal-katalgu; mitfi awtomatikament
Ipproċessar tal-fajls nexus-fileprocess 9109 Qari ta' dokumenti u stampi mtellgħin; mitfi awtomatikament

L-ewwel għaxra huma meħtieġa. L-aħħar tnejn huma fakultattivi, u jinxtegħlu b'components.plugins.enabled u components.fileprocess.enabled fejn installazzjoni Enterprise jew domain pack jużawhom. Servizz fakultattiv ieħor, nexus-alive fuq il-port 8080, għandu l-iswiċċ tiegħu stess, components.alive.enabled, u huwa mitfi awtomatikament ukoll. Ir-replikazzjonijiet u r-riżorsi għal kull wieħed jinsabu taħt components.<name>.

Il-console hija paġni rrenderjati mis-server mingħajr database. Titkellem mal-BFF, u ma' nexus-auth ġewwa l-cluster, u qatt ma toħroġ mill-host pubbliku tal-auth u terġa' tidħol. Tirrifjuta li tibbutja mingħajr l-edizzjoni tagħha, li ċ-chart tgħaddi bħala NEXUS_EDITION mill-valur uniku edition. Kull membru ta' organizzazzjoni jaħdem fiha skont ir-rwol tiegħu. Il-paġni tal-amministrazzjoni huma għas-sidien u l-amministraturi, u membru li jiftaħ waħda jikseb il-paġna "Not an administrator".

Il-BFF huwa n-nofs tas-server tal-console u huwa mibni bħala plugin tal-pjattaforma, irreġistrat bħala l-prodott Nexus Alpha. Iżomm it-tabelli tal-console stess f'database separata, nexus_alpha, u jiddeċiedi liema gruppi ta' menus jara persuna. Meta l-console jkollha bżonn li jsir xi xogħol, il-BFF jistaqsi lis-servizz li huwa s-sid tiegħu.

nexus-auth huwa miktub f'Go u huwa l-uniku servizz li joħloq tokens. L-access tokens jgħixu 15-il minuta u r-refresh tokens 12-il siegħa awtomatikament (auth.accessTokenTTL, auth.refreshTokenTTL). Jillimita lil kull persuna li tkun illoggjata għal 5,000 talba fil-minuta qabel ma jwieġeb 429 (auth.rateLimitPerMinute). Iħaddem żewġ listeners: wieħed sempliċi fuq il-port tal-container 8080 li jilħaq l-Ingress pubbliku, u wieħed b'mutual TLS fuq 8443 li kull caller ġewwa l-cluster irid juża. Jemmen lil X-Forwarded-For biss mill-hops f'proxy.trustedCIDRs, lista ta' meded ta' Classless Inter-Domain Routing (CIDR), li awtomatikament tkun 10.42.0.0/16, in-netwerk tal-pods ta' k3s. Jekk l-ingress controller tagħkom jaħdem x'imkien ieħor, ibdluh. Inkella kull illoggjar jidher bħallikieku ġie mill-controller.

Il-gateway għandu żewġ xogħlijiet li jaqsmu proċess wieħed. Ġewwa l-cluster huwa l-AI Provider Router (is-switchboard tal-IA fit-Taqsima 1 u fuq il-paġni tal-console), l-uniku detentur tal-kredenzjali tal-mudelli ta' organizzazzjoni (aktar dwar dan hawn taħt). Fit-tarf huwa dak li jilħaq api.<domain>: klijenti REST, u klijenti MCP, li t-tokens tagħhom iġorru l-udjenza https://<hosts.api>/mcp u jiġu mis-server ta' awtorizzazzjoni OAuth 2.1 fil-host tal-auth (OAuth huwa l-istandard miftuħ għal awtorizzazzjoni delegata).

L-orchestrator u l-workflows flimkien huma UNO, il-workflow engine. Kull compute jgħaddi minnhom. L-orchestrator jaċċetta job f'POST /api/v1/dispatch, iwieġeb 202 b'jobId, runId u traceId, u jpoġġih fil-kju. M'hemm l-ebda mogħdija ta' eżekuzzjoni inline: klijent dejjem jagħmel polling fuq GET /api/v1/dispatch/{jobId} jew jieħu callback. Il-worker tal-workflows jiġbed il-jobs mill-kju, erbgħa kull darba għal kull replika awtomatikament (workflows.concurrency), u għandu eżattament rotta HTTP waħda, GET /health.

Probitas huwa s-servizz tal-evidenza. Iservi t-TLS huwa stess, minn ċertifikat li toħroġ iċ-chart, u jżomm it-tabelli tiegħu fl-iskema trust bi rwol separat għal-ledger. Il-karatteristiċi ta' governanza tiegħu jinxtegħlu b'probitas.flags. Diversi minnhom jiġu fil-modalità shadow: il-verdett jiġi kkalkulat u rreġistrat, u xejn ma jiġi mblukkat sakemm tibdlu l-flag.

nexus-keys huwa s-servizz tal-keys tal-pjattaforma, miktub f'Go. Iżomm key għal kull organizzazzjoni f'key store ta' OpenBao u jdurhom kull lejl. Il-jobs ta' kull lejl tiegħu jeqirdu wkoll keys li tkun waslet id-data taż-żamma tagħhom u jesportaw l-irċevuti tiegħu lejn volum tiegħu stess. It-tħassir tal-key ta' organizzazzjoni jagħmel id-data msakkra taħtha ma tinqarax għal kollox. Joħloq ukoll l-identità tal-installazzjoni fl-ewwel bootstrap, taħt keys.installationName, u dak l-isem huwa permanenti. Agħżluh b'attenzjoni: iċ-chart tirrifjuta isem vojt (INSTALLATION_NAME_MISSING) u tirrifjuta l-isem fil-valuri ta' eżempju tagħha stess (INSTALLATION_NAME_EXAMPLE).

Din l-installazzjoni (Community)
Din l-installazzjoni (Community)
Il-paġna stess ta' installazzjoni Community turi l-verżjoni tagħha u s-saħħa tal-engine. Tgħid b'mod ċar li m'hemm bżonn ta' l-ebda liċenzja. Il-partijiet Enterprise tal-paġna huma mpinġija bħala teasers.

Tliet hosts pubbliċi

Iċ-chart tippubblika eżattament tliet ismijiet ta' hosts, li flimkien huma l-identità tal-installazzjoni. Kull servizz jirrifjuta li jibbutja mingħajrhom.

Ingress Valur tal-host 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

L-eżempji f'dan il-ktieb jużaw console.harrow.example, api.harrow.example u auth.harrow.example. L-Ingresses huma oġġetti sempliċi ta' networking.k8s.io/v1 b'regola waħda kull wieħed, mogħdija /. It-TLS fit-tarf isegwi tls.mode: existing (Secret li għamiltu intom, imsemmi f'tls.existingSecret), cert-manager (ClusterIssuer li tħaddmu intom, imsemmi f'tls.clusterIssuer) jew none (it-TLS jintemm quddiem il-cluster). Iċ-chart ma żżid l-ebda redirect tagħha stess, għalhekk sfida HTTP ta' ACME (Automated Certificate Management Environment) tilħaq is-solver tagħkom mingħajr tibdil. Il-Kapitlu 2.11, Varjazzjonijiet: ħażniet esterni, TLS u ingress, ikopri kull modalità.

Xejn ieħor mhu espost. Il-ħażniet tad-data, OpenBao u kull servizz intern jisimgħu biss ġewwa n-namespace.

Tliet faxex orizzontali. Il-faxxa ta' fuq hija "Edge" bi tliet kaxxi Ingress ittikkettati console, api u auth, u kull waħda tipponta 'l isfel lejn is-Service tagħha (nexus-alpha :3000, nexus-gateway :9092, nexus-auth :9101). Il-faxxa tan-nofs hija "Platform services": kaxxa għal nexus-alpha-bff; nexus-orchestrator ħdejn nexus-workflows, miġbura flimkien u ttikkettati UNO; imbagħad nexus-graphrag, nexus-probitas, nexus-skills-engine, nexus-keys; u żewġ kaxxi b'linji maqtugħa għal nexus-plugins u nexus-fileprocess li huma fakultattivi. Il-faxxa t'isfel hija "Data tier" b'kaxxa waħda għal kull ħażna (PostgreSQL, Valkey, Neo4j, Qdrant, SeaweedFS), u kaxxa separata magħluqa ttikkettata "Key store" li fiha openbao u openbao-unsealer, li tintlaħaq biss minn nexus-keys.
Il-komponenti ta' installazzjoni ta' Nexus u l-ħażniet taħthom.

Talba, mill-bidu sal-aħħar

Hawn x'jiġri meta Aoife Brennan, kap tal-IT f'Harrow, tiftaħ il-console u tistaqsi lill-assistent mistoqsija dwar l-iskeda tal-irmiġġ ta' dan ix-xahar.

  1. Il-browser tagħha jgħabbi https://console.harrow.example. L-Ingress nexus-console jibgħatha lil nexus-alpha fuq il-port 3000.
  2. Hija tilloggja bil-passkey tagħha. Il-paġni tal-illoggjar jitkellmu ma' nexus-auth permezz ta' auth.harrow.example, u nexus-auth joħloqilha access token li jġorr l-utent tagħha, l-organizzazzjoni tagħha u, meta s-sessjoni tagħha jkollha waħda, l-unità tan-negozju tagħha.
  3. Is-server tal-console jsejjaħ lill-BFF, li jiċċekkja t-token tagħha u jistaqsi lil nexus-auth jekk l-organizzazzjoni tagħha għandhiex il-prodott u jekk ir-rwol tagħha huwiex ammess. Iwieġeb bil-gruppi ta' menus li tista' tara.
  4. Il-mistoqsija tagħha tmur mill-BFF għar-rotta tad-dispatch tal-orchestrator, bl-organizzazzjoni u l-utent tagħha meħuda mit-token ivverifikat. L-orchestrator iwieġeb 202 u jpoġġi l-job f'kju f'Valkey.
  5. Worker tal-workflows jieħu l-job. L-iskill li jħaddem jiġi riżolt mill-iskills engine, u l-irkupru fuq id-dokumenti ta' Harrow imur għand GraphRAG, li jaqra Neo4j, Qdrant u l-iskema PostgreSQL tiegħu.
  6. Is-sejħa tal-mudell tmur għand l-AI Provider Router f'/internal/ai/chat. Ir-router jagħżel il-fornitur u l-mudell mill-key pool u l-politika tar-routing ta' Harrow stess, jagħmel is-sejħa bil-key ta' Harrow, u jirritorna t-tlestija.
  7. Ir-riżultat jinżel fuq ir-ringiela tar-run tal-job. Il-BFF jaqrah u l-console tpinġi t-tweġiba, biċ-ċitazzjonijiet tagħha.

Il-hops minn servizz għal servizz iġorru service tokens ipproġettati, dawk lejn nexus-auth, nexus-keys u Probitas jgħaddu minn TLS mill-awtorità taċ-ċertifikati tal-installazzjoni stess, u kull aċċess għad-data fil-passi 4 sa 6 huwa magħluq għall-organizzazzjoni ta' Harrow fid-database stess. It-taqsimiet hawn taħt jispjegaw it-tnejn.

Sekwenza mix-xellug għal-lemin. Kaxxa ta' brawżer tibgħat "1 page" lil Ingress console, imbagħad lil nexus-alpha. Vleġġa fil-ġenb "2 sign-in" tmur mill-brawżer permezz ta' Ingress auth lejn nexus-auth. nexus-alpha jibgħat "3 menu" lil nexus-alpha-bff, li jiċċekkja ma' nexus-auth. nexus-alpha-bff jibgħat "4 dispatch, 202" lil nexus-orchestrator, li jikteb f'ikona ta' kju Valkey. nexus-workflows jiġbed "5 job" mill-kju u jsejjaħ lil nexus-skills-engine u nexus-graphrag (bit-tliet ħażniet tiegħu mpinġija taħt GraphRAG). nexus-workflows jibgħat "6 chat" lil nexus-gateway, ittikkettat "AI Provider Router: organisation key pool", li jibgħat vleġġa waħda 'l barra mill-konfini tal-cluster lejn "model provider". Vleġġa bir-ritorn bit-tikek "7 result on run row" tmur lura lejn nexus-alpha-bff.
Mistoqsija waħda lill-assistent, mill-browser sal-fornitur tal-mudell u lura.

Is-saff tad-data

Nexus jibgħat il-kopja ffirmata tiegħu stess ta' kull ħażna, bl-offerta tas-sors għal kull waħda fil-pakkett. Kull waħda ntgħażlet għal-liċenzja tagħha daqs kemm għall-funzjoni tagħha.

Ħażna Verżjoni Liċenzja Għaliex qiegħda hemm Port Volum awtomatiku
PostgreSQL b'PostGIS u pgvector PostgreSQL 16, PostGIS 3, pgvector 0.8 Liċenzja PostgreSQL; PostGIS GPL-2.0-or-later Is-sistema ta' rekord għal kull servizz; PostGIS għad-data tal-mapep; pgvector għall-vetturi miżmuma ħdejn ir-ringieli 5432 50 GiB
Valkey 8.1 BSD-3-Clause Il-kjuwijiet tal-jobs ta' UNO u caches ta' ħajja qasira, bħall-cache tal-API keys ta' nexus-auth 6379 5 GiB
Neo4j Community Edition 5.26 GPL-3.0 Il-knowledge graph li GraphRAG jibni u jimxi fuqu 7687 (Bolt) 20 GiB
Qdrant 1.15 Apache-2.0 Tfittxija ta' vetturi għal GraphRAG u l-iskills engine 6333 (HTTP), 6334 (sejħiet ta' proċedura remota gRPC) 10 GiB
SeaweedFS 4.48 Apache-2.0 Ħażna ta' oġġetti għall-fajls, kompatibbli ma' Amazon Simple Storage Service (S3) 8333 50 GiB
OpenBao 2.6 MPL-2.0 Il-key store u l-unsealer tiegħu, għal nexus-keys 8200 5 GiB u 1 GiB

Xi għażliet ħadu post xi ħaġa aktar familjari. Valkey jidħol minflok Redis 7.4, li r-rilaxx jirrifjuta l-liċenzji attwali tiegħu. MinIO huwa AGPL-3.0, għalhekk il-ħażna tal-oġġetti hija SeaweedFS. GraphRAG jilħaq Neo4j Community Edition permezz ta' Bolt, protokoll tan-netwerk, u s-servizzi jilħqu PostGIS permezz tal-protokoll PostgreSQL, għalhekk il-GPL tibqa' ma' kull wieħed minnhom. OpenBao huwa l-fork tal-Linux Foundation ta' Vault minn qabel il-bidla fil-liċenzja ta' Vault.

Kull ħażna taħdem bl-awtentikazzjoni mixgħula u bi kredenzjali ġġenerati: password għal Valkey, API key għal Qdrant, access keys għal SeaweedFS.

Kull waħda mill-ħames ħażniet taħt dataTier taħdem fil-cluster (mode: in-cluster, l-awtomatiku) jew hija waħda li diġà tħaddmu intom (mode: external, b'external.host u Secret imsemmi minn external.existingSecret). Għal PostgreSQL estern, issettjaw sslmode għal verify-full jew verify-ca, u poġġu ċ-ċertifikat tal-awtorità taċ-ċertifikati (CA) tas-server f'dak is-Secret; il-kapitlu 2.11, Varjazzjonijiet: ħażniet esterni, TLS u ingress, fih id-dettalji.

# 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

Il-par ta' OpenBao huwa l-eċċezzjoni: dejjem jaħdem ġewwa l-installazzjoni, għaliex il-Job tal-kustodja jinizjalizzah hemmhekk.

L-identità bejn is-servizzi

Nexus jaħdem mingħajr service mesh. Il-mutual TLS jiġi minn awtorità taċ-ċertifikati (CA) lokali li ċ-chart toħloq permezz ta' cert-manager, li jrid jiġi installat l-ewwel (v1.21.3 huwa ttestjat).

Issuer iffirmat minnu nnifsu jagħmel ċertifikat CA wieħed, nexus-local-ca, ECDSA (Elliptic Curve Digital Signature Algorithm) P-256, validu għal għaxar snin. It-tieni Issuer jiffirma b'dik is-CA. Kull workload li jsejjaħ server TLS ġewwa l-installazzjoni jikseb iċ-ċertifikat tal-klijent tiegħu stess, imsejjaħ <service-account>-client-tls, validu għal 90 jum u mġedded 15-il jum qabel ma jiskadi. L-uniku isem tiegħu huwa identifikatur uniformi tar-riżorsi (URI) fil-forma ta' identità SPIFFE:

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

Kull workload isib iċ-ċertifikat pubbliku tas-CA bħala ca.crt fis-Secret taċ-ċertifikat tiegħu stess. L-ebda pod ma jimmonta l-key tas-CA, u m'għandkomx bżonn ta' trust-manager.

Tliet servizzi jivverifikaw il-callers biċ-ċertifikat. nexus-auth jagħmel dan fuq it-tieni listener tiegħu, il-port 8443, u kull caller ġewwa l-cluster iċempel lil dak. nexus-keys jagħmel dan fuq l-uniku listener tiegħu. Probitas iservi t-TLS miċ-ċertifikat tiegħu stess, nexus-probitas-tls, li jerġa' jaqrah meta cert-manager iġeddu. Ħadd minnhom ma jafda header X-Forwarded-Client-Cert.

Kull workload jikseb ukoll tokens ta' Kubernetes ta' siegħa f'/var/run/secrets/nexus, wieħed għal kull servizz li jsejjaħ, b'dak is-servizz bħala l-udjenza. Il-ConfigMap nexus-service-identities jimmappja kull <namespace>/<service-account> ma' isem ta' servizz jew plugin, u workload nieqes minnu m'għandu l-ebda identità u jiġi rrifjutat. L-orchestrator u Probitas jiċċekkjaw dawn it-tokens mal-API ta' Kubernetes. Mis-servizzi li jkunu qed jaħdmu, dawk it-tnejn biss iżommu system:auth-delegator jew għandhom API token immuntat; l-uniku workload ieħor b'token huwa l-Job tal-kustodja li jaħdem waqt l-installazzjoni.

Il-politika tan-netwerk tagħlaq dak li ma tagħlaqx l-identità. Iċ-chart tibda minn ċaħda awtomatika, u mbagħadidaħħal it-traffiku bejn il-pods tal-installazzjoni stess, id-DNS (Domain Name System), in-namespace tal-ingress controller (networkPolicy.ingressNamespace, kube-system awtomatikament) lejn it-tliet Services pubbliċi, u l-API server għaż-żewġ reviżuri tat-tokens. Il-pods ta' OpenBao iġorru tikketta differenti mill-bqija tal-pjattaforma, għalhekk ir-regola miftuħa ġewwa n-namespace ma tilħaqhomx: nexus-keys, il-Jobs tiegħu u l-Job tal-kustodja biss jgħaddu, fuq il-port 8200. Kull ħaġa oħra li workload irid jilħaq barra n-namespace, bħall-mail relay tagħkom, tmur f'networkPolicy.externalEgressCIDRs, li huwa vojt awtomatikament.

Il-migrazzjonijiet u r-reġistru tal-iskema

Il-migrazzjonijiet jaħdmu bħala hooks ta' Helm, fuq post-install u pre-upgrade. Hook ta' post-install jaħdem wara li jkunu nħolqu d-Deployments tar-rilaxx. Għalhekk fl-ewwel installazzjoni s-servizzi jibdew waqt li l-iskemi tagħhom ikunu għadhom ma jeżistux, u kienu jidħlu fi crash-loop kontra database mingħajr rwol, mingħajr password u mingħajr tabelli. Nexus jevita dan b'ledger.

Il-hooks jaħdmu fl-ordni tal-piż, u Helm jistenna lil kull Job qabel ma jibda l-piż li jmiss:

Piż Hook X'jagħmel
-30 nexus-migrations-env u rekwiżiti preliminari Joħloq is-Secret għall-hook biss bil-kredenzjali tal-migrator, u dak kollu li jaqra l-Job tal-kustodja
-20 nexus-db-bootstrap Joħloq id-databases nexus u nexus_alpha, ir-rwol tal-migrator, ir-rwol tar-runtime ta' kull servizz, l-estensjonijiet u l-ledger
-15 nexus-openbao-custody-init Jinizjalizza l-key store u l-unsealer u joħloq l-identità tal-installazzjoni
-12 nexus-graphrag-migrations L-iskema ta' GraphRAG, li hija s-sid tal-oġġetti li tirreferi għalihom il-linja bażi ta' nexus-auth
-10 nexus-auth-migrations L-iskema tal-identità
-5 Migrazzjonijiet tal-orchestrator, tal-gateway u ta' Probitas L-iskemi tagħhom; Probitas jiċċekkja li t-tabelli tal-auth jeżistu l-ewwel
0 nexus-alpha-bff-migrations Id-database tal-console stess

Kull Job ta' migrazzjoni għandu backoffLimit: 0, għalhekk migrazzjoni li tfalli tfalli l-installazzjoni.

Il-ledger huwa tabella waħda, nexus_release.schema_applied, b'ringiela għal kull katina u image digest. Kull hook jikteb ir-ringiela tiegħu biss wara li jkun irritorna l-migration runner tiegħu. Kull Deployment li juża PostgreSQL iġorr init container, wait-for-schema, li jaqra dik it-tabella bħala rwol li jitħalla jaqra xejn ieħor (nexus_ledger_reader) u jistenna sakemm kull katina li jiddependi fuqha turi ringiela għall-immaġni ta' dan ir-rilaxx. Imbagħad jibda s-servizz. Il-worker tal-workflows jistenna l-katina tal-orchestrator, peress li jaqsam dik id-database, u l-iskills engine jistenna biss il-bootstrap.

Jagħmel polling kull 3 sekondi (schemaWait.intervalSeconds) u jaqta' qalbu wara 1,800 (schemaWait.timeoutSeconds) b'linja li ssemmi l-ktajjen li jkunu għadhom nieqsa. Il-container tas-servizz stess qatt ma jibda kontra skema ħażina.

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

Huwa għalhekk li qatt m'għandkom tħaddmu helm install --wait. B'--wait, Helm jistenna d-Deployments qabel ma jħaddem il-hooks ta' post-install, u d-Deployments jistennew il-hooks. L-ebda wieħed ma jiċċaqlaq. Installaw mingħajru u stennew wara; il-kapitlu 2.6, L-installazzjoni ta' Community fuq Kubernetes, jagħti l-kmand eżatt.

L-iżolament fuq tliet assi

Kull qari, kitba, sejħa ta' għodda u dispatch ta' skill f'Nexus huwa limitat fuq tliet assi.

Assi Qasam X'jifred
Tenant organization_id Organizzazzjoni waħda minn oħra, konfini iebes
Sid owner_user_id L-affarijiet ta' persuna waħda minn ta' kulħadd, anke ġewwa organizzazzjoni waħda
Unità business_unit_id Suddiviżjoni ta' organizzazzjoni, fakultattiva

L-assi tas-sid jissorprendi lin-nies. Kaxxa tal-ittri jew notebook personali huma privati għas-sid tagħhom anke mill-kollegi fl-istess unità bl-istess rwol. Amministratur jistabbilixxi l-politika u ma jaqrax il-kontenut.

L-assi jiġu mit-talba awtentikata u minn imkien ieħor. L-ebda varjabbli tal-ambjent, header, parametru ta' query jew segment ta' mogħdija ma jista' jissettjahom. Korp ta' talba li jsemmi organizzazzjoni jiġi rrifjutat b'TENANT_NOT_A_PARAMETER. Wiċċ li ma jistax jiddikjara ma' liema tenant, sid u unità tappartjeni ringiela jirrifjuta b'403 SCOPE_PREDICATE_MISSING, u l-korp jelenka liema assi ġew riżolti u liema le. Qatt ma jaqa' lura għal qari usa'.

Dan jgħodd f'żewġ postijiet f'daqqa.

Fid-database. Kull servizz jikkonnettja bħala r-rwoli tar-runtime tiegħu stess: nexus_auth, auth_app u auth_platform għas-servizz tal-identità, nexus_probitas u nexus_probitas_ledger għal Probitas, u nexus_gateway, nexus_graphrag, nexus_skills, orchestrator_app, workflows_app u l-bqija għall-oħrajn. Ħadd minnhom mhu superuser jew għandu BYPASSRLS. Ħadd minnhom mhu s-sid tat-tabelli li juża lanqas, għalhekk kull politika ta' sigurtà fil-livell tar-ringiela (RLS) tapplika għalih. Ir-rwoli jaqsmu grupp, nexus_runtime, li jagħti konnessjoni u użu tal-iskema u l-ebda dritt fuq it-tabelli; kull servizz jingħata t-tabelli tiegħu stess mill-migrazzjonijiet tiegħu stess. Is-settings tat-tenant li jaqraw il-politiki tal-RLS jistgħu jiġu ssettjati biss permezz tal-funzjoni bind_scope ta' kull servizz, li taħdem bħala s-sid tagħha. Il-bootstrap jirrevoka set_config minn kulħadd, u l-orchestrator u Probitas jirrifjutaw li jibdew jekk ir-rwol tar-runtime tagħhom ikun jista' jsejjaħha direttament (Probitas isemmi dan DB_ROLE_SETS_SCOPE_DIRECTLY). L-uniċi konnessjonijiet ta' superuser fl-installazzjoni kollha jappartjenu lill-Job tal-bootstrap u lill-pass ta' forniment tal-BFF.

Fil-primittiva kondiviża ta' query b'ambitu. Kull repożitorju fil-pjattaforma u kull plugin mibni fuq l-SDK (software development kit) jiret ilqugħ wieħed li jibni l-predikat SQL minn ambitu riżolt. Il-funzjoni tal-ambitu tiegħu tieħu l-identità vverifikata u m'għandha l-ebda parametru tal-organizzazzjoni, għalhekk caller ma jistax jgħaddi wieħed, u l-ebda rotta ma tista' toħroġ minnha.

Hemm eżattament qsim wieħed tal-konfini tat-tenant, u huwa dejjaq: għotja rreġistrata. Żewġ persuni fl-organizzazzjoni li żżomm ir-ringieli jirreġistraw liema organizzazzjoni tista' taqra liema tabelli, u sa meta. Kull qari jaħdem fi tranżazzjoni li tinqara biss u jiġi rreġistrat fiż-żewġ tenants. Is-sidien u l-amministraturi qatt ma jaqraw min-naħa għall-oħra, u l-qarrej ma jistax iwessa' għotja.

Il-mogħdija tal-IA

Il-callers jesprimu xewqat. L-AI Provider Router huwa s-sid tal-kredenzjali u jagħmel l-għażla finali.

Kull sejħa ta' mudell f'Nexus tgħaddi mir-rotot /internal/ai/* tar-router, u r-router idaħħal biss callers imsemmija. Iċ-chart tissettja tliet listi fuq il-gateway:

Rotot Min jista' jsejjaħ
Chat u streaming taċ-chat nexus-orchestrator, nexus-workflows, nexus-skills-engine
Embeddings u rerank nexus-graphrag, nexus-skills-engine, nexus-workflows
Kull ħaġa oħra, inkluża l-eżekuzzjoni tal-għodod nexus-orchestrator, nexus-workflows

Sejħa mingħajr identità tal-caller tiġi rrifjutata b'403 MISSING_CALLER_IDENTITY, u caller li mhux fuq il-lista b'403 UNAUTHORIZED_CALLER. Il-plugins mhumiex fuq l-ebda lista, u dan huwa apposta: is-sejħiet tal-mudelli ta' plugin iseħħu f'ismu, permezz ta' UNO dispatch.

Dak li caller jista' jibgħat huwa xewqa: fornitur u mudell ippreferuti, flimkien ma' profil ta' kapaċità bħal tul minimu tal-kuntest jew użu ta' għodod. Ir-router jonora xewqa biss meta l-organizzazzjoni jkollha dak il-fornitur attivat u bil-kredenzjali; inkella jissostitwixxi, l-ewwel fi ħdan l-istess fornitur, imbagħad fost il-fornituri l-oħra tal-organizzazzjoni. Profil ta' kapaċità jiffiltra biss, u rekwiżit ta' residenza tad-data fih huwa iebes. Meta xejn ma jkun jgħodd, m'hemm l-ebda mudell ta' riżerva: il-caller jikseb 422 MODEL_CAPABILITY_UNAVAILABLE jew 422 NO_PROVIDER_FOR_ROLE, bi string ta' rimedju li l-console turi lil amministratur.

Il-keys jappartjenu lill-organizzazzjoni. L-amministraturi ta' kull organizzazzjoni jpoġġu l-provider keys tagħhom stess fil-pool tagħha mill-console, u r-router jirriżolvihom fil-ħin tas-sejħa. L-ebda model key mhu valur taċ-chart u l-ebda wieħed ma jiġi ma' Nexus. Organizzazzjoni mingħajr key ma tikseb l-ebda tweġiba tal-IA, u l-console tgħid dan b'mod ċar; xejn ma jimla l-vojt minn x'imkien ieħor.

Żewġ valuri taċ-chart isawru r-router. ai.localProvider.baseUrl jelenka server tal-mudell kompatibbli ma' OpenAI li tħaddmu intom, devjat bħal kull fornitur ieħor. ai.installationHosts jelenka s-servers tal-mudelli tagħkom fuq ismijiet privati, li r-router jgħoddhom bħala li jinsabu ġewwa l-installazzjoni. GraphRAG jagħmel l-embeddings permezz tar-router ukoll, f'isem l-organizzazzjoni li tagħha huwa l-kontenut. Il-mudell ta' embedding awtomatiku jaħdem fil-cluster mingħajr graphics card; l-embeddings ospitati huma l-għażla ta' kull organizzazzjoni.

L-ebda telemetrija

Xejn ma joħroġ minn installazzjoni sakemm ma tibagħtuhx intom. Il-valur telemetry.enabled taċ-chart jista' jkun biss false; l-iskema tirrifjuta kull ħaġa oħra. Ir-rappurtar tal-livell tad-data stess huwa mitfi wkoll: ir-rapport tal-użu ta' Neo4j u t-telemetrija ta' Qdrant huma diżattivati fiċ-chart.

B'networkPolicy.enabled mixgħul, li hu l-issettjar awtomatiku, l-ebda pod ma jista' jilħaq l-internet sakemm ma telenkawx id-destinazzjoni f'networkPolicy.externalEgressCIDRs. Fornitur ta' mudell ospitat huwa destinazzjoni bħal din, u l-istess huwa l-mail relay tagħkom.

L-istess regola bidlet issettjar awtomatiku wieħed li se tinnotaw. Il-CAPTCHA ta' nexus-auth għar-reġistrazzjonijiet jeħtieġ servizz tal-internet, għalhekk fuq installazzjoni huwa mitfi, u r-reġistrazzjoni ta' barrani tistenna l-approvazzjoni ta' amministratur (403 SIGNUP_REQUIRES_APPROVAL). L-iskrinjar li jimblokka r-reġistrazzjonijiet minn netwerks ta' hosting huwa mitfi wkoll, minħabba li jeħtieġ databases liċenzjati li Nexus ma jinkludix. Dak l-iskrinjar intom tilfuh.

Kif sejra l-installazzjoni
Kif sejra l-installazzjoni
Fuq Enterprise, il-paġna tas-saħħa turi l-cluster taħt Nexus: kemm hi okkupata kull parti u kemm fadal kapaċità, b'kull twissija ħdejn x'għandkom tagħmlu dwarha.