AnmeldenBriefing buchen

Kapitel 2.1

Architektur

Wofür jeder Dienst im Nexus-Chart zuständig ist und welche Datenspeicher darunter liegen, gefolgt von den Regeln, die alles zusammenhalten – von der Identität zwischen Diensten bis hin zum Pfad, den jeder Modellaufruf nimmt.

Diese Seite wurde mithilfe von KI aus dem englischen Original übersetzt. Bei Unklarheiten gilt die englische Seite als Referenz. Diese Seite auf Englisch lesen

19 Minuten Lesezeit

Als Tomás Reilly die erste Installation bei der Harrow Port Authority abschloss, zeigte kubectl -n nexus get pods zehn Deployments und sieben StatefulSets sowie drei CronJobs. Die Migrations-Jobs, die die Datenbank aufgebaut hatten, waren bereits verschwunden, da sich jeder nach erfolgreichem Abschluss selbst löscht. Diese Auflistung ist die gesamte Plattform. Prägen Sie sie sich ein, denn die meisten Fragen im laufenden Betrieb beginnen mit: „Welcher davon ist dafür zuständig?“

Dieses Kapitel beantwortet diese Frage für jede Komponente, verfolgt eine Anfrage durch sie hindurch und behandelt anschließend die Regeln, denen sie alle folgen. Der Rest von Teil 2 baut auf diesem Bild auf.

Die Dienste und ihre Zuständigkeiten

Das Chart ist ein einzelnes Helm-Chart, nexus, Version 1.0.0-alpha.1, für Kubernetes 1.33 oder höher. Jeder Workload läuft unter seinem eigenen ServiceAccount als Nicht-Root-Benutzer, wobei alle Linux-Capabilities entfernt sind. Aufrufe an die Dienste, die Identitäten und Schlüssel schützen, erfolgen über beidseitiges TLS (Transport Layer Security), und die öffentliche API (Application Programming Interface) teilt sich einen Prozess mit dem KI-Router (Künstliche Intelligenz).

Komponente Deployment und Service Service-Port Zuständigkeit
Konsole nexus-alpha 3000 Die Seiten, die Personen sehen; liefert HTML (Hypertext Markup Language) unter dem Konsolen-Host aus
BFF (Backend for Frontend) nexus-alpha-bff 8080 Die eigenen Daten der Konsole, das Menü, das jede Person erhält, das Release-Register
Auth nexus-auth 9101 (beidseitiges TLS auf 8443) Personen, Organisationen, Sitzungen, Tokens, API-Schlüssel, der Modellschlüssel-Pool der Organisation
Gateway nexus-gateway 9092, WebSocket 8093 Der AI Provider Router und der öffentliche API-Endpunkt für REST (Representational State Transfer) und MCP (Model Context Protocol)
Orchestrator nexus-orchestrator 8080 UNO-Dispatch: Entgegennahme jedes Jobs und Einreihung in die Warteschlange
Workflows nexus-workflows 8081 UNO-Ausführung: der Worker, der eingereihte Jobs ausführt
GraphRAG nexus-graphrag 8090, WebSocket 8091 Gedächtnis: der Wissensgraph und der Abruf darüber
Probitas nexus-probitas 9151 (HTTPS) Nachweise: Governance-Einträge und das versiegelte Hauptbuch (Ledger)
Skills Engine nexus-skills-engine 8095 Die Skill-Bibliothek; Auffinden und Ausführen von Skills
Keys nexus-keys 8080 (HTTPS, beidseitiges TLS) Organisationsbezogene Schlüssel in OpenBao, Verwahrung (Custody), die Installationsidentität
Plugins nexus-plugins 9111 Die Plugin-Registry und Katalogeinträge; standardmäßig deaktiviert
Dateiverarbeitung nexus-fileprocess 9109 Lesen hochgeladener Dokumente und Bilder; standardmäßig deaktiviert

Die ersten zehn sind erforderlich. Die letzten beiden sind optional und werden mit components.plugins.enabled und components.fileprocess.enabled eingeschaltet, wenn eine Enterprise-Installation oder ein Domain-Pack sie verwendet. Ein weiterer optionaler Dienst, nexus-alive auf Port 8080, hat seinen eigenen Schalter, components.alive.enabled, und ist standardmäßig ebenfalls deaktiviert. Replikate und Ressourcen für jeden Dienst befinden sich unter components.<name>.

