Logg innBestill en gjennomgang

Kapittel 2.1

Arkitektur

Hva hver tjeneste i Nexus-chartet eier og hvilke datalagre som ligger under den, samt reglene som holder dem sammen, fra identitet mellom tjenester til veien hvert modellkall tar.

Denne siden er oversatt med KI fra den engelske originalen. Hvis noe er uklart, er den engelske siden referansen. Les denne siden på engelsk

19 minutter å lese

Da Tomás Reilly fullførte den første installasjonen hos Harrow Port Authority, viste kubectl -n nexus get pods ti Deployments og sju StatefulSets, pluss tre CronJobs. Migrasjons-Jobs som bygde databasen, var allerede borte, fordi hver av dem sletter seg selv når den lykkes. Den listen utgjør hele plattformen. Lær den, for de fleste dag-to-spørsmål starter med «hvilken av disse eier det?»

Dette kapittelet besvarer det for hver del, følger én forespørsel gjennom dem, og dekker deretter reglene de alle følger. Resten av del 2 bygger på dette bildet.

Tjenestene og hva hver enkelt eier

Chartet er ett Helm-chart, nexus, versjon 1.0.0-alpha.1, for Kubernetes 1.33 eller nyere. Hver arbeidsbelastning kjører under sin egen ServiceAccount, som en ikke-root-bruker, med alle Linux-capabilities fjernet. Kall til tjenestene som vokter identitet og nøkler, går over gjensidig TLS (Transport Layer Security), og det offentlige API-et (applikasjonsprogrammeringsgrensesnittet) deler prosess med KI-ruteren (kunstig intelligens).

Komponent Deployment og Service Service-port Hva den eier
Konsoll nexus-alpha 3000 Sidene folk ser; leverer HTML (Hypertext Markup Language) på konsollverten
BFF (backend for frontend) nexus-alpha-bff 8080 Konsollens egne data, menyen hver person får, utgivelsesregisteret
Autentisering nexus-auth 9101 (gjensidig TLS på 8443) Personer, organisasjoner, økter, tokener, API-nøkler, organisasjonens samling av modellnøkler
Gateway nexus-gateway 9092, WebSocket 8093 AI Provider Router, og det offentlige API-endepunktet for REST (representational state transfer) og MCP (Model Context Protocol)
Orkestrator nexus-orchestrator 8080 UNO-utsendelse: tar imot hver jobb og legger den i kø
Arbeidsflyter nexus-workflows 8081 UNO-utførelse: arbeideren som kjører jobber fra køen
GraphRAG nexus-graphrag 8090, WebSocket 8091 Minne: kunnskapsgrafen og gjenfinning over den
Probitas nexus-probitas 9151 (HTTPS) Bevis: styringsoppføringer og den forseglede hovedboken
Ferdighetsmotor nexus-skills-engine 8095 Ferdighetsbiblioteket; finne og kjøre ferdigheter
Nøkler nexus-keys 8080 (HTTPS, gjensidig TLS) Nøkler per organisasjon i OpenBao, forvaring, installasjonsidentiteten
Programtillegg nexus-plugins 9111 Programtilleggsregisteret og katalogoppføringer; av som standard
Filbehandling nexus-fileprocess 9109 Lesing av opplastede dokumenter og bilder; av som standard

De første ti er påkrevde. De to siste er valgfrie, og slås på med components.plugins.enabled og components.fileprocess.enabled der en Enterprise-installasjon eller en domenepakke bruker dem. Én valgfri tjeneste til, nexus-alive på port 8080, har sin egen bryter, components.alive.enabled, og er også av som standard. Replikater og ressurser for hver av dem ligger under components.<name>.

Konsollen består av servergenererte sider uten database. Den snakker med BFF-en og med nexus-auth inne i klyngen, aldri ut gjennom den offentlige auth-verten og inn igjen. Den nekter å starte opp uten utgaven sin, som chartet sender som NEXUS_EDITION fra den ene edition-verdien. Hvert medlem av en organisasjon arbeider i den i henhold til sin rolle. Administrasjonssidene er for eiere og administratorer, og et medlem som åpner en slik side, får siden «Ikke en administrator».

