Verżjoni 1.0.0-alpha.1l-aħħar
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ż

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).
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.
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.
- Il-browser tagħha jgħabbi
https://console.harrow.example. L-Ingressnexus-consolejibgħatha lilnexus-alphafuq il-port 3000. - Hija tilloggja bil-passkey tagħha. Il-paġni tal-illoggjar jitkellmu ma'
nexus-authpermezz 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. - 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.
- 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.
- 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.
- 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. - 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.
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-postgresIl-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-schemaHuwa 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.