Die Konsole besteht aus serverseitig gerenderten Seiten ohne eigene Datenbank. Sie kommuniziert mit dem BFF und mit nexus-auth innerhalb des Clusters, niemals über den öffentlichen Auth-Host nach außen und wieder hinein. Sie verweigert den Start ohne ihre Edition, die das Chart als NEXUS_EDITION aus dem einzigen edition-Wert übergibt. Jedes Mitglied einer Organisation arbeitet darin entsprechend seiner Rolle. Die Administrationsseiten sind für Eigentümer und Administratoren bestimmt; ein Mitglied, das eine solche Seite öffnet, erhält die Seite „Not an administrator“.

Das BFF ist die Serverhälfte der Konsole und als Plugin der Plattform aufgebaut, registriert als das Produkt Nexus Alpha. Es hält die eigenen Tabellen der Konsole in einer separaten Datenbank, nexus_alpha, und entscheidet, welche Menügruppen eine Person sieht. Wenn die Konsole Aufgaben erledigen lassen muss, beauftragt das BFF den jeweils zuständigen Dienst.

nexus-auth ist in Go geschrieben und der einzige Dienst, der Tokens ausstellt. Access-Tokens sind standardmäßig 15 Minuten gültig und Refresh-Tokens 12 Stunden (auth.accessTokenTTL, auth.refreshTokenTTL). Er begrenzt jede angemeldete Person auf 5.000 Anfragen pro Minute, bevor er mit 429 antwortet (auth.rateLimitPerMinute). Er betreibt zwei Listener: den unverschlüsselten auf Container-Port 8080, den der öffentliche Ingress erreicht, und einen mit beidseitigem TLS auf 8443, den jeder Aufrufer innerhalb des Clusters verwenden muss. Er vertraut X-Forwarded-For nur von den Hops in proxy.trustedCIDRs, einer Liste von CIDR-Bereichen (Classless Inter-Domain Routing), die standardmäßig auf 10.42.0.0/16, das k3s-Pod-Netzwerk, eingestellt ist. Wenn Ihr Ingress-Controller an anderer Stelle läuft, ändern Sie dies. Andernfalls sieht jede Anmeldung so aus, als käme sie vom Controller.

Das Gateway hat zwei Aufgaben, die sich einen Prozess teilen. Innerhalb des Clusters ist es der AI Provider Router (die KI-Schaltzentrale in Teil 1 und auf den Seiten der Konsole), der einzige Inhaber der Modell-Anmeldedaten einer Organisation (mehr dazu weiter unten). Am Netzwerkrand (Edge) ist es das, was api.<domain> erreicht: REST-Clients und MCP-Clients, deren Tokens die Audience https://<hosts.api>/mcp tragen und vom OAuth-2.1-Autorisierungsserver unter dem Auth-Host stammen (OAuth ist der offene Standard für delegierte Autorisierung).

Der Orchestrator und Workflows bilden zusammen UNO, die Workflow-Engine. Alle Berechnungen laufen über sie. Der Orchestrator nimmt einen Job unter POST /api/v1/dispatch entgegen, antwortet mit 202 sowie jobId, runId und traceId und reiht ihn in die Warteschlange ein. Es gibt keinen Inline-Ausführungspfad: Ein Client fragt immer GET /api/v1/dispatch/{jobId} ab (Polling) oder nutzt einen Callback. Der Workflows-Worker holt Jobs aus der Warteschlange, standardmäßig vier gleichzeitig pro Replikat (workflows.concurrency), und hat genau eine HTTP-Route, GET /health.

Probitas ist der Nachweisdienst (Evidence Service). Er stellt TLS selbst bereit, über ein vom Chart ausgestelltes Zertifikat, und hält seine Tabellen im Schema trust mit einer separaten Rolle für das Hauptbuch (Ledger). Seine Governance-Funktionen werden über probitas.flags geschaltet. Mehrere werden im Modus shadow ausgeliefert: Das Urteil wird berechnet und aufgezeichnet, aber nichts wird blockiert, bis Sie das Flag ändern.

nexus-keys ist der Schlüsseldienst der Plattform, geschrieben in Go. Er hält für jede Organisation einen Schlüssel in einem OpenBao-Schlüsselspeicher und rotiert diese jede Nacht. Seine nächtlichen Jobs vernichten außerdem Schlüssel, deren Aufbewahrungsdatum erreicht ist, und exportieren die Belege auf ein eigenes Volume. Das Löschen des Schlüssels einer Organisation macht die damit gesperrten Daten endgültig unlesbar. Zudem prägt er beim ersten Bootstrap unter keys.installationName die Installationsidentität, und dieser Name ist dauerhaft. Wählen Sie ihn sorgfältig: Das Chart verweigert einen leeren Namen (INSTALLATION_NAME_MISSING) ebenso wie den Namen aus seinen eigenen Beispielwerten (INSTALLATION_NAME_EXAMPLE).

Diese Installation (Community)
Diese Installation (Community)
Die eigene Seite einer Community-Installation zeigt ihre Version und den Zustand der Engine. Sie gibt klar an, dass keine Lizenz erforderlich ist. Die Enterprise-Bereiche der Seite werden als Vorschau (Teaser) dargestellt.

Drei öffentliche Hosts

Das Chart veröffentlicht genau drei Hostnamen, die zusammen die Installationsidentität bilden. Jeder Dienst verweigert ohne sie den Start.

Ingress Host-Wert 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

Die Beispiele in diesem Buch verwenden console.harrow.example, api.harrow.example und auth.harrow.example. Die Ingresses sind einfache networking.k8s.io/v1-Objekte mit jeweils einer Regel, Pfad /. TLS am Netzwerkrand richtet sich nach tls.mode: existing (ein von Ihnen erstelltes Secret, benannt in tls.existingSecret), cert-manager (ein von Ihnen betriebener ClusterIssuer, benannt in tls.clusterIssuer) oder none (TLS endet vor dem Cluster). Das Chart fügt keine eigene Weiterleitung hinzu, sodass eine ACME-HTTP-Challenge (Automated Certificate Management Environment) Ihren Solver unverändert erreicht. Kapitel 2.11, Varianten: externe Speicher, TLS und Ingress, behandelt jeden Modus.

Nichts anderes wird nach außen freigegeben. Die Datenspeicher, OpenBao und jeder interne Dienst lauschen nur innerhalb des Namespace.

Drei horizontale Bänder. Das oberste Band ist „Edge“ mit drei Ingress-Kästchen, beschriftet mit console, api und auth, die jeweils nach unten auf ihren Service verweisen (nexus-alpha :3000, nexus-gateway :9092, nexus-auth :9101). Das mittlere Band ist „Platform services“: ein Kästchen für nexus-alpha-bff; nexus-orchestrator neben nexus-workflows, gruppiert und beschriftet mit UNO; dann nexus-graphrag, nexus-probitas, nexus-skills-engine, nexus-keys; sowie zwei gestrichelte Kästchen für die optionalen Dienste nexus-plugins und nexus-fileprocess. Das unterste Band ist „Data tier“ mit einem Kästchen pro Speicher (PostgreSQL, Valkey, Neo4j, Qdrant, SeaweedFS) und einem separaten, abgegrenzten Kästchen mit der Beschriftung „Key store“, das openbao und openbao-unsealer enthält und nur von nexus-keys erreicht wird.
Die Komponenten einer Nexus-Installation und die darunterliegenden Speicher.

Eine Anfrage, von Anfang bis Ende