BFF-en er konsollens serverdel og er bygget som et programtillegg til plattformen, registrert som produktet Nexus Alpha. Den holder konsollens egne tabeller i en separat database, nexus_alpha, og den avgjør hvilke menygrupper en person ser. Når konsollen trenger å få arbeid utført, spør BFF-en tjenesten som eier det.

nexus-auth er skrevet i Go og er den eneste tjenesten som utsteder tokener. Tilgangstokener varer i 15 minutter og oppdateringstokener i 12 timer som standard (auth.accessTokenTTL, auth.refreshTokenTTL). Den begrenser hver innlogget person til 5 000 forespørsler i minuttet før den svarer med 429 (auth.rateLimitPerMinute). Den kjører to lyttere: den vanlige på konteinerport 8080 som den offentlige Ingress-en når, og en med gjensidig TLS på 8443 som alle kallere inne i klyngen må bruke. Den stoler på X-Forwarded-For kun fra hoppene i proxy.trustedCIDRs, en liste over Classless Inter-Domain Routing (CIDR)-områder, som har 10.42.0.0/16 som standard, k3s-podnettverket. Hvis ingress-kontrolleren din kjører et annet sted, må du endre den. Ellers ser det ut som om hver innlogging kom fra kontrolleren.

Gatewayen har to oppgaver som deler én prosess. Inne i klyngen er den AI Provider Router (KI-sentralbordet i del 1 og på konsollens sider), den eneste som sitter på en organisasjons modellakkreditiver (mer om det nedenfor). Ved kanten er den det api.<domain> når: REST-klienter og MCP-klienter, hvis tokener bærer mottakeren (audience) https://<hosts.api>/mcp og kommer fra OAuth 2.1-autorisasjonsserveren på auth-verten (OAuth er den åpne standarden for delegert autorisasjon).

Orkestratoren og arbeidsflyter utgjør sammen UNO, arbeidsflytmotoren. All beregning kjører gjennom dem. Orkestratoren tar imot en jobb på POST /api/v1/dispatch, svarer 202 med en jobId, runId og traceId, og legger den i kø. Det finnes ingen direkte utførelsesvei: en klient spør alltid GET /api/v1/dispatch/{jobId} jevnlig eller tar imot et tilbakekall. Arbeidsflytarbeideren henter jobber fra køen, fire om gangen per replikat som standard (workflows.concurrency), og har nøyaktig én HTTP-rute, GET /health.

Probitas er bevistjenesten. Den leverer TLS selv, fra et sertifikat som chartet utsteder, og lagrer tabellene sine i trust-skjemaet med en egen rolle for hovedboken. Styringsfunksjonene dens slås av og på med probitas.flags. Flere leveres i shadow-modus: avgjørelsen beregnes og registreres, og ingenting blokkeres før du endrer flagget.

nexus-keys er plattformens nøkkeltjeneste, skrevet i Go. Den lagrer én nøkkel per organisasjon i et OpenBao-nøkkellager og roterer dem hver natt. Nattjobbene dens destruerer også nøkler der utløpsdatoen for oppbevaring er nådd, og eksporterer kvitteringene til et eget volum. Sletting av en organisasjons nøkkel gjør dataene som er låst med den, uleselige for godt. Den utsteder også installasjonsidentiteten ved første oppstart (bootstrap), under keys.installationName, og det navnet er permanent. Velg det med omhu: chartet avviser et tomt navn (INSTALLATION_NAME_MISSING) og avviser navnet i sine egne eksempelverdier (INSTALLATION_NAME_EXAMPLE).

Denne installasjonen (Community)
Denne installasjonen (Community)
En Community-installasjons egen side viser versjonen og motorens helsetilstand. Den sier tydelig at ingen lisens er nødvendig. Enterprise-delene av siden vises som smakebiter.

Tre offentlige verter

Chartet publiserer nøyaktig tre vertsnavn, som til sammen utgjør installasjonsidentiteten. Hver tjeneste nekter å starte opp uten dem.

Ingress Vertsverdi 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

Eksemplene i denne boken bruker console.harrow.example, api.harrow.example og auth.harrow.example. Ingress-ene er vanlige networking.k8s.io/v1-objekter med én regel hver, sti /. TLS ved kanten følger tls.mode: existing (en Secret du har opprettet, navngitt i tls.existingSecret), cert-manager (en ClusterIssuer du kjører, navngitt i tls.clusterIssuer) eller none (TLS avsluttes foran klyngen). Chartet legger ikke til noen egen videresending, så en ACME (Automated Certificate Management Environment) HTTP-utfordring når løseren din uendret. Kapittel 2.11, Variasjoner: eksterne lagre, TLS og ingress, dekker hver modus.

Ingenting annet er eksponert. Datalagrene, OpenBao og hver interne tjeneste lytter kun inne i navnerommet.

Tre horisontale bånd. Det øverste båndet er «Edge» med tre Ingress-bokser merket console, api og auth, som hver peker ned til sin Service (nexus-alpha :3000, nexus-gateway :9092, nexus-auth :9101). Det midterste båndet er «Platform services»: en boks for nexus-alpha-bff; nexus-orchestrator ved siden av nexus-workflows, gruppert og merket UNO; deretter nexus-graphrag, nexus-probitas, nexus-skills-engine, nexus-keys; og to stiplede bokser for de valgfrie nexus-plugins og nexus-fileprocess. Det nederste båndet er «Data tier» med én boks per lager (PostgreSQL, Valkey, Neo4j, Qdrant, SeaweedFS), og en egen inngjerdet boks merket «Key store» som inneholder openbao og openbao-unsealer, og som kun nås av nexus-keys.
Komponentene i en Nexus-installasjon og lagrene under dem.

En forespørsel, fra ende til annen

Her er det som skjer når Aoife Brennan, IT-sjef ved Harrow, åpner konsollen og stiller assistenten et spørsmål om denne månedens kaiplan.

  1. Nettleseren hennes laster https://console.harrow.example. nexus-console-Ingress-en sender den til nexus-alpha på port 3000.
  2. Hun logger inn med passnøkkelen sin. Innloggingssidene snakker med nexus-auth gjennom auth.harrow.example, og nexus-auth utsteder et tilgangstoken til henne som inneholder brukeren hennes, organisasjonen hennes og, når økten hennes har en, forretningsenheten hennes.
  3. Konsollens server kaller BFF-en, som sjekker tokenet hennes og spør nexus-auth om organisasjonen hennes har produktet og om rollen hennes har adgang. Den svarer med menygruppene hun får se.
  4. Spørsmålet hennes går fra BFF-en til orkestratorens utsendelsesrute, med organisasjonen og brukeren hennes hentet fra det verifiserte tokenet. Orkestratoren svarer 202 og legger jobben i en kø i Valkey.
  5. En arbeidsflytarbeider tar jobben. Ferdigheten den kjører, slås opp av ferdighetsmotoren, og gjenfinning i Harrows dokumenter går til GraphRAG, som leser Neo4j, Qdrant og sitt eget PostgreSQL-skjema.
  6. Modellkallet går til AI Provider Router på /internal/ai/chat. Ruteren velger leverandøren og modellen fra Harrows egen nøkkelsamling og rutingspolicy, utfører kallet med Harrows nøkkel og returnerer svaret.
  7. Resultatet lander på jobbens kjørerad. BFF-en leser det, og konsollen viser svaret med kildehenvisninger.

Tjeneste-til-tjeneste-hoppene bærer projiserte tjenestetokener, kallene til nexus-auth, nexus-keys og Probitas går over TLS fra installasjonens egen sertifikatautoritet, og hver datatilgang i trinn 4 til 6 er avgrenset til Harrows organisasjon i selve databasen. Avsnittene nedenfor forklarer begge deler.

En sekvens fra venstre mot høyre. En nettleserboks sender «1 page» til Ingress console, deretter til nexus-alpha. En sidepil «2 sign-in» går fra nettleseren gjennom Ingress auth til nexus-auth. nexus-alpha sender «3 menu» til nexus-alpha-bff, som sjekker med nexus-auth. nexus-alpha-bff sender «4 dispatch, 202» til nexus-orchestrator, som skriver til et Valkey-køikon. nexus-workflows henter «5 job» fra køen og kaller nexus-skills-engine og nexus-graphrag (de tre lagrene dens er tegnet under GraphRAG). nexus-workflows sender «6 chat» til nexus-gateway, merket «AI Provider Router: organisation key pool», som sender en enkelt pil ut av klyngegrensen til «model provider». En stiplet returpil «7 result on run row» går tilbake til nexus-alpha-bff.
Ett spørsmål til assistenten, fra nettleseren til modelleverandøren og tilbake.

Datalaget

Nexus leverer sin egen signerte kopi av hvert lager, med kildekodetilbudet for hver av dem i pakken. Hvert lager ble valgt like mye for lisensen sin som for funksjonen.

Lager Versjon Lisens Hvorfor det er der Havn Standardvolum
PostgreSQL med PostGIS og pgvector PostgreSQL 16, PostGIS 3, pgvector 0.8 PostgreSQL-lisens; PostGIS GPL-2.0-or-later Hovedkilden (system of record) for hver tjeneste; PostGIS for kartdata; pgvector for vektorer lagret ved siden av rader 5432 50 GiB
Valkey 8.1 BSD-3-Clause UNO-jobbkøene og kortvarige hurtiglagre, som hurtiglageret for API-nøkler i nexus-auth 6379 5 GiB
Neo4j Community Edition 5.26 GPL-3.0 Kunnskapsgrafen som GraphRAG bygger og traverserer 7687 (Bolt) 20 GiB
Qdrant 1.15 Apache-2.0 Vektorsøk for GraphRAG og ferdighetsmotoren 6333 (HTTP), 6334 (gRPC fjernprosedyrekall) 10 GiB
SeaweedFS 4.48 Apache-2.0 Objektlagring for filer, kompatibel med Amazon Simple Storage Service (S3) 8333 50 GiB
OpenBao 2.6 MPL-2.0 Nøkkellageret og opplåseren dets, for nexus-keys 8200 5 GiB og 1 GiB

Noen valg erstattet noe mer kjent. Valkey erstatter Redis 7.4, hvis nåværende lisenser utgivelsen avviser. MinIO er AGPL-3.0, så objektlageret er SeaweedFS. GraphRAG når Neo4j Community Edition over Bolt, en nettverksprotokoll, og tjenestene når PostGIS over PostgreSQL-protokollen, slik at GPL-lisensen forblir hos hver av dem. OpenBao er Linux Foundations forgrening av Vault fra før Vaults lisensendring.

Hvert lager kjører med autentisering påslått og genererte akkreditiver: et passord for Valkey, en API-nøkkel for Qdrant, tilgangsnøkler for SeaweedFS.

Hvert av de fem lagrene under dataTier kjører i klyngen (mode: in-cluster, standarden) eller er et du allerede drifter (mode: external, med external.host og en Secret navngitt av external.existingSecret). For en ekstern PostgreSQL setter du sslmode til verify-full eller verify-ca, og legger serverens sertifikatautoritetssertifikat (CA-sertifikat) i den Secret-en; kapittel 2.11, Variasjoner: eksterne lagre, TLS og ingress, har detaljene.

# 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-paret er unntaket: det kjører alltid inne i installasjonen, fordi forvarings-Job-en initialiserer det der.

Identitet mellom tjenester

Nexus kjører uten en service mesh. Gjensidig TLS kommer fra en lokal sertifikatautoritet (CA) som chartet oppretter gjennom cert-manager, som må installeres først (v1.21.3 er testet).

En selvsignert Issuer lager ett CA-sertifikat, nexus-local-ca, ECDSA (Elliptic Curve Digital Signature Algorithm) P-256, gyldig i ti år. En annen Issuer signerer med den CA-en. Hver arbeidsbelastning som kaller en TLS-server inne i installasjonen, får sitt eget klientsertifikat, kalt <service-account>-client-tls, gyldig i 90 dager og fornyet 15 dager før utløp. Dets eneste navn er en Uniform Resource Identifier (URI) i SPIFFE-identitetsform:

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

Hver arbeidsbelastning finner CA-ens offentlige sertifikat som ca.crt i sin egen sertifikat-Secret. Ingen pod monterer CA-ens nøkkel, og du trenger ikke trust-manager.

Tre tjenester verifiserer kallere ved hjelp av sertifikat. nexus-auth gjør det på sin andre lytter, port 8443, og hver kaller inne i klyngen kaller den. nexus-keys gjør det på sin eneste lytter. Probitas leverer TLS fra sitt eget sertifikat, nexus-probitas-tls, som den leser inn på nytt når cert-manager fornyer det. Ingen av dem stoler på en X-Forwarded-Client-Cert-header.

Hver arbeidsbelastning får også én-times Kubernetes-tokener på /var/run/secrets/nexus, ett per tjeneste den kaller, med den tjenesten som mottaker (audience). ConfigMap-en nexus-service-identities kobler hver <namespace>/<service-account> til et tjeneste- eller programtilleggsnavn, og en arbeidsbelastning som mangler i den, har ingen identitet og blir avvist. Orkestratoren og Probitas sjekker disse tokenene mot Kubernetes API-et. Av de kjørende tjenestene er det bare disse to som har system:auth-delegator eller har et API-token montert; den eneste andre arbeidsbelastningen med et token er forvarings-Job-en som kjører ved installasjon.

Nettverkspolicy stenger det identitet ikke stenger. Chartet starter med standard avvisning (default deny), og slipper deretter gjennom trafikk mellom installasjonens egne podder, DNS (Domain Name System), ingress-kontrollerens navnerom (networkPolicy.ingressNamespace, kube-system som standard) til de tre offentlige Services, og API-serveren for de to token-kontrollørene. OpenBao-poddene har en annen etikett enn resten av plattformen, så den åpne regelen inne i navnerommet når dem ikke: kun nexus-keys, dens Jobs og forvarings-Job-en slipper gjennom, på port 8200. Alt annet en arbeidsbelastning må nå utenfor navnerommet, slik som e-postreléet ditt, legges inn i networkPolicy.externalEgressCIDRs, som er tom som standard.

Migreringer og skjemaregisteret

Migrasjoner kjører som Helm-hooks, på post-install og pre-upgrade. En post-install-hook kjører etter at utgivelsens Deployments er opprettet. Så ved en førstegangsinstallasjon starter tjenestene mens skjemaene deres ennå ikke eksisterer, og de ville ha gått i en krasjløkke mot en database uten rolle, uten passord og uten tabeller. Nexus unngår dette med en hovedbok.

Hook-ene kjører i vektrekkefølge, og Helm venter på hver Job før neste vekt starter:

Vekt Hook Hva den gjør
-30 nexus-migrations-env og forutsetninger Oppretter Secret-en som kun brukes av hooks, med migratorens akkreditiver, og alt forvarings-Job-en leser
-20 nexus-db-bootstrap Oppretter databasene nexus og nexus_alpha, migratorrollen, hver tjenestes kjøretidsrolle, utvidelsene og hovedboken
-15 nexus-openbao-custody-init Initialiserer nøkkellageret og opplåseren og utsteder installasjonsidentiteten
-12 nexus-graphrag-migrations GraphRAGs skjema, som eier objekter grunnlinjen til nexus-auth refererer til
-10 nexus-auth-migrations Identitetsskjemaet
-5 migrasjoner for orkestrator, gateway og Probitas Skjemaene deres; Probitas sjekker først at auth-tabellene eksisterer
0 nexus-alpha-bff-migrations Konsollens egen database

Hver migrasjons-Job har backoffLimit: 0, så en mislykket migrasjon gjør at installasjonen feiler.

Hovedboken er én tabell, nexus_release.schema_applied, med én rad per kjede og bilde-digest. Hver hook skriver raden sin først etter at migrasjonskjøreren har returnert. Hver Deployment som bruker PostgreSQL, har en init-konteiner, wait-for-schema, som leser den tabellen som en rolle som ikke har tillatelse til å lese noe annet (nexus_ledger_reader), og venter til hver kjede den er avhengig av, viser en rad for denne utgivelsens bilde. Deretter starter tjenesten. Arbeidsflytarbeideren venter på orkestratorens kjede, siden den deler den databasen, og ferdighetsmotoren venter kun på oppstartsjobben (bootstrap).

Den sjekker hvert 3. sekund (schemaWait.intervalSeconds) og gir opp etter 1800 (schemaWait.timeoutSeconds) med en linje som oppgir kjedene som fortsatt mangler. Tjenestens egen konteiner starter aldri mot et feil skjema.

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

Det er derfor du aldri må kjøre helm install --wait. Med --wait venter Helm på Deployments før den kjører post-install-hooks, og Deployments venter på hooks. Ingen av dem kommer videre. Installer uten det og vent etterpå; kapittel 2.6, Installere Community på Kubernetes, gir den nøyaktige kommandoen.

Isolering langs tre akser

Hver lesing, skriving, hvert verktøykall og hver ferdighetsutsendelse i Nexus er avgrenset langs tre akser.

Akse Felt Hva den skiller
Leietaker organization_id Én organisasjon fra en annen, en hard grense
Eier owner_user_id Én persons ting fra alle andres, selv inne i én organisasjon
Enhet business_unit_id En underavdeling av en organisasjon, valgfritt

Eieraksen overrasker folk. En postkasse eller en personlig notatbok er privat for eieren selv overfor kolleger i samme enhet med samme rolle. En administrator setter policy og leser ikke innhold.

Aksene kommer fra den autentiserte forespørselen og fra intet annet sted. Ingen miljøvariabel, header, spørreparameter eller stisegment kan sette dem. En forespørselskropp som navngir en organisasjon, blir avvist med TENANT_NOT_A_PARAMETER. En flate som ikke kan angi hvilken leietaker, eier og enhet en rad tilhører, avviser med 403 SCOPE_PREDICATE_MISSING, og kroppen lister opp hvilke akser som ble løst og hvilke som ikke ble det. Den faller aldri tilbake til en bredere lesing.

Dette gjelder på to steder samtidig.

I databasen. Hver tjeneste kobler til som sine egne kjøretidsroller: nexus_auth, auth_app og auth_platform for identitetstjenesten, nexus_probitas og nexus_probitas_ledger for Probitas, og nexus_gateway, nexus_graphrag, nexus_skills, orchestrator_app, workflows_app og resten for de andre. Ingen er superbruker eller har BYPASSRLS. Ingen eier tabellene den bruker heller, så hver policy for sikkerhet på radnivå (RLS) gjelder for den. Rollene deler en gruppe, nexus_runtime, som gir tilkoblings- og skjemabruk og ingen tabellrettigheter i det hele tatt; hver tjeneste tildeles sine egne tabeller av sine egne migrasjoner. Leietakerinnstillingene som RLS-policyer leser, kan kun settes gjennom hver tjenestes bind_scope-funksjon, som kjører som sin eier. Oppstartsjobben (bootstrap) tilbakekaller set_config fra alle andre, og orkestratoren og Probitas nekter å starte hvis kjøretidsrollen deres kunne kalle den direkte (Probitas kaller dette DB_ROLE_SETS_SCOPE_DIRECTLY). De eneste superbrukertilkoblingene i hele installasjonen tilhører oppstarts-Job-en og BFF-ens klargjøringstrinn.

I den delte primitiven for avgrensede spørringer. Hvert datalager (repository) i plattformen og hvert programtillegg bygget på SDK-et (programvareutviklingssettet) arver én avgrensning som bygger SQL-predikatet fra et løst omfang. Omfangsfunksjonen tar den verifiserte identiteten og har ingen organisasjonsparameter, så en kaller kan ikke sende en inn, og ingen rute kan velge det bort.

Det finnes nøyaktig én kryssing av leietakergrensen, og den er smal: en registrert tildeling. To personer i organisasjonen som eier radene, registrerer hvilken organisasjon som kan lese hvilke tabeller, og frem til når. Hver lesing kjører i en skrivebeskyttet transaksjon og logges hos begge leietakere. Eiere og administratorer leser aldri på tvers, og leseren kan ikke utvide en tildeling.

KI-banen

Kallere uttrykker ønsker. AI Provider Router eier akkreditivet og tar det endelige valget.

Hvert modellkall i Nexus går gjennom ruterens /internal/ai/*-ruter, og ruteren slipper kun inn navngitte kallere. Chartet setter tre lister på gatewayen:

Ruter Hvem som kan kalle
Chat og chat-strømming nexus-orchestrator, nexus-workflows, nexus-skills-engine
Innebygginger (embeddings) og omrangering nexus-graphrag, nexus-skills-engine, nexus-workflows
Alt annet, inkludert verktøyutførelse nexus-orchestrator, nexus-workflows

Et kall uten kalleridentitet avvises med 403 MISSING_CALLER_IDENTITY, og en kaller som ikke står på listen, med 403 UNAUTHORIZED_CALLER. Programtillegg står ikke på noen liste, og det er bevisst: et programtilleggs modellkall skjer på dets vegne, gjennom UNO-utsendelse.

Det en kaller kan sende, er et ønske: en foretrukket leverandør og modell, pluss en kapasitetsprofil som en minimum kontekstlengde eller verktøybruk. Ruteren oppfyller et ønske kun når organisasjonen har den leverandøren aktivert og lagt inn akkreditiver for den; ellers bytter den til et alternativ, først innenfor samme leverandør, deretter på tvers av organisasjonens andre leverandører. En kapasitetsprofil fungerer kun som et filter, og et krav om datalagringssted (data residency) i den er ufravikelig. Når ingenting passer, finnes det ingen reservemodell: kalleren får 422 MODEL_CAPABILITY_UNAVAILABLE eller 422 NO_PROVIDER_FOR_ROLE, med en løsningstekst som konsollen viser til en administrator.

Nøklene tilhører organisasjonen. Hver organisasjons administratorer legger sine egne leverandørnøkler inn i samlingen fra konsollen, og ruteren slår dem opp på kalltidspunktet. Ingen modellnøkkel er en chart-verdi, og ingen leveres med Nexus. En organisasjon uten nøkkel får ingen KI-svar, og konsollen sier dette rett ut; ingenting fyller tomrommet fra et annet sted.

To chart-verdier former ruteren. ai.localProvider.baseUrl navngir en OpenAI-kompatibel modellserver dere kjører, som rutes som enhver annen leverandør. ai.installationHosts lister opp modellserverne deres på private navn, som ruteren regner som interne i installasjonen. GraphRAG lager også innebygginger (embeddings) gjennom ruteren, som organisasjonen innholdet tilhører. Standardmodellen for innebygging kjører i klyngen uten grafikkort; vertsbaserte innebygginger er opp til hver enkelt organisasjon.

Ingen telemetri

Ingenting forlater en installasjon med mindre dere sender det. Chartets telemetry.enabled-verdi kan kun være false; skjemaet avviser alt annet. Datalagets egen rapportering er også slått av: Neo4js bruksrapport og Qdrants telemetri er deaktivert i chartet.

Med networkPolicy.enabled slått på, som er standard, kan ingen pod nå internett med mindre dere fører opp destinasjonen i networkPolicy.externalEgressCIDRs. En ekstern modelleverandør er en slik destinasjon, og det samme gjelder e-postreléet deres.

Den samme regelen endret en standardinnstilling dere vil legge merke til. nexus-auths CAPTCHA for registreringer krever en internettjeneste, så på en installasjon er den slått av, og en ukjent brukers registrering venter på godkjenning fra en administrator (403 SIGNUP_REQUIRES_APPROVAL). Filteret som blokkerer registreringer fra vertsnettverk er også slått av, fordi det krever lisensierte databaser som Nexus ikke leverer. Dere mister den utsilingen.

Hvordan det står til med installasjonen
Hvordan det står til med installasjonen
På Enterprise viser helsesiden klyngen under Nexus: hvor belastet hver del er og hvor mye kapasitet som gjenstår, med hver advarsel ved siden av hva som bør gjøres med den.