Version 1.0.0-alpha.1aktuell
Kapitel 2.11
Varianten: Externe Speicher, TLS und Ingress
Die Konfigurationswerte, mit denen Nexus an einen bereits bestehenden Cluster angepasst wird – einschließlich TLS (Transport Layer Security), bereits von Ihnen betriebener Datenbanken, eigener Zertifikate, eines anderen Ingress-Controllers, Speicherklassen, E-Mail, Proxys, Replikaten und verwaltetem Kubernetes.
Diese Seite wurde mithilfe von KI aus dem englischen Original übersetzt. Bei Unklarheiten gilt die englische Seite als Referenz. Diese Seite auf Englisch lesen

Der Produktions-Cluster der Harrow Port Authority ist kein unbeschriebenes Blatt, und allein das Thema TLS (Transport Layer Security) umfasst drei Teile. Das Datenbankteam betreibt PostgreSQL auf eigenen Rechnern und möchte jede Datenbank dort haben, gesichert nach seinen eigenen Verfahren. Zertifikate stammen von Harrows interner CA (Certificate Authority, Zertifizierungsstelle) über cert-manager. Der Ingress-Controller ist nicht Traefik und befindet sich in seinem eigenen Namespace. Nichts davon erfordert einen Fork des Charts. Jede Abweichung ist ein Konfigurationswert, und dieses Kapitel geht sie in der Reihenfolge durch, in der Tomás Reilly auf sie gestoßen ist.
Jeder Werteblock in diesem Kapitel ist ein Fragment. Führen Sie die benötigten Blöcke in Ihrer eigenen Werte-Datei zusammen, neben global, hosts, edition und keys aus Kapitel 2.6, Installation von Community auf Kubernetes. Das Schema des Charts weist jeden Schlüssel zurück, den es nicht kennt, sodass ein falsch geschriebener Schlüssel helm lint --strict und die Installation fehlschlagen lässt, anstatt ignoriert zu werden. Das ist beabsichtigt: Ein Tippfehler in dataTier, der stillschweigend einen Datenspeicher im Cluster belässt, wäre schlimmer als ein Fehler.
Externe Datenspeicher
Nexus hält seine Daten in fünf Speichern. Standardmäßig läuft jeder davon innerhalb des Clusters aus dem eigenen signierten Image des Releases, mit seinem eigenen Volume.
| Speicher | Values-Schlüssel | Cluster-interner Standard | Standard-Volume |
|---|---|---|---|
| PostgreSQL 16 mit PostGIS 3 und pgvector 0.8 | dataTier.postgres |
das Release-Image | 50Gi |
| Valkey 8.1 | dataTier.valkey |
das Release-Image | 5Gi |
| Neo4j 5.26 Community Edition | dataTier.neo4j |
das Release-Image | 20Gi |
| Qdrant 1.15 | dataTier.qdrant |
das Release-Image | 10Gi |
| SeaweedFS 4.48, der mit Amazon S3 (Simple Storage Service) kompatible Objektspeicher | dataTier.objectStore |
das Release-Image | 50Gi |
Jeder davon kann durch einen Speicher ersetzt werden, den Sie selbst betreiben. Setzen Sie dessen mode auf external, geben Sie seinen Host an und benennen Sie ein Secret, das seine Zugangsdaten enthält. Fügen Sie die Adresse des Speichers auch zu networkPolicy.externalEgressCIDRs hinzu (siehe den Abschnitt zur Netzwerkrichtlinie weiter unten), da der Namespace jeden anderen ausgehenden Datenverkehr (Egress) verweigert. Für einen externen Speicher rendert das Chart nichts von diesem Speicher: kein StatefulSet, keinen Service und kein Volume. Die Dienste verbinden sich mit dem von Ihnen angegebenen Host.
# harrow-external-postgres.yaml (Helm values)
dataTier:
postgres:
mode: external
port: 5432
sslmode: verify-full
external:
host: pg-nexus.db.harrow.example
existingSecret: harrow-postgresDas Secret wird von Ihnen vor der Installation in dem Namespace erstellt, in den Nexus installiert wird. Das Chart speichert lediglich dessen Namen: Die Pods, die Zugangsdaten benötigen, lesen diese beim Start aus Ihrem Secret, und nichts wird in die eigenen Secrets des Charts kopiert. Ändern Sie Zugangsdaten und starten Sie die Pods neu, die sie verwenden; es muss nichts neu gerendert werden.
Jeder Speicher sucht nach festen Schlüsselnamen in seinem Secret:
| Speicher | Schlüssel im zugehörigen Secret |
|---|---|
| PostgreSQL | username und password für einen Superuser auf diesem Server sowie ca.crt, die Zertifizierungsstelle (CA), die das Zertifikat des Servers signiert hat |
| Valkey | password |
| Neo4j | username und password |
| Qdrant | api-key |
| Objektspeicher | access-key und secret-key |
Laden Sie jeden Wert aus einer Datei, damit er nicht in Ihrer Shell-Historie und nicht in Ihrer Werte-Datei auftaucht:
kubectl create namespace nexus
kubectl -n nexus create secret generic harrow-postgres \
--from-file=username=./pg-username --from-file=password=./pg-password --from-file=ca.crt=./harrow-db-ca.crtEin externer Speicher ohne benanntes Secret bricht das Rendern ab, genau wie einer ohne Host.
PostgreSQL
Der externe Server muss das bieten, was das Release-Image bietet: PostgreSQL 16 mit PostGIS 3 und pgvector. Der Datenverkehr dorthin wird immer verschlüsselt und gegen das ca.crt in Ihrem Secret geprüft. Setzen Sie sslmode auf verify-full, wodurch auch geprüft wird, ob das Zertifikat des Servers den von Ihnen angegebenen Host nennt, oder auf verify-ca. Bei einem externen Server verweigert das Rendern disable und require. Bei cluster-internem Postgres ist es umgekehrt: Dessen Datenverkehr verlässt niemals den Namespace, die Netzwerkrichtlinie hält ihn dort fest, und es akzeptiert nur disable. Welchen Modus Sie auch wählen, das Zertifikat muss den Host in external.host nennen, da einige der Dienste den Namen bei jeder Verbindung prüfen.
Bei der Installation verbindet sich ein Bootstrap-Job über das Konto in Ihrem Secret mit dem Server und legt die Rollen an, unter denen Nexus läuft. Er erstellt eine Migrator-Rolle, der das Schema gehört, eine Laufzeit-Rolle und eine Login-Rolle für jeden Dienst. Nexus generiert deren Passwörter und verwahrt sie. Keine dieser Rollen ist ein Superuser und keine kann die Sicherheit auf Zeilenebene (Row-Level Security) umgehen, sodass jede Isolationsrichtlinie in der Datenbank für jeden Dienst gilt. Der Bootstrap selbst benötigt jedoch einen Superuser: Einer seiner Schritte sperrt eine integrierte PostgreSQL-Funktion, und das darf nur ein Superuser. Nur der Bootstrap und der eigene Bereitstellungsschritt der Konsole verwenden dieses Konto. Ein verwalteter Datenbankdienst, dessen Administratorrolle kein echter Superuser ist, kann die Nexus-Datenbank aus diesem Grund nicht hosten.
Der Job prüft Ihren Server, bevor er Änderungen vornimmt. Er bricht ab, ohne etwas geändert zu haben, wenn das Konto in Ihrem Secret kein Superuser ist. Wenn bereits eine Rolle namens nexus mit SUPERUSER oder BYPASSRLS existiert, bricht der Job mit nexus-db-bootstrap: role nexus exists with SUPERUSER or BYPASSRLS on this server; nexus_migrator will not be made a member of it. Nothing more was done. ab. Entfernen Sie diese Attribute von dieser Rolle oder verwenden Sie einen Server, auf dem der Name frei ist, und starten Sie die Installation erneut.
Valkey, Neo4j, Qdrant und der Objektspeicher
Die anderen vier verwenden dieselben drei Einstellungen: mode, external.host und external.existingSecret. Hier sind alle vier auf Harrows eigene Systeme umgestellt:
# harrow-external-stores.yaml (Helm values)
dataTier:
valkey:
mode: external
external: { host: valkey.db.harrow.example, existingSecret: harrow-valkey }
neo4j:
mode: external
external: { host: neo4j.db.harrow.example, existingSecret: harrow-neo4j }
qdrant:
mode: external
external: { host: qdrant.db.harrow.example, existingSecret: harrow-qdrant }
objectStore:
mode: external
external: { host: objects.db.harrow.example, existingSecret: harrow-objects }Betreiben Sie die in der obigen Tabelle aufgeführten Versionen der Release-Images auf den Ports, die die Dienste verwenden. Valkey lauscht auf 6379 und Neo4j auf 7687; Qdrant verwendet 6333 und der Objektspeicher 8333. Der Objektspeicher muss S3-kompatibel sein. Das Valkey-Passwort wird innerhalb jedes Pods in eine Verbindungsadresse eingefügt; beschränken Sie es daher auf Buchstaben und Ziffern (die Zeichen -._~ sind ebenfalls zulässig).
Wenn mode auf external gesetzt und external.host leer ist, bricht das Rendern mit dataTier.<store>.external.host is required when mode is external ab. Einen Speicher von cluster-intern auf extern umzustellen, nachdem Benutzer bereits mit Nexus gearbeitet haben, erfordert eine Datenmigration, die Sie selbst durchführen müssen; das Chart kopiert nichts für Sie. Treffen Sie diese Entscheidung vor der ersten Installation.
Der Schlüsselspeicher, OpenBao, ist nicht in dieser Liste enthalten und kann nicht extern betrieben werden. Er ist Teil der Identität der Installation und läuft bei jeder Installation im Cluster.
TLS am öffentlichen Netzwerkrand
tls.mode legt fest, wie die drei öffentlichen Hosts ihre Zertifikate erhalten, und nichts weiter. Der Datenverkehr zwischen den Diensten verwendet unabhängig vom Modus immer gegenseitiges TLS (mTLS) mit Zertifikaten der chart-eigenen lokalen CA, die von cert-manager ausgestellt werden. Es gibt kein Service-Mesh, und istio.enabled bleibt false.
tls.mode |
Wer das Zertifikat erstellt | Was Sie einstellen müssen |
|---|---|---|
existing (der Standard) |
Sie. Ein einziges Secret enthält ein Zertifikat für alle drei Hosts. | tls.existingSecret |
cert-manager |
Ein ClusterIssuer, den Sie bereits betreiben. Das Chart fordert dort ein Zertifikat pro Host an. | tls.clusterIssuer |
none |
Niemand im Cluster. TLS endet davor, an Ihrem Load Balancer oder Proxy. | Nichts, aber lesen Sie die Warnung unten |
existing
# harrow-tls-existing.yaml (Helm values)
tls:
mode: existing
existingSecret: harrow-public-tlsJeder Ingress liefert das Secret harrow-public-tls aus, daher muss dessen Zertifikat console.harrow.example, api.harrow.example und auth.harrow.example nennen. Erstellen Sie es vor der Installation im Namespace:
kubectl -n nexus create secret tls harrow-public-tls --cert=harrow-public.crt --key=harrow-public.keyPreflight liest es aus, warnt, wenn es innerhalb von 30 Tagen abläuft, und nennt das Secret, falls es fehlt. Wenn der Modus existing ist und der Name leer bleibt, bricht das Rendern mit tls.existingSecret is required when tls.mode is existing ab.
cert-manager
# harrow-tls-cert-manager.yaml (Helm values)
tls:
mode: cert-manager
clusterIssuer: harrow-internal-caDas Chart fügt jedem der drei Ingresses die Annotation cert-manager.io/cluster-issuer hinzu, und cert-manager erstellt die Secrets nexus-console-tls, nexus-api-tls und nexus-auth-tls. Ohne tls.clusterIssuer bricht das Rendern mit tls.clusterIssuer is required when tls.mode is cert-manager ab.
Wenn Ihr Issuer ACME (Automatic Certificate Management Environment) mit der HTTP-01-Challenge verwendet, ist nichts weiter erforderlich. Das Chart fügt keine eigene Weiterleitung hinzu, sodass eine Anfrage für /.well-known/acme-challenge/ unverändert den Solver Ihres Issuers erreicht. An einem Standort ohne Internetverbindung ist auch der Solver ein Image: Legen Sie das cert-manager-acmesolver-Image von cert-manager in Ihrer Registry ab, andernfalls verharrt jeder Challenge-Pod im Status ErrImagePull.
keiner
# harrow-tls-none.yaml (Helm values)
tls:
mode: none
proxy:
trustedCIDRs: "10.30.0.0/16"Bei none enthalten die Ingresses keinen TLS-Abschnitt. Verwenden Sie dies, wenn ein dem Cluster vorgeschalteter Load Balancer oder Reverse Proxy TLS für die drei Hosts terminiert.
proxy.trustedCIDRs benennt die Proxy-Hops, deren X-Forwarded-For-Header nexus-auth vertraut. Der Standardwert, 10.42.0.0/16, ist das Pod-Netzwerk von k3s, in dem dessen Ingress-Controller läuft. Setzen Sie ihn auf jedem anderen Cluster auf das Netzwerk, das die Pods Ihres Ingress-Controllers verwenden, damit Ratenbegrenzungen bei der Anmeldung und Audit-Protokolle die Adresse des Benutzers und nicht die des Proxys erfassen.
Ingress-Controller
Das Chart erstellt drei einfache Kubernetes-Ingresses, einen pro öffentlichem Host. Jeder leitet den Pfad / an einen Service weiter.
| Ingress | Host | Service und Port |
|---|---|---|
nexus-console |
hosts.console |
nexus-alpha, 3000 |
nexus-api |
hosts.api |
nexus-gateway, 9092 |
nexus-auth |
hosts.auth |
nexus-auth, 9101 |
Drei Werte bestimmen deren Gestaltung, und ein Wert in der Netzwerkrichtlinie muss damit übereinstimmen.
# harrow-ingress.yaml (Helm values)
ingress:
enabled: true
className: harrow-nginx
annotations:
"<annotation-key>": "<annotation-value>"
networkPolicy:
ingressNamespace: ingress-harrowingress.classNamebenennt die IngressClass. Bleibt das Feld leer, lässt das Chart die Klasse weg und die Standardklasse des Clusters übernimmt die drei Ingresses. Preflight prüft, ob die Klasse existiert oder, falls Sie keine angegeben haben, ob genau eine Klasse als Standard markiert ist.ingress.annotationswird zu allen drei Ingresses hinzugefügt. Werte sind Zeichenfolgen, setzen Sie Zahlen und boolesche Werte daher in Anführungszeichen. Verwenden Sie dies für die spezifischen Einstellungen Ihres Controllers.ingress.enabled: falserendert überhaupt keinen Ingress – gedacht für Umgebungen, die den Datenverkehr auf andere Weise an die drei Services weiterleiten.networkPolicy.ingressNamespaceist der Namespace, in dem Ihr Ingress-Controller läuft.
Dieser letzte Punkt wird leicht übersehen. Die Netzwerkrichtlinie des Charts verweigert standardmäßig jeglichen eingehenden Datenverkehr in den Namespace und lässt den Ingress-Controller nur aus dem von Ihnen benannten Namespace zu den drei öffentlichen Services durch. Der Standardwert, kube-system, ist richtig für k3s, das Traefik dort ausführt. Wenn Sie ihn bei einem anderen Controller unverändert lassen, kann der Controller Nexus nicht erreichen: Die Ingresses existieren zwar, aber der Controller protokolliert Verbindungszeitüberschreitungen, und der Browser erhält einen Gateway-Fehler. Die Preflight-Prüfung „Ingress ports“ sucht in diesem Namespace nach einem Service, der auf den Ports 80 und 443 als LoadBalancer oder NodePort geöffnet ist, und ihre fix-Zeile nennt diesen Wert.
Der Rest der Netzwerkrichtlinie
networkPolicy.enabled steht standardmäßig auf true und sollte auch so bleiben. Damit erreicht nichts aus dem Namespace heraus die Außenwelt, außer DNS (Domain Name System), die Kubernetes-API (Application Programming Interface) für die Token-Prüfer und die von Ihnen aufgelisteten Adressen.
# harrow-network.yaml (Helm values)
networkPolicy:
apiServerCIDRs: ["10.30.0.1/32"]
externalEgressCIDRs: ["10.30.40.25/32"]apiServerCIDRs ist die Adresse des API-Servers als /32-CIDRs (Classless Inter-Domain Routing). Ist das Feld leer, liest das Chart sie bei der Installation aus dem Cluster aus. helm template hat keinen Cluster zum Auslesen, geben Sie sie dort also an. externalEgressCIDRs umfasst alles andere, was ein Workload erreichen darf, und ist standardmäßig leer. Harrow trägt hier sein Mail-Relay ein. Jeder externe Datenspeicher außerhalb des Namespaces muss hier ebenfalls aufgeführt werden, da sonst die Standard-Verweigerungsrichtlinie (Default-Deny) verhindert, dass die Dienste ihn erreichen.
Nur drei Workloads kommunizieren jemals mit dem API-Server: der Nachweisdienst nexus-probitas, der Orchestrator und der Custody-Job des Schlüsselspeichers. Sie prüfen die Service-Account-Tokens, die andere Workloads vorlegen. Die Richtlinie gibt die Adresse des API-Servers auf den Ports 6443 und 443 nur für diese drei frei und für nichts anderes. Wenn die drei ihn nicht erreichen können, können sie die von anderen Workloads vorgelegten Tokens nicht prüfen; geben Sie daher jede Adresse an, die er haben kann.
Auswahl eines TLS-Modus
Harrow entschied sich für cert-manager mit seiner internen CA als ClusterIssuer, und der Grund dafür war die Zertifikatserneuerung. Bei existing muss eine Person das Zertifikat im Secret erneuern, bevor es abläuft, und die 30-Tage-Warnung von Preflight ist die einzige Erinnerung. Bei cert-manager erfolgt die Erneuerung von selbst, und niemand muss daran denken. none eignet sich für Standorte, an denen ohnehin jede öffentliche Adresse hinter einem Load Balancer liegt, der TLS für viele Systeme terminiert, und an denen das dortige Team die Zertifikate verwaltet. Wofür Sie sich auch entscheiden, das Zertifikat, das ein Browser sieht, muss eines sein, dem der Browser vertraut. Ein selbstsigniertes Zertifikat, dessen Warnung Benutzer wegklicken, macht Passkeys unbrauchbar, da Chrome hinter einer Zertifikatswarnung keinen Passkey erstellt oder verwendet.
Speicher, E-Mail sowie Replikate und Ressourcen
StorageClass
# harrow-storage.yaml (Helm values)
storage:
className: harrow-ssd
dataTier:
postgres:
size: 200Gi
objectStore:
size: 500Gistorage.className gilt für jeden PVC (Persistent Volume Claim) der Datenschicht sowie für die Volumes des Schlüsselspeichers. Leer bedeutet die Standardklasse des Clusters, und Preflight schlägt fehl, wenn keine Klasse als Standard markiert ist und Sie keine benannt haben. Jeder cluster-interne Speicher hat seine eigene size. Die des Schlüsselspeichers sind keys.openbao.storage.unsealer und keys.openbao.storage.keystore, sowie keys.receiptsStorage für Quittungen. Wählen Sie die Größen so, dass sie für das Wachstum eines Jahres ausreichen.
# harrow-mail.yaml (Helm values)
smtp:
existingSecret: harrow-smtpNexus versendet Einladungen und Benachrichtigungen über Ihren Mailserver. smtp.existingSecret benennt ein Secret, das Sie im Namespace mit den Daten des Mailservers erstellen. Wie bei jeder Integration übernimmt das Chart nur den Namen eines Secrets und niemals Zugangsdaten. Denken Sie an die Netzwerkrichtlinie: Fügen Sie die Adresse des Relays zu networkPolicy.externalEgressCIDRs hinzu, sonst bleibt der E-Mail-Verkehr an der Grenze des Namespaces hängen. Solange der E-Mail-Versand nicht funktioniert, können keine Einladungen gesendet werden, worauf die Checkliste des ersten Administrators auch hinweist.
Replikate und Ressourcen
Jede Kernkomponente verfügt über eine Replikatanzahl und Kubernetes-Ressourcen unter components, und jeder cluster-interne Speicher hat Ressourcen unter dataTier.
# harrow-sizing.yaml (Helm values)
components:
console: { replicas: 2, resources: { requests: { cpu: 200m, memory: 512Mi }, limits: { memory: 1Gi } } }
auth: { replicas: 2 }
gateway: { replicas: 2, resources: { requests: { cpu: 400m, memory: 1Gi }, limits: { memory: 2Gi } } }
graphrag: { resources: { requests: { cpu: 400m, memory: 1Gi }, limits: { memory: 3Gi } } }
dataTier:
postgres:
resources: { requests: { cpu: "1", memory: 4Gi }, limits: { memory: 8Gi } }
neo4j:
heap: 2G
pagecache: 1G
resources: { requests: { cpu: 500m, memory: 4Gi }, limits: { memory: 4Gi } }Der Standard-Neo4j-Pod fordert 2 GiB an und darf bis zu 4 GiB verwenden. Bei 3 GB Heap und Page-Cache sollten Sie auch seine Anforderung (Request) erhöhen, damit der Pod auf einem Node platziert wird, der über diesen Arbeitsspeicher verfügt.
Die Komponenten mit replicas und resources sind console, bff, auth, orchestrator, workflows, gateway, graphrag, probitas und skillsEngine. Der Schlüsseldienst, keys, akzeptiert nur resources. Diese Kernkomponenten sind erforderlich und können nicht abgeschaltet werden; das Chart führt sie unabhängig davon aus, was ihr enabled-Schalter besagt. Die Speicher der Datenschicht laufen mit jeweils einem Replikat.
Auf langsamem Speicher geben zwei weitere Werte den Diensten mehr Zeit zum Starten: probes.startupFailureThreshold (standardmäßig 60) und schemaWait.timeoutSeconds (1800) legen fest, wie lange ein Dienst auf seine Datenbankmigrationen wartet, bevor sein Start-Container namentlich fehlschlägt.
Anmeldesitzungen, Ratenbegrenzungen und private Modell-Hosts
Drei kleinere Gruppen von Werten sollte man vor der Installation kennen, da sie den Benutzern bereits am ersten Tag auffallen.
# harrow-auth.yaml (Helm values)
auth:
accessTokenTTL: 15m
refreshTokenTTL: 12h
rateLimitPerMinute: 5000
ai:
installationHosts: [models.harrow.internal, .gpu.harrow.internal]auth.accessTokenTTL und auth.refreshTokenTTL geben an, wie lange die beiden Tokens einer Sitzung gültig sind. Die Standardwerte von 15 Minuten und 12 Stunden bedeuten, dass sich eine Person, die abends den Laptop zuklappt, morgens neu anmelden muss. Verkürzen Sie die Gültigkeit des Refresh-Tokens, wenn Ihre Richtlinie dies verlangt, und rechnen Sie dann mit häufigeren Anmeldungen.
auth.rateLimitPerMinute ist die Höchstzahl an Anfragen, die eine angemeldete Person pro Minute an den Anmeldedienst richten darf, bevor dieser mit 429 antwortet. Der Standardwert 5000 entspricht etwa 83 Anfragen pro Sekunde von einem Konto – mehr als genug für die Konsole und für Skripte. Eine Installation kennt keine Abonnementtarife, daher gilt für jede Person dasselbe Limit. Senken Sie es, um den Schutz vor Missbrauch zu verschärfen, oder erhöhen Sie es für umfangreiche Automatisierungen. Der Brute-Force-Schutz bei der Anmeldung, wie etwa Kontosperrungen und Begrenzungen für Versuche beim zweiten Faktor, ist davon getrennt und wird nicht hier eingestellt.
ai.installationHosts führt zusätzliche Hostnamen innerhalb der Installation auf, gedacht für die eigenen KI-Modellserver (Künstliche Intelligenz) der Organisation unter privaten Namen. Jeder Eintrag ist ein Hostname, ein .suffix, das auf jeden darunterliegenden Namen passt, eine IP-Adresse oder ein IPv4-CIDR-Block (Classless Inter-Domain Routing). Der Router behandelt sie neben den eigenen Hosts des Releases als Teil der Installation. Der Modellserver selbst wird in ai.localProvider.baseUrl benannt; Kapitel 2.14, KI-Anbieter und -Modelle, behandelt beides.
Was niemals in die Values-Datei gehört
Einige Dinge, nach denen in einer Werte-Datei oft gesucht wird, fehlen dort aus gutem Grund.
| Nicht in der Werte-Datei | Warum, und wo es stattdessen zu finden ist |
|---|---|
| Die Lizenz | Sie wird nach der Installation importiert, entweder in der Konsole oder mit nexusctl licence import <file>. Eine Lizenz ist niemals ein Chart-Wert oder eine eingebundene Datei. Kapitel 2.13, Lizenzen, enthält die Details. |
| Modellschlüssel | Jede Organisation verwahrt ihre eigenen Schlüssel in ihrem eigenen Pool, die in der Konsole eingegeben werden. Zugangsdaten für KI-Anbieter sind niemals ein Chart-Wert. |
| Absicherung der Registrierung | Das Internet-CAPTCHA und der Netzwerkfilter bei der Registrierung sind bei einer lokalen Installation beide deaktiviert, und es gibt keinen Wert, um sie einzuschalten. Das CAPTCHA würde bei jeder Registrierung eine Internetverbindung erfordern. Der Netzwerkfilter bräuchte eine lizenzierte Geolokalisierungsdatenbank, die das Chart nicht mitbringt. Die Registrierung eines Unbekannten wird stattdessen zur Freigabe durch einen Administrator zurückgehalten, wie in Kapitel 2.12, Der erste Start, erläutert wird. |
| Telemetrie | Das Schema akzeptiert nur eine Einstellung für telemetry.enabled, nämlich false. Nichts verlässt eine Installation, und die eigenen Berichte der Datenschicht (der Nutzungsbericht von Neo4j, die Telemetrie von Qdrant) sind ebenfalls abgeschaltet. |
Die gesamte Datei vor der Installation überprüfen
Wenn Sie die Fragmente in einer Datei zusammengeführt haben, führen Sie von Ihrer Workstation aus zwei Prüfungen darauf aus. helm lint --strict validiert jeden Schlüssel gegen das Schema des Charts, und helm template rendert das gesamte Release zur Durchsicht, bevor irgendetwas erstellt wird. Die Befehle verwenden die Adresse des Community-Charts; geben Sie für Enterprise stattdessen den Pfad des heruntergeladenen Enterprise-Charts an (Kapitel 2.7, Installation von Enterprise und Anwenden einer Lizenz). Ein Rendervorgang auf Ihrer Workstation kann die Adresse des API-Servers nicht aus einem Cluster auslesen, tragen Sie daher zuerst networkPolicy.apiServerCIDRs in die Datei ein.
Die beiden Prüfungen:
helm lint --strict oci://registry.adverant.ai/nexus/charts/nexus --version 1.0.0-alpha.1 -f harrow-prod-values.yaml
helm template nexus oci://registry.adverant.ai/nexus/charts/nexus --version 1.0.0-alpha.1 \
-n nexus -f harrow-prod-values.yaml > harrow-render.yamlEin falsch geschriebener Schlüssel lässt den Lint-Vorgang mit „additional properties“ fehlschlagen und nennt den Schlüssel. Ein fehlender Pflichtwert, wie etwa ein Host bei einem externen Speicher, lässt das Rendern mit dem in diesem Kapitel zitierten Satz fehlschlagen. helm template hat keinen Cluster zum Auslesen; geben Sie daher networkPolicy.apiServerCIDRs an, wenn Sie offline rendern, sonst hält der Vorgang an und fordert diese Werte an.
Führen Sie anschließend Preflight mit derselben Datei aus. Preflight ist die einzige Prüfung, die den Cluster und die Werte gemeinsam ausliest: Hier zeigen sich ein falscher Ingress-Namespace, eine fehlende StorageClass oder ein Zertifikat, das nächste Woche abläuft, noch bevor jemand von der Installation abhängig ist.
Verwaltetes Kubernetes
Nexus läuft auf jedem konformen Kubernetes 1.33 oder höher, einschließlich der verwalteten Dienste von Cloud-Anbietern. Nichts im Chart ist auf einen bestimmten Anbieter zugeschnitten. Was sich gegenüber k3s ändert, sind eine Handvoll Werte, die alle oben behandelt wurden:
- cert-manager v1.21.3 wird wie auf jedem Cluster zuerst installiert. | Auf einem verwalteten Cluster | Was einzustellen oder zu prüfen ist | |---|---| | Storage | Nennen Sie die Klasse des Anbieters in
storage.className, oder markieren Sie eine als Standard. | | Ingress | Installieren Sie den von Ihnen verwendeten Ingress-Controller, geben Sie ihn auf den Ports 80 und 443 frei, setzen Sieingress.className, falls er nicht der Standard ist, und setzen SienetworkPolicy.ingressNamespaceauf seinen Namespace. | | Die Proxy-Hops | Setzen Sieproxy.trustedCIDRsauf das Pod-Netzwerk dieses Controllers. | | Der API-Server | Wenn die Installation die Adresse des API-Servers nicht aus dem Cluster auslesen kann, geben Sie sie innetworkPolicy.apiServerCIDRsan. | | Durchsetzung von Netzwerkrichtlinien | Die Richtlinien des Charts greifen nur dort, wo das Netzwerk-Plugin des Clusters NetworkPolicy durchsetzt. Wählen Sie eine Cluster-Konfiguration, die dies tut. | | Images | Die Nodes müssenregistry.adverant.aierreichen können, oder Ihre eigene, inglobal.imageRegistrybenannte Registry. |
Führen Sie vor allem anderen Preflight aus. Es liest den Cluster und die Werte-Datei gemeinsam aus und gibt jeden dieser Punkte als Zeile aus, zusammen mit der passenden Korrektur neben jedem fehlgeschlagenen Punkt. Kapitel 2.5, Preflight mit nexusctl, zeigt den Bericht.