Folgendes geschieht, wenn Aoife Brennan, Leiterin der IT bei Harrow, die Konsole öffnet und dem Assistenten eine Frage zum Liegeplatzplan dieses Monats stellt.

  1. Ihr Browser lädt https://console.harrow.example. Der nexus-console-Ingress sendet die Anfrage an nexus-alpha auf Port 3000.
  2. Sie meldet sich mit ihrem Passkey an. Die Anmeldeseiten kommunizieren über auth.harrow.example mit nexus-auth, und nexus-auth stellt ihr ein Access-Token aus, das ihren Benutzer, ihre Organisation und, falls ihre Sitzung eine hat, ihre Geschäftseinheit (Business Unit) enthält.
  3. Der Server der Konsole ruft das BFF auf, das ihr Token prüft und bei nexus-auth abfragt, ob ihre Organisation über das Produkt verfügt und ob ihre Rolle zugelassen ist. Es antwortet mit den Menügruppen, die sie sehen darf.
  4. Ihre Frage geht vom BFF an die Dispatch-Route des Orchestrators, wobei ihre Organisation und ihr Benutzer aus dem verifizierten Token übernommen werden. Der Orchestrator antwortet mit 202 und legt den Job in eine Warteschlange in Valkey.
  5. Ein Workflows-Worker übernimmt den Job. Der von ihm ausgeführte Skill wird durch die Skills Engine aufgelöst, und der Abruf über die Dokumente von Harrow geht an GraphRAG, das Neo4j, Qdrant und sein PostgreSQL-Schema liest.
  6. Der Modellaufruf geht an den AI Provider Router unter /internal/ai/chat. Der Router wählt den Anbieter und das Modell aus dem eigenen Schlüssel-Pool und der Routing-Richtlinie von Harrow aus, führt den Aufruf mit dem Schlüssel von Harrow durch und gibt die Vervollständigung (Completion) zurück.
  7. Das Ergebnis landet in der Ausführungszeile des Jobs. Das BFF liest es und die Konsole stellt die Antwort mitsamt ihren Quellenangaben dar.

Die Aufrufe von Dienst zu Dienst tragen projizierte Service-Tokens; diejenigen zu nexus-auth, nexus-keys und Probitas laufen über TLS von der eigenen Zertifizierungsstelle der Installation, und jeder Datenzugriff in den Schritten 4 bis 6 ist in der Datenbank selbst auf die Organisation von Harrow eingegrenzt. Die folgenden Abschnitte erläutern beides.

Eine Abfolge von links nach rechts. Ein Browser-Kästchen sendet „1 page“ an die Ingress-Komponente console, dann an nexus-alpha. Ein seitlicher Pfeil „2 sign-in“ führt vom Browser über die Ingress-Komponente auth zu nexus-auth. nexus-alpha sendet „3 menu“ an nexus-alpha-bff, was eine Rückfrage bei nexus-auth durchführt. nexus-alpha-bff sendet „4 dispatch, 202“ an nexus-orchestrator, der in ein Valkey-Warteschlangensymbol schreibt. nexus-workflows ruft „5 job“ aus der Warteschlange ab und ruft nexus-skills-engine sowie nexus-graphrag auf (dessen drei Speicher unter GraphRAG eingezeichnet sind). nexus-workflows sendet „6 chat“ an nexus-gateway, beschriftet mit „AI Provider Router: organisation key pool“, von wo aus ein einzelner Pfeil über die Clustergrenze hinaus zu „model provider“ führt. Ein gepunkteter Rückpfeil „7 result on run row“ führt zurück zu nexus-alpha-bff.
Eine Frage an den Assistenten, vom Browser zum Modellanbieter und zurück.

Die Datenschicht

Nexus liefert eine eigene signierte Kopie jedes Speichers mit, einschließlich des Quellcode-Angebots für jeden im Paket. Jeder wurde ebenso sehr wegen seiner Lizenz wie wegen seiner Funktion ausgewählt.

Speicher Version Lizenz Zweck Port Standard-Volume
PostgreSQL mit PostGIS und pgvector PostgreSQL 16, PostGIS 3, pgvector 0.8 PostgreSQL-Lizenz; PostGIS GPL-2.0-or-later Das führende Aufzeichnungssystem (System of Record) für jeden Dienst; PostGIS für Kartendaten; pgvector für neben Zeilen gespeicherte Vektoren 5432 50 GiB
Valkey 8.1 BSD-3-Clause Die UNO-Job-Warteschlangen und kurzlebige Caches, wie der API-Schlüssel-Cache von nexus-auth 6379 5 GiB
Neo4j Community Edition 5.26 GPL-3.0 Der Wissensgraph, den GraphRAG aufbaut und durchläuft 7687 (Bolt) 20 GiB
Qdrant 1.15 Apache-2.0 Vektorsuche für GraphRAG und die Skills Engine 6333 (HTTP), 6334 (gRPC Remote Procedure Calls) 10 GiB
SeaweedFS 4.48 Apache-2.0 Objektspeicher für Dateien, kompatibel mit Amazon Simple Storage Service (S3) 8333 50 GiB
OpenBao 2.6 MPL-2.0 Der Schlüsselspeicher und sein Unsealer, für nexus-keys 8200 5 GiB und 1 GiB

Einige Entscheidungen ersetzten etwas Vertrauteres. Valkey tritt an die Stelle von Redis 7.4, dessen aktuelle Lizenzen das Release ablehnt. MinIO steht unter AGPL-3.0, daher ist der Objektspeicher SeaweedFS. GraphRAG erreicht die Neo4j Community Edition über Bolt, ein Netzwerkprotokoll, und die Dienste erreichen PostGIS über das PostgreSQL-Protokoll, sodass die GPL jeweils bei diesen verbleibt. OpenBao ist der Fork von Vault durch die Linux Foundation aus der Zeit vor der Lizenzänderung von Vault.

Jeder Speicher läuft mit aktivierter Authentifizierung und generierten Anmeldedaten: einem Passwort für Valkey, einem API-Schlüssel für Qdrant, Zugriffsschlüsseln für SeaweedFS.

Jeder der fünf Speicher unter dataTier läuft im Cluster (mode: in-cluster, die Standardeinstellung) oder ist einer, den Sie bereits betreiben (mode: external, mit external.host und einem durch external.existingSecret benannten Secret). Für ein externes PostgreSQL setzen Sie sslmode auf verify-full oder verify-ca und legen das Zertifikat der Zertifizierungsstelle (CA) des Servers in diesem Secret ab; Kapitel 2.11, Varianten: externe Speicher, TLS und Ingress, enthält die Details.

# 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

Das OpenBao-Paar bildet die Ausnahme: Es läuft immer innerhalb der Installation, da der Custody-Job es dort initialisiert.

Identität zwischen Diensten

Nexus läuft ohne Service-Mesh. Beidseitiges TLS stammt von einer lokalen Zertifizierungsstelle (CA), die das Chart über cert-manager erstellt, welcher zuerst installiert werden muss (v1.21.3 ist getestet).

Ein selbstsignierter Issuer erstellt ein CA-Zertifikat, nexus-local-ca, ECDSA (Elliptic Curve Digital Signature Algorithm) P-256, zehn Jahre gültig. Ein zweiter Issuer signiert mit dieser CA. Jeder Workload, der einen TLS-Server innerhalb der Installation aufruft, erhält sein eigenes Client-Zertifikat namens <service-account>-client-tls, das 90 Tage gültig ist und 15 Tage vor Ablauf erneuert wird. Sein einziger Name ist ein Uniform Resource Identifier (URI) in der Form einer SPIFFE-Identität:

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

Jeder Workload findet das öffentliche Zertifikat der CA als ca.crt in seinem eigenen Zertifikats-Secret. Kein Pod bindet den Schlüssel der CA ein, und Sie benötigen keinen trust-manager.

Drei Dienste überprüfen Aufrufer anhand ihres Zertifikats. nexus-auth tut dies auf seinem zweiten Listener, Port 8443, und jeder Aufrufer innerhalb des Clusters wählt diesen an. nexus-keys tut dies auf seinem einzigen Listener. Probitas stellt TLS über sein eigenes Zertifikat, nexus-probitas-tls, bereit, das es neu einliest, wenn cert-manager es erneuert. Keiner von ihnen vertraut einem X-Forwarded-Client-Cert-Header.

Jeder Workload erhält außerdem einstündige Kubernetes-Tokens unter /var/run/secrets/nexus, eines pro aufgerufenem Dienst, mit diesem Dienst als Audience. Die ConfigMap nexus-service-identities ordnet jedes <namespace>/<service-account> einem Dienst- oder Plugin-Namen zu; ein Workload, der darin fehlt, hat keine Identität und wird abgewiesen. Der Orchestrator und Probitas prüfen diese Tokens über die Kubernetes-API. Von den laufenden Diensten verfügen nur diese beiden über system:auth-delegator oder haben ein API-Token eingebunden; der einzige andere Workload mit einem Token ist der Custody-Job, der bei der Installation läuft.

Netzwerkrichtlinien (Network Policies) schließen das ab, was die Identität nicht abdeckt. Das Chart beginnt mit einer Standardablehnung (Default Deny) und lässt dann Datenverkehr zwischen den eigenen Pods der Installation, DNS (Domain Name System), dem Namespace des Ingress-Controllers (networkPolicy.ingressNamespace, standardmäßig kube-system) zu den drei öffentlichen Services sowie zum API-Server für die beiden Token-Prüfer zu. Die OpenBao-Pods tragen ein anderes Label als der Rest der Plattform, sodass die offene Regel innerhalb des Namespace sie nicht erreicht: Nur nexus-keys, seine Jobs und der Custody-Job kommen auf Port 8200 durch. Alles andere, was ein Workload außerhalb des Namespace erreichen muss, wie etwa Ihr Mail-Relay, wird in networkPolicy.externalEgressCIDRs eingetragen, was standardmäßig leer ist.

Migrationen und das Schema-Verzeichnis

Migrationen laufen als Helm-Hooks bei post-install und pre-upgrade. Ein Post-Install-Hook läuft, nachdem die Deployments des Releases erstellt wurden. Bei einer Erstinstallation starten die Dienste also, während ihre Schemata noch nicht existieren, und sie würden gegen eine Datenbank ohne Rolle, ohne Passwort und ohne Tabellen in eine Absturzschleife (Crash-Loop) geraten. Nexus vermeidet dies mit einem Hauptbuch (Ledger).

Die Hooks laufen in der Reihenfolge ihrer Gewichtung (Weight), und Helm wartet auf jeden Job, bevor die nächste Gewichtung beginnt:

Gewichtung Hook Aufgabe
-30 nexus-migrations-env und Voraussetzungen Erstellt das nur für Hooks bestimmte Secret mit den Anmeldedaten des Migrators sowie alles, was der Custody-Job liest
-20 nexus-db-bootstrap Erstellt die Datenbanken nexus und nexus_alpha, die Migrator-Rolle, die Laufzeitrolle jedes Dienstes, die Erweiterungen und das Ledger
-15 nexus-openbao-custody-init Initialisiert den Schlüsselspeicher und den Unsealer und prägt die Installationsidentität
-12 nexus-graphrag-migrations Das Schema von GraphRAG, das Objekte besitzt, auf die sich die Baseline von nexus-auth bezieht
-10 nexus-auth-migrations Das Identitätsschema
-5 Migrationen von Orchestrator, Gateway und Probitas Deren Schemata; Probitas prüft zuerst, ob die Auth-Tabellen existieren
0 nexus-alpha-bff-migrations Die eigene Datenbank der Konsole

Jeder Migrations-Job hat backoffLimit: 0, sodass eine fehlgeschlagene Migration die Installation fehlschlagen lässt.

Das Ledger ist eine einzelne Tabelle, nexus_release.schema_applied, mit einer Zeile pro Kette (Chain) und Image-Digest. Jeder Hook schreibt seine Zeile erst, nachdem sein Migrations-Runner zurückgekehrt ist. Jedes Deployment, das PostgreSQL verwendet, enthält einen Init-Container, wait-for-schema, der diese Tabelle unter einer Rolle liest, die nichts anderes lesen darf (nexus_ledger_reader), und wartet, bis jede Kette, von der er abhängt, eine Zeile für das Image dieses Releases aufweist. Erst dann startet der Dienst. Der Workflows-Worker wartet auf die Kette des Orchestrators, da er sich diese Datenbank teilt, und die Skills Engine wartet nur auf den Bootstrap.

Er fragt alle 3 Sekunden ab (schemaWait.intervalSeconds) und gibt nach 1.800 Sekunden (schemaWait.timeoutSeconds) mit einer Zeile auf, die die noch fehlenden Ketten benennt. Der eigene Container des Dienstes startet niemals gegen ein falsches Schema.

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

Deshalb dürfen Sie niemals helm install --wait ausführen. Mit --wait wartet Helm auf die Deployments, bevor es die Post-Install-Hooks ausführt, und die Deployments warten auf die Hooks. Keines von beiden bewegt sich. Installieren Sie ohne diese Option und warten Sie anschließend; Kapitel 2.6, Installation von Community auf Kubernetes, nennt den genauen Befehl.

Isolierung auf drei Achsen

Jeder Lese- und Schreibvorgang, jeder Tool-Aufruf und jeder Skill-Dispatch in Nexus wird auf drei Achsen eingegrenzt (Scoped).

Achse Feld Was sie trennt
Mandant (Tenant) organization_id Eine Organisation von einer anderen, eine harte Grenze
Eigentümer (Owner) owner_user_id Die Dinge einer Person von denen aller anderen, selbst innerhalb derselben Organisation
Einheit (Unit) business_unit_id Eine Unterabteilung einer Organisation, optional

Die Eigentümer-Achse überrascht viele. Ein Postfach oder ein persönliches Notizbuch ist für seinen Eigentümer privat, selbst gegenüber Kollegen in derselben Einheit mit derselben Rolle. Ein Administrator legt Richtlinien fest und liest keine Inhalte.

Die Achsen stammen aus der authentifizierten Anfrage und von nirgendwo sonst. Keine Umgebungsvariable, kein Header, kein Abfrageparameter und kein Pfadsegment kann sie setzen. Ein Anfrage-Body, der eine Organisation benennt, wird mit TENANT_NOT_A_PARAMETER abgewiesen. Eine Schnittstelle, die nicht angeben kann, zu welchem Mandanten, Eigentümer und welcher Einheit eine Zeile gehört, verweigert den Zugriff mit 403 SCOPE_PREDICATE_MISSING, und der Body listet auf, welche Achsen aufgelöst wurden und welche nicht. Es gibt niemals einen Rückgriff auf einen breiteren Lesezugriff.

Das gilt an zwei Stellen gleichzeitig.

In der Datenbank. Jeder Dienst verbindet sich unter seinen eigenen Laufzeitrollen: nexus_auth, auth_app und auth_platform für den Identitätsdienst, nexus_probitas und nexus_probitas_ledger für Probitas sowie nexus_gateway, nexus_graphrag, nexus_skills, orchestrator_app, workflows_app und die übrigen für die anderen. Keine davon ist ein Superuser oder besitzt BYPASSRLS. Keine besitzt zudem die Tabellen, die sie verwendet, sodass jede Richtlinie für Sicherheit auf Zeilenebene (Row-Level Security, RLS) für sie gilt. Die Rollen teilen sich eine Gruppe, nexus_runtime, die Verbindungs- und Schemanutzungsrechte, aber keinerlei Tabellenrechte gewährt; jedem Dienst werden seine eigenen Tabellen durch seine eigenen Migrationen zugewiesen. Die Mandanteneinstellungen, die RLS-Richtlinien lesen, können nur über die Funktion bind_scope des jeweiligen Dienstes gesetzt werden, die unter ihrem Eigentümer ausgeführt wird. Der Bootstrap entzieht allen anderen das Recht für set_config, und der Orchestrator sowie Probitas verweigern den Start, falls ihre Laufzeitrolle diese Funktion direkt aufrufen könnte (Probitas nennt dies DB_ROLE_SETS_SCOPE_DIRECTLY). Die einzigen Superuser-Verbindungen in der gesamten Installation gehören zum Bootstrap-Job und zum Bereitstellungsschritt des BFF.

Im gemeinsamen Primitiv für eingegrenzte Abfragen (Scoped-Query Primitive). Jedes Repository in der Plattform und jedes auf dem SDK (Software Development Kit) aufbauende Plugin erbt eine Begrenzung (Fence), die das SQL-Prädikat aus einem aufgelösten Geltungsbereich (Scope) erstellt. Seine Scope-Funktion übernimmt die verifizierte Identität und hat keinen Organisationsparameter, sodass ein Aufrufer keinen solchen übergeben kann und keine Route sich davon ausnehmen kann.

Es gibt genau eine Überschreitung der Mandantengrenze, und sie ist eng gefasst: eine aufgezeichnete Freigabe (Grant). Zwei Personen bei der Organisation, die die Zeilen hält, zeichnen auf, welche Organisation welche Tabellen bis wann lesen darf. Jeder Lesevorgang läuft in einer schreibgeschützten Transaktion und wird in beiden Mandanten protokolliert. Eigentümer und Administratoren lesen niemals mandantenübergreifend, und der Lesende kann eine Freigabe nicht ausweiten.

Der KI-Pfad

Aufrufer äußern Wünsche. Der AI Provider Router besitzt die Anmeldedaten und trifft die endgültige Wahl.

Jeder Modellaufruf in Nexus läuft über die /internal/ai/*-Routen des Routers, und der Router lässt nur benannte Aufrufer zu. Das Chart legt drei Listen auf dem Gateway fest:

Routen Wer aufrufen darf
Chat und Chat-Streaming nexus-orchestrator, nexus-workflows, nexus-skills-engine
Embeddings und Rerank nexus-graphrag, nexus-skills-engine, nexus-workflows
Alles andere, einschließlich Tool-Ausführung nexus-orchestrator, nexus-workflows

Ein Aufruf ohne Aufruferidentität wird mit 403 MISSING_CALLER_IDENTITY abgewiesen, und ein Aufrufer, der nicht auf der Liste steht, mit 403 UNAUTHORIZED_CALLER. Plugins stehen auf keiner Liste, und das ist beabsichtigt: Die Modellaufrufe eines Plugins erfolgen in seinem Namen über den UNO-Dispatch.

Was ein Aufrufer senden darf, ist ein Wunsch: ein bevorzugter Anbieter und ein Modell sowie ein Fähigkeitsprofil wie etwa eine Mindestkontextlänge oder Tool-Nutzung. Der Router erfüllt einen Wunsch nur dann, wenn die Organisation diesen Anbieter aktiviert und mit Anmeldedaten versehen hat; andernfalls ersetzt er ihn, zuerst innerhalb desselben Anbieters, dann über die anderen Anbieter der Organisation hinweg. Ein Fähigkeitsprofil filtert lediglich, und eine darin enthaltene Anforderung an den Datenstandort (Data Residency) ist strikt. Wenn nichts passt, gibt es kein Fallback-Modell: Der Aufrufer erhält 422 MODEL_CAPABILITY_UNAVAILABLE oder 422 NO_PROVIDER_FOR_ROLE zusammen mit einem Hinweis zur Behebung, den die Konsole einem Administrator anzeigt.

Die Schlüssel gehören der Organisation. Die Administratoren jeder Organisation legen ihre eigenen Anbieterschlüssel über die Konsole in deren Pool ab, und der Router löst sie zum Zeitpunkt des Aufrufs auf. Kein Modellschlüssel ist ein Chart-Wert und keiner wird mit Nexus ausgeliefert. Eine Organisation ohne Schlüssel erhält keine KI-Antworten, und die Konsole sagt dies klar und deutlich; nichts füllt die Lücke von anderer Stelle aus.

Zwei Chart-Werte bestimmen den Router. ai.localProvider.baseUrl benennt einen von Ihnen betriebenen OpenAI-kompatiblen Modellserver, der wie jeder andere Anbieter geroutet wird. ai.installationHosts listet Ihre Modellserver unter privaten Namen auf, die der Router als Teil der Installation zählt. GraphRAG erzeugt Einbettungen ebenfalls über den Router, und zwar im Namen der Organisation, der die Inhalte gehören. Das Standard-Einbettungsmodell läuft im Cluster ohne Grafikkarte; gehostete Einbettungen sind die freie Wahl jeder Organisation.

Keine Telemetrie

Nichts verlässt eine Installation, sofern Sie es nicht senden. Der Wert telemetry.enabled des Charts kann nur false lauten; das Schema lehnt alles andere ab. Die eigene Berichterstattung der Datenschicht ist ebenfalls abgeschaltet: Der Nutzungsbericht von Neo4j und die Telemetrie von Qdrant sind im Chart deaktiviert.

Wenn networkPolicy.enabled aktiviert ist – was dem Standard entspricht –, kann kein Pod das Internet erreichen, es sei denn, Sie führen das Ziel in networkPolicy.externalEgressCIDRs auf. Ein gehosteter Modellanbieter ist ein solches Ziel, ebenso wie Ihr Mail-Relay.

Dieselbe Regel hat einen Standardwert geändert, den Sie bemerken werden. Das CAPTCHA von nexus-auth für Registrierungen benötigt einen Internetdienst; daher ist es in einer Installation deaktiviert, und die Registrierung eines Unbekannten wartet auf die Freigabe durch einen Administrator (403 SIGNUP_REQUIRES_APPROVAL). Die Prüfung, die Registrierungen aus Hosting-Netzwerken blockiert, ist ebenfalls deaktiviert, da sie lizenzierte Datenbanken benötigt, die Nexus nicht mitliefert. Diese Vorprüfung entfällt für Sie.

Zustand der Installation
Zustand der Installation
Bei Enterprise zeigt die Statusseite das Cluster unter Nexus: wie ausgelastet jeder Teil ist und wie viel Kapazität noch verbleibt, wobei neben jeder Warnung steht, was dagegen zu tun ist.