Log indBook en briefing

Kapitel 2.1

Arkitektur

Hvad hver tjeneste i Nexus-chartet ejer, og hvilke datalagre der ligger under den, samt de regler, der holder dem sammen, fra identitet mellem tjenester til den vej, hvert modelkald tager.

Denne side er oversat af AI fra den engelske original. Hvis noget er uklart, er den engelske side gældende. Læs denne side på engelsk

19 minutters læsetid

Da Tomás Reilly afsluttede den første installation hos Harrow Port Authority, viste kubectl -n nexus get pods ti Deployments og syv StatefulSets samt tre CronJobs. De migrerings-Jobs, der opbyggede databasen, var allerede væk, fordi hvert enkelt sletter sig selv, når det lykkes. Den liste udgør hele platformen. Lær den at kende, for de fleste dag-to-spørgsmål begynder med: "Hvilken af disse ejer det?"

Dette kapitel besvarer det spørgsmål for hver enkelt del, følger en forespørgsel igennem dem og gennemgår derefter de regler, de alle adlyder. Resten af Del 2 bygger videre på dette billede.

Tjenesterne og hvad hver især ejer

Dette chart er ét samlet Helm-chart, nexus, version 1.0.0-alpha.1, til Kubernetes 1.33 eller nyere. Hver workload kører under sin egen ServiceAccount som en ikke-root-bruger, hvor alle Linux-capabilities er fjernet. Kald til de tjenester, der beskytter identitet og nøgler, afvikles over gensidig TLS (Transport Layer Security), og det offentlige API (application programming interface) deler proces med AI-routeren (kunstig intelligens).

Komponent Deployment og Service Serviceport Hvad den ejer
Konsol nexus-alpha 3000 De sider, folk ser; leverer HTML (Hypertext Markup Language) på konsolværten
BFF (backend for frontend) nexus-alpha-bff 8080 Konsollens egne data, den menu hver person får vist, og udgivelsesregistret
Auth nexus-auth 9101 (gensidig TLS på 8443) Personer, organisationer, sessioner, tokens, API-nøgler og organisationens pulje af modelnøgler
Gateway nexus-gateway 9092, WebSocket 8093 AI Provider Router og den offentlige API-grænseflade til REST (representational state transfer) og MCP (Model Context Protocol)
Orchestrator nexus-orchestrator 8080 UNO-afsendelse: modtager hvert job og sætter det i kø
Workflows nexus-workflows 8081 UNO-afvikling: den worker, der kører jobs fra køen
GraphRAG nexus-graphrag 8090, WebSocket 8091 Hukommelse: vidensgrafen og fremfinding i den
Probitas nexus-probitas 9151 (HTTPS) Evidens: governance-registreringer og den forseglede hovedbog
Skills-motor nexus-skills-engine 8095 Skills-biblioteket; søgning efter og afvikling af skills
Keys nexus-keys 8080 (HTTPS, gensidig TLS) Organisationsspecifikke nøgler i OpenBao, nøgleforvaltning og installationsidentiteten
Plugins nexus-plugins 9111 Plugin-registret og katalogposter; slået fra som standard
Filbehandling nexus-fileprocess 9109 Læsning af uploadede dokumenter og billeder; slået fra som standard

De første ti er påkrævede. De sidste to er valgfrie og slås til med components.plugins.enabled og components.fileprocess.enabled, hvor en Enterprise-installation eller en domænepakke anvender dem. Endnu en valgfri tjeneste, nexus-alive på port 8080, har sin egen kontakt, components.alive.enabled, og er ligeledes slået fra som standard. Replikker og ressourcer for hver enkelt ligger under components.<name>.

Konsollen består af server-renderede sider uden database. Den taler med BFF'en og med nexus-auth internt i klyngen, aldrig ud gennem den offentlige auth-vært og ind igen. Den nægter at starte op uden sin udgaveangivelse, som chartet videregiver som NEXUS_EDITION ud fra den ene edition-værdi. Hvert medlem af en organisation arbejder i den i henhold til sin rolle. Administrationssiderne er for ejere og administratorer, og et medlem, der åbner en af dem, mødes af siden "Ikke administrator".

BFF'en er konsollens serverdel og er bygget som et plugin til platformen, registreret som produktet Nexus Alpha. Den opbevarer konsollens egne tabeller i en separat database, nexus_alpha, og den afgør, hvilke menugrupper en person får vist. Når konsollen skal have udført et stykke arbejde, beder BFF'en den tjeneste, der ejer opgaven, om at gøre det.

nexus-auth er skrevet i Go og er den eneste tjeneste, der udsteder tokens. Adgangstokens er gyldige i 15 minutter og opdateringstokens i 12 timer som standard (auth.accessTokenTTL, auth.refreshTokenTTL). Den begrænser hver indlogget person til 5.000 forespørgsler i minuttet, før den svarer med 429 (auth.rateLimitPerMinute). Den kører to lyttere: en almindelig på containerport 8080, som den offentlige Ingress rammer, og en med gensidig TLS på 8443, som alle kald internt i klyngen skal bruge. Den stoler kun på X-Forwarded-For fra de hop, der er angivet i proxy.trustedCIDRs, en liste over CIDR-intervaller (Classless Inter-Domain Routing), som har standardværdien 10.42.0.0/16, k3s-pod-netværket. Hvis jeres ingress-controller kører et andet sted, skal I ændre den. Ellers ser hvert login ud, som om det kom fra controlleren.

Gatewayen har to opgaver, der deler én proces. Internt i klyngen er den AI Provider Router (AI-omstillingsbordet i Del 1 og på konsollens sider), den eneste indehaver af en organisations model-legitimationsoplysninger (mere om det nedenfor). Ved grænsefladen er den det, som api.<domain> rammer: REST-klienter og MCP-klienter, hvis tokens bærer modtagerangivelsen (audience) https://<hosts.api>/mcp og kommer fra OAuth 2.1-autorisationsserveren på auth-værten (OAuth er den åbne standard for delegeret autorisation).

Orchestrator og workflows udgør tilsammen UNO, workflow-motoren. Al beregning kører igennem dem. Orchestratoren modtager et job på POST /api/v1/dispatch, svarer med 202 samt jobId, runId og traceId, og sætter det i kø. Der er ingen inline-afviklingssti: En klient forespørger løbende (poller) GET /api/v1/dispatch/{jobId} eller modtager et callback. Workflows-workeren henter jobs fra køen, fire ad gangen pr. replika som standard (workflows.concurrency), og har nøjagtigt én HTTP-rute, GET /health.

Probitas er evidenstjenesten. Den afvikler selv TLS ud fra et certifikat, som chartet udsteder, og opbevarer sine tabeller i trust-skemaet med en separat rolle til hovedbogen. Dens governance-funktioner slås til og fra med probitas.flags. Flere af dem leveres i shadow-tilstand: Afgørelsen beregnes og registreres, og intet blokeres, før I ændrer flaget.

nexus-keys er platformens nøgletjeneste, skrevet i Go. Den opbevarer én nøgle pr. organisation i et OpenBao-nøglelager og roterer dem hver nat. Dens natlige jobs destruerer også nøgler, hvis udløbsdato for opbevaring er nået, og eksporterer kvitteringerne til sin egen diskenhed (volume). Sletning af en organisations nøgle gør de data, der er låst med den, ulæselige for bestandigt. Den udsteder også installationsidentiteten ved den første bootstrap under keys.installationName, og det navn er permanent. Vælg det med omhu: Chartet afviser et tomt navn (INSTALLATION_NAME_MISSING) og afviser navnet fra sine egne eksempelværdier (INSTALLATION_NAME_EXAMPLE).

Denne installation (Community)
Denne installation (Community)
En Community-installations egen side viser dens version og motorens sundhedstilstand. Den angiver tydeligt, at der ikke kræves nogen licens. Enterprise-delene af siden vises som forsmag.

Tre offentlige værter

Chartet udstiller nøjagtigt tre værtsnavne, som tilsammen udgør installationsidentiteten. Alle tjenester nægter at starte op uden dem.

Ingress Værtsværdi 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

Eksemplerne i denne bog bruger console.harrow.example, api.harrow.example og auth.harrow.example. Ingresserne er almindelige networking.k8s.io/v1-objekter med én regel hver, stien /. TLS ved grænsefladen følger tls.mode: existing (en Secret, I har oprettet, navngivet i tls.existingSecret), cert-manager (en ClusterIssuer, I kører, navngivet i tls.clusterIssuer) eller none (TLS termineres foran klyngen). Chartet tilføjer ingen egen omdirigering, så en ACME-HTTP-udfordring (Automated Certificate Management Environment) når jeres solver uændret. Kapitel 2.11, Variationer: eksterne datalagre, TLS og ingress, gennemgår hver tilstand.

Intet andet er eksponeret. Datalagrene, OpenBao og samtlige interne tjenester lytter kun inden for navnerummet.

Tre vandrette bånd. Det øverste bånd er "Edge" med tre Ingress-bokse mærket console, api og auth, der hver peger ned på sin Service (nexus-alpha :3000, nexus-gateway :9092, nexus-auth :9101). Det midterste bånd er "Platform services": en boks til nexus-alpha-bff; nexus-orchestrator ved siden af nexus-workflows, grupperet og mærket UNO; derefter nexus-graphrag, nexus-probitas, nexus-skills-engine, nexus-keys; og to stiplede bokse til de valgfrie nexus-plugins og nexus-fileprocess. Det nederste bånd er "Data tier" med én boks pr. lager (PostgreSQL, Valkey, Neo4j, Qdrant, SeaweedFS), og en separat indhegnet boks mærket "Key store", der indeholder openbao og openbao-unsealer, som kun kan nås af nexus-keys.
Komponenterne i en Nexus-installation og datalagrene under dem.

En forespørgsel, fra ende til anden

Her er, hvad der sker, når Aoife Brennan, IT-chef hos Harrow, åbner konsollen og stiller assistenten et spørgsmål om denne måneds kajplan.

  1. Hendes browser indlæser https://console.harrow.example. nexus-console-Ingressen sender forespørgslen til nexus-alpha på port 3000.
  2. Hun logger ind med sin adgangsnøgle (passkey). Loginsiderne taler med nexus-auth gennem auth.harrow.example, og nexus-auth udsteder et adgangstoken til hende, som indeholder hendes bruger, hendes organisation og – når hendes session har en – hendes forretningsenhed.
  3. Konsollens server kalder BFF'en, som kontrollerer hendes token og spørger nexus-auth, om hendes organisation har produktet, og om hendes rolle har adgang. Den svarer med de menugrupper, hun må se.
  4. Hendes spørgsmål sendes fra BFF'en til orchestratorens afsendelsesrute med hendes organisation og bruger hentet fra det verificerede token. Orchestratoren svarer med 202 og lægger jobbet i en kø i Valkey.
  5. En workflows-worker tager jobbet. Den skill, den kører, findes af skills-motoren, og fremfinding i Harrows dokumenter går til GraphRAG, som læser fra Neo4j, Qdrant og sit PostgreSQL-skema.
  6. Modelkaldet går til AI Provider Router på /internal/ai/chat. Routeren vælger udbyder og model ud fra Harrows egen nøglepulje og rutningspolitik, foretager kaldet med Harrows nøgle og returnerer svaret.
  7. Resultatet lander i jobbets kørselsrække. BFF'en læser det, og konsollen viser svaret med tilhørende kildehenvisninger.

Hoppene fra tjeneste til tjeneste bærer projicerede tjenestetokens, kaldene til nexus-auth, nexus-keys og Probitas kører over TLS fra installationens egen certifikatautoritet, og enhver dataadgang i trin 4 til 6 er afgrænset til Harrows organisation i selve databasen. Afsnittene nedenfor forklarer begge dele.

En sekvens fra venstre mod højre. En browser-boks sender "1 page" til Ingress console, derefter til nexus-alpha. En sidepil "2 sign-in" går fra browseren gennem Ingress auth til nexus-auth. nexus-alpha sender "3 menu" til nexus-alpha-bff, som tjekker 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 kalder nexus-skills-engine og nexus-graphrag (dets tre lagre er tegnet under GraphRAG). nexus-workflows sender "6 chat" til nexus-gateway, mærket "AI Provider Router: organisation key pool", som sender en enkelt pil ud af klyngegrænsen til "model provider". En stiplet returpil "7 result on run row" går tilbage til nexus-alpha-bff.
Et spørgsmål til assistenten, fra browseren til modeludbyderen og tilbage igen.

Datalaget

Nexus leverer sin egen signerede kopi af hvert datalager med tilbuddet om kildekode for hver enkelt inkluderet i pakken. Hvert lager er valgt lige så meget for sin licens som for sin funktion.

Datalager Version Licens Hvorfor det er der Port Standarddiskenhed
PostgreSQL med PostGIS og pgvector PostgreSQL 16, PostGIS 3, pgvector 0.8 PostgreSQL Licence; PostGIS GPL-2.0-or-later Det autoritative dataregister for hver tjeneste; PostGIS til kortdata; pgvector til vektorer gemt sammen med rækker 5432 50 GiB
Valkey 8.1 BSD-3-Clause UNO-jobkøerne og kortlivede cacher, såsom nexus-auths API-nøglecache 6379 5 GiB
Neo4j Community Edition 5.26 GPL-3.0 Den vidensgraf, som GraphRAG opbygger og gennemløber 7687 (Bolt) 20 GiB
Qdrant 1.15 Apache-2.0 Vektorsøgning til GraphRAG og skills-motoren 6333 (HTTP), 6334 (gRPC remote procedure calls) 10 GiB
SeaweedFS 4.48 Apache-2.0 Objektlager til filer, kompatibelt med Amazon Simple Storage Service (S3) 8333 50 GiB
OpenBao 2.6 MPL-2.0 Nøglelageret og dets oplåser, til nexus-keys 8200 5 GiB og 1 GiB

Nogle valg erstattede noget mere velkendt. Valkey træder i stedet for Redis 7.4, hvis nuværende licenser udgivelsen afviser. MinIO er underlagt AGPL-3.0, så objektlageret er SeaweedFS. GraphRAG tilgår Neo4j Community Edition over Bolt, en netværksprotokol, og tjenesterne tilgår PostGIS over PostgreSQL-protokollen, så GPL-licensen forbliver hos dem hver især. OpenBao er Linux Foundations forgrening (fork) af Vault fra før Vaults licensændring.

Hvert datalager kører med autentificering slået til og genererede legitimationsoplysninger: en adgangskode til Valkey, en API-nøgle til Qdrant og adgangsnøgler til SeaweedFS.

Hvert af de fem datalagre under dataTier kører enten i klyngen (mode: in-cluster, standarden) eller er et, I allerede selv driver (mode: external, med external.host og en Secret navngivet af external.existingSecret). For en ekstern PostgreSQL skal I sætte sslmode til verify-full eller verify-ca og lægge serverens CA-certifikat (certifikatautoritet) i den pågældende Secret; kapitel 2.11, Variationer: eksterne datalagre, TLS og ingress, rummer detaljerne.

# 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-parret er undtagelsen: Det kører altid inde i installationen, fordi nøgleforvaltnings-Jobbet initialiserer det der.

Identitet mellem tjenester

Nexus kører uden et service mesh. Gensidig TLS kommer fra en lokal certifikatautoritet (CA), som chartet opretter gennem cert-manager, der skal være installeret først (v1.21.3 er testet).

En selvsigneret Issuer opretter ét CA-certifikat, nexus-local-ca, ECDSA (Elliptic Curve Digital Signature Algorithm) P-256, gyldigt i ti år. En anden Issuer signerer med denne CA. Hver workload, der kalder en TLS-server inde i installationen, får sit eget klientcertifikat, navngivet <service-account>-client-tls, gyldigt i 90 dage og fornyet 15 dage før udløb. Dets eneste navn er en URI (uniform resource identifier) i SPIFFE-identitetsformatet:

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

Hver workload finder CA'ens offentlige certifikat som ca.crt i sin egen certifikat-Secret. Ingen pod monterer CA'ens nøgle, og I behøver ikke trust-manager.

Tre tjenester verificerer kaldende parter via certifikat. nexus-auth gør det på sin anden lytter, port 8443, og alle kaldende parter internt i klyngen kalder den. nexus-keys gør det på sin eneste lytter. Probitas leverer TLS fra sit eget certifikat, nexus-probitas-tls, som den genindlæser, når cert-manager fornyer det. Ingen af dem stoler på en X-Forwarded-Client-Cert-header.

Hver workload får også et-times Kubernetes-tokens på /var/run/secrets/nexus, ét for hver tjeneste den kalder, med den pågældende tjeneste som modtager (audience). ConfigMap'en nexus-service-identities knytter hver <namespace>/<service-account> til et tjeneste- eller plugin-navn, og en workload, der mangler på listen, har ingen identitet og afvises. Orchestratoren og Probitas kontrollerer disse tokens med Kubernetes-API'et. Af de kørende tjenester er det kun disse to, der har system:auth-delegator eller har et API-token monteret; den eneste anden workload med et token er nøgleforvaltnings-Jobbet, der kører ved installationen.

Netværkspolitikker lukker det, som identiteten ikke gør. Chartet udgår fra standardafvisning (default deny) og tillader derefter trafik mellem installationens egne pods, DNS (Domain Name System), ingress-controllerens navnerum (networkPolicy.ingressNamespace, kube-system som standard) til de tre offentlige Services samt API-serveren for de to token-kontrollører. OpenBao-poddene bærer en anden label end resten af platformen, så den åbne regel internt i navnerummet når dem ikke: Kun nexus-keys, dens Jobs og nøgleforvaltnings-Jobbet slipper igennem på port 8200. Alt andet, som en workload skal nå uden for navnerummet, såsom jeres mail-relay, angives i networkPolicy.externalEgressCIDRs, som er tom som standard.

Migreringer og skumaprotokollen

Migreringer kører som Helm-hooks på post-install og pre-upgrade. En post-install-hook kører, efter at udgivelsens Deployments er blevet oprettet. Ved en førstegangsinstallation starter tjenesterne altså, mens deres skemaer endnu ikke findes, og de ville gå i crash-loop mod en database uden rolle, uden adgangskode og uden tabeller. Nexus undgår dette med en hovedbog.

Disse hooks kører i vægtet rækkefølge, og Helm venter på hvert Job, før den næste vægt starter:

Vægt Hook Hvad den gør
-30 nexus-migrations-env og forudsætninger Opretter den Secret, der kun bruges af hooks, med migratorens legitimationsoplysninger samt alt det, nøgleforvaltnings-Jobbet læser
-20 nexus-db-bootstrap Opretter databasen nexus og nexus_alpha, migratorrollen, hver tjenestes runtime-rolle, udvidelserne og hovedbogen
-15 nexus-openbao-custody-init Initialiserer nøglelageret og oplåseren og udsteder installationsidentiteten
-12 nexus-graphrag-migrations GraphRAGs skema, som ejer objekter, hvortil nexus-auths baseline henviser
-10 nexus-auth-migrations Identitetsskemaet
-5 Migreringer for orchestrator, gateway og Probitas Deres skemaer; Probitas kontrollerer først, at auth-tabellerne findes
0 nexus-alpha-bff-migrations Konsollens egen database

Hvert migrerings-Job har backoffLimit: 0, så en fejlet migrering får installationen til at fejle.

Hovedbogen er én tabel, nexus_release.schema_applied, med en række pr. kæde og image-digest. Hver hook skriver først sin række, når dens migreringskørsel er returneret. Hver Deployment, der bruger PostgreSQL, indeholder en init-container, wait-for-schema, som læser denne tabel som en rolle, der ikke har tilladelse til at læse noget som helst andet (nexus_ledger_reader), og venter, indtil hver kæde, den afhænger af, viser en række for denne udgivelses image. Derefter starter tjenesten. Workflows-workeren venter på orchestratorens kæde, da den deler denne database, og skills-motoren venter kun på bootstrappen.

Den forespørger hvert 3. sekund (schemaWait.intervalSeconds) og giver op efter 1.800 (schemaWait.timeoutSeconds) med en linje, der navngiver de kæder, som stadig mangler. Tjenestens egen container starter aldrig op mod et forkert skema.

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

Det er derfor, I aldrig må køre helm install --wait. Med --wait venter Helm på Deployments, før den kører post-install-hooks, og Deployments venter på disse hooks. Ingen af delene kommer videre. Installer uden dette flag, og vent bagefter; kapitel 2.6, Installation af Community på Kubernetes, angiver den nøjagtige kommando.

Isolering på tre akser

Enhver læsning, skrivning, værktøjskald og skill-afsendelse i Nexus er afgrænset på tre akser.

Akse Felt Hvad den adskiller
Lejer (Tenant) organization_id Én organisation fra en anden; en hård grænse
Ejer (Owner) owner_user_id Én persons ting fra alle andres, selv inden for samme organisation
Enhed (Unit) business_unit_id En underinddeling af en organisation, valgfri

Ejeraksen overrasker mange. En postkasse eller en personlig notesbog er privat for sin ejer, selv over for kolleger i samme enhed med samme rolle. En administrator fastsætter politikker og læser ikke indhold.

Akserne kommer fra den autentificerede forespørgsel og ingen andre steder fra. Ingen miljøvariabel, header, forespørgselsparameter eller stisegment kan angive dem. En forespørgselskrop (body), der navngiver en organisation, afvises med TENANT_NOT_A_PARAMETER. En flade, der ikke kan oplyse, hvilken lejer, ejer og enhed en række tilhører, afviser med 403 SCOPE_PREDICATE_MISSING, og kroppen oplistet, hvilke akser der blev fastlagt, og hvilke der ikke gjorde. Den falder aldrig tilbage til en bredere læsning.

Dette gælder to steder på én gang.

I databasen. Hver tjeneste forbinder som sine egne runtime-roller: nexus_auth, auth_app og auth_platform for identitetstjenesten, nexus_probitas og nexus_probitas_ledger for Probitas samt nexus_gateway, nexus_graphrag, nexus_skills, orchestrator_app, workflows_app og resten for de øvrige. Ingen af dem er superbruger eller har BYPASSRLS. Ingen af dem ejer heller de tabeller, den bruger, så enhver politik for sikkerhed på rækkeniveau (row-level security, RLS) gælder for den. Rollerne deler en gruppe, nexus_runtime, der giver ret til forbindelse og skemabrug, men slet ingen tabelrettigheder; hver tjeneste tildeles sine egne tabeller af sine egne migreringer. De lejerindstillinger, som RLS-politikker læser, kan kun sættes gennem hver tjenestes bind_scope-funktion, som kører som sin ejer. Bootstrappen tilbagekalder set_config fra alle andre, og orchestratoren og Probitas nægter at starte, hvis deres runtime-rolle kunne kalde den direkte (Probitas kalder dette DB_ROLE_SETS_SCOPE_DIRECTLY). De eneste superbrugerforbindelser i hele installationen tilhører bootstrap-Jobbet og BFF'ens klargøringstrin.

I den delte primitiv til afgrænsede forespørgsler. Hvert repository i platformen og hvert plugin bygget på SDK'et (software development kit) arver ét hegn, der bygger SQL-prædikatet ud fra en fastlagt afgrænsning (scope). Dets afgrænsningsfunktion tager den verificerede identitet og har ingen organisationsparameter, så en kaldende part kan ikke sende en med, og ingen rute kan fravælge det.

Der findes nøjagtigt én krydsning af lejergrænsen, og den er snæver: en registreret tilladelse (grant). To personer i den organisation, der ejer rækkerne, registrerer, hvilken organisation der må læse hvilke tabeller, og indtil hvornår. Hver læsning kører i en skrivebeskyttet transaktion og logges hos begge lejere. Ejere og administratorer læser aldrig på tværs, og den læsende part kan ikke udvide en tilladelse.

AI-stien

Kaldende parter udtrykker ønsker. AI Provider Router ejer legitimationsoplysningerne og træffer det endelige valg.

Ethvert modelkald i Nexus går gennem routerens /internal/ai/*-ruter, og routeren giver kun adgang til navngivne kaldende parter. Chartet opsætter tre lister på gatewayen:

Ruter Hvem der må kalde
Chat og chat-streaming nexus-orchestrator, nexus-workflows, nexus-skills-engine
Embeddings og rerank nexus-graphrag, nexus-skills-engine, nexus-workflows
Alt andet, herunder værktøjsafvikling nexus-orchestrator, nexus-workflows

Et kald uden kalderidentitet afvises med 403 MISSING_CALLER_IDENTITY, og en kaldende part, der ikke står på listen, afvises med 403 UNAUTHORIZED_CALLER. Plugins står ikke på nogen liste, og det er tilsigtet: Et plugins modelkald sker på dets vegne gennem UNO-afsendelse.

Det, en kaldende part kan sende, er et ønske: en foretrukken udbyder og model samt en kapabilitetsprofil såsom en minimal kontekstlængde eller brug af værktøjer. Routeren efterkommer kun et ønske, når organisationen har den pågældende udbyder aktiveret og forsynet med legitimationsoplysninger; ellers substituerer den, først inden for samme udbyder og derefter på tværs af organisationens øvrige udbydere. En kapabilitetsprofil filtrerer kun, og et krav om dataplacering (data-residency) i den er ufravigeligt. Når intet passer, er der ingen fallback-model: Den kaldende part får 422 MODEL_CAPABILITY_UNAVAILABLE eller 422 NO_PROVIDER_FOR_ROLE med en afhjælpningsstreng, som konsollen viser til en administrator.

Nøglerne tilhører organisationen. Hver organisations administratorer lægger deres egne udbydernøgler i dens pulje fra konsollen, og routeren slår dem op på kaldtidspunktet. Ingen modelnøgle er en chart-værdi, og ingen leveres sammen med Nexus. En organisation uden nøgle får ingen AI-svar, og det siger konsollen rent ud; intet udfylder hullet et andet sted fra.

To chart-værdier former routeren. ai.localProvider.baseUrl angiver en OpenAI-kompatibel modelserver, du selv kører, som routes ligesom enhver anden udbyder. ai.installationHosts oplistes dine modelservere på private navne, som routeren regner som værende inden for installationen. GraphRAG foretager også indlejringer (embeddings) gennem routeren som den organisation, hvis indhold det er. Standardmodellen til indlejring kører i klyngen uden et grafikkort; hostede indlejringer er den enkelte organisations eget valg.

Ingen telemetri

Intet forlader en installation, medmindre du sender det. Værdien telemetry.enabled i chartet kan kun være false; skemaet afviser alt andet. Datalagets egen rapportering er også slået fra: Neo4js brugsrapport og Qdrants telemetri er deaktiveret i chartet.

Når networkPolicy.enabled er slået til, hvilket er standarden, kan ingen pod nå internettet, medmindre du angiver destinationen i networkPolicy.externalEgressCIDRs. En hostet modeludbyder er en sådan destination, og det samme gælder dit mail-relay.

Den samme regel har ændret en standardindstilling, du vil bemærke. nexus-auths CAPTCHA ved tilmeldinger kræver en internettjeneste, så på en installation er den slået fra, og en ukendt brugers tilmelding afventer en administrators godkendelse (403 SIGNUP_REQUIRES_APPROVAL). Filtret, der blokerer tilmeldinger fra hostingnetværk, er også slået fra, fordi det kræver licenserede databaser, som Nexus ikke leverer. Du mister den screening.

Installationens tilstand
Installationens tilstand
På Enterprise viser tilstandssiden klyngen under Nexus: hvor belastet hver del er, og hvor meget kapacitet der er tilbage, med hver advarsel ved siden af, hvad man skal gøre ved den.