Prihlásiť saRezervovať brífing

Kapitola 2.11

Obmeny: externé úložiská, TLS a ingress

Hodnoty, ktoré prispôsobia Nexus klastru, ktorý nie je prázdny, vrátane TLS (Transport Layer Security), databáz, ktoré už prevádzkujete, vašich vlastných certifikátov, iného kontroléra ingress, tried úložísk, pošty, proxy serverov, replík a spravovaného prostredia Kubernetes.

Táto stránka bola preložená pomocou AI z anglického originálu. V prípade akýchkoľvek nejasností je rozhodujúca anglická verzia stránky. Prečítať túto stránku v angličtine

17 min čítania

Produkčný klaster spoločnosti Harrow Port Authority nie je prázdny a už samotné riešenie TLS (Transport Layer Security) má tri časti. Databázový tím prevádzkuje PostgreSQL na vlastných strojoch a chce mať každú databázu tam, zálohovanú vlastným spôsobom. Certifikáty pochádzajú z internej CA (certifikačnej autority) spoločnosti Harrow prostredníctvom nástroja cert-manager. Ingress kontrolér nie je Traefik a nachádza sa vo vlastnom mennom priestore. Nič z toho si nevyžaduje vytvorenie odnože (forku) chartu. Každý rozdiel predstavuje jednu hodnotu a táto kapitola ich prechádza v poradí, v akom sa s nimi stretol Tomás Reilly.

Každý blok hodnôt v tejto kapitole je útržok. Zlúčte tie, ktoré potrebujete, do vlastného súboru hodnôt popri global, hosts, edition a keys z kapitoly 2.6, Inštalácia edície Community v prostredí Kubernetes. Schéma chartu odmietne akýkoľvek neznámy kľúč, takže preklep v názve kľúča spôsobí zlyhanie helm lint --strict a celej inštalácie namiesto toho, aby bol ignorovaný. Je to zámer: preklep v dataTier, ktorý by potichu ponechal úložisko v klastri, by bol horší ako chyba.

Externé dátové úložiská

Nexus uchováva svoje dáta v piatich úložiskách. Štandardne každé z nich beží vo vnútri klastra z vlastného podpísaného obrazu daného vydania a s vlastným zväzkom (volume).

Úložisko Kľúč v súbore hodnôt Predvolené nastavenie v klastri Predvolený zväzok
PostgreSQL 16 s PostGIS 3 a pgvector 0.8 dataTier.postgres obraz vydania 50Gi
Valkey 8.1 dataTier.valkey obraz vydania 5Gi
Neo4j 5.26 Community Edition dataTier.neo4j obraz vydania 20Gi
Qdrant 1.15 dataTier.qdrant obraz vydania 10Gi
SeaweedFS 4.48, objektové úložisko kompatibilné so službou Amazon S3 (Simple Storage Service) dataTier.objectStore obraz vydania 50Gi

Ktorékoľvek z nich môžete namiesto toho prevádzkovať sami. Nastavte jeho mode na external, zadajte jeho hostiteľa a pomenujte objekt Secret, ktorý uchováva jeho prihlasovacie údaje. Pridajte adresu úložiska aj do networkPolicy.externalEgressCIDRs (pozrite si časť o sieťovej politike nižšie), pretože menný priestor zakazuje všetku ostatnú odchádzajúcu prevádzku (egress). Pre externé úložisko chart nevygeneruje nič z daného úložiska: žiadny StatefulSet, žiadny Service a žiadny zväzok. Služby sa pripoja k hostiteľovi, ktorého ste zadali.

# harrow-external-postgres.yaml (Helm values)
dataTier:
  postgres:
    mode: external
    port: 5432
    sslmode: verify-full
    external:
      host: pg-nexus.db.harrow.example
      existingSecret: harrow-postgres

Objekt Secret vytvoríte vy pred samotnou inštaláciou v mennom priestore, do ktorého sa Nexus inštaluje. Chart si vždy uchováva iba jeho názov: pody, ktoré potrebujú prihlasovacie údaje, ich pri štarte načítajú z vášho objektu Secret a nič sa nekopíruje do vlastných objektov Secret chartu. Ak zmeníte prihlasovacie údaje, reštartujte pody, ktoré ich používajú; nie je potrebné nič znova generovať.

Každé úložisko hľadá vo svojom objekte Secret pevne stanovené názvy kľúčov:

Úložisko Kľúče v jeho objekte Secret
PostgreSQL username a password pre superpoužívateľa na danom serveri a ca.crt, certifikačnú autoritu (CA), ktorá podpísala certifikát servera
Valkey password
Neo4j username a password
Qdrant api-key
Objektové úložisko access-key a secret-key

Načítajte každú hodnotu zo súboru, aby nezostala v histórii vášho príkazového riadka (shell) ani vo vašom súbore hodnôt:

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.crt

Externé úložisko bez pomenovaného objektu Secret zastaví generovanie (render) presne tak isto ako úložisko bez zadaného hostiteľa.

PostgreSQL

Externý server musí ponúkať to, čo ponúka obraz vydania: PostgreSQL 16 s rozšíreniami PostGIS 3 a pgvector. Prevádzka smerujúca naň je vždy šifrovaná a kontrolovaná voči ca.crt vo vašom objekte Secret. Nastavte sslmode na verify-full, čo zároveň kontroluje, či certifikát servera uvádza vami zadaného hostiteľa, alebo na verify-ca. Pri externom serveri generovanie odmietne disable a require. Pri databáze Postgres v klastri je to naopak: jej prevádzka nikdy neopúšťa menný priestor, sieťová politika ju drží vo vnútri a prijíma iba disable. Nech si vyberiete ktorýkoľvek režim, certifikát musí uvádzať hostiteľa v external.host, pretože niektoré služby kontrolujú názov pri každom pripojení.

Pri inštalácii sa zavádzacia úloha (bootstrap Job) pripojí k serveru pomocou účtu z vášho objektu Secret a vytvorí roly, pod ktorými Nexus beží. Vytvorí rolu migrátora, ktorá vlastní schému, prevádzkovú (runtime) rolu a jednu prihlasovaciu rolu pre každú službu. Nexus vygeneruje ich heslá a uchová ich. Žiadna z nich nie je superpoužívateľom a žiadna nemôže obísť zabezpečenie na úrovni riadkov (row-level security), takže každá politika izolácie v databáze sa vzťahuje na každú službu. Samotný zavádzací proces však superpoužívateľa potrebuje: jeden z jeho krokov uzamkne vstavanú funkciu PostgreSQL a to môže urobiť iba superpoužívateľ. Tento účet používa iba zavádzací proces a vlastný zriaďovací (provisioning) krok konzoly. Spravovaná databázová služba, ktorej rola správcu nie je skutočným superpoužívateľom, z tohto dôvodu nemôže hostiť databázu systému Nexus.

Úloha Job skontroluje váš server predtým, ako doň zasiahne. Ak účet vo vašom objekte Secret nie je superpoužívateľom, zastaví sa bez toho, aby čokoľvek zmenila. Ak už existuje rola s názvom nexus s atribútom SUPERUSER alebo BYPASSRLS, úloha Job sa zastaví s chybou 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. Odstráňte tieto atribúty z danej roly alebo použite server, kde je tento názov voľný, a spustite inštaláciu znova.

Valkey, Neo4j, Qdrant a objektové úložisko

Ostatné štyri prijímajú rovnaké tri nastavenia: mode, external.host a external.existingSecret. Tu sú všetky štyri prepnuté na vlastné úložiská spoločnosti Harrow:

# 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 }

Prevádzkujte verzie, ktoré obsahujú obrazy vydania uvedené v tabuľke vyššie, na portoch, ktoré používajú služby. Valkey počúva na porte 6379 a Neo4j na porte 7687; Qdrant používa port 6333 a objektové úložisko port 8333. Objektové úložisko musí byť kompatibilné so štandardom S3. Heslo pre Valkey sa vkladá do adresy pripojenia vo vnútri každého podu, preto v ňom používajte iba písmená a číslice (znaky -._~ sú taktiež v poriadku).

Ak je mode nastavené na external a external.host je prázdne, generovanie sa zastaví s chybou dataTier.<store>.external.host is required when mode is external. Presun úložiska z klastra na externé po tom, čo ľudia začali Nexus používať, predstavuje migráciu dát, ktorú musíte vykonať sami, a chart za vás nič neskopíruje. Rozhodnite sa pred prvou inštaláciou.

Úložisko kľúčov OpenBao v tomto zozname nie je a nemôže byť externé. Je súčasťou identity inštalácie a pri každej inštalácii beží v klastri.

TLS na verejnom okraji siete

tls.mode rozhoduje o tom, ako traja verejní hostitelia získajú svoje certifikáty, a o ničom inom. Prevádzka medzi službami vždy využíva vzájomné TLS (mTLS) s certifikátmi z vlastnej lokálnej CA chartu, ktoré vydáva cert-manager, bez ohľadu na zvolený režim. Nepoužíva sa žiadna sieť služieb (service mesh) a istio.enabled zostáva nastavené na false.

tls.mode Kto vytvára certifikát Čo musíte nastaviť
existing (predvolené) Vy. Jeden objekt Secret uchováva certifikát pre všetkých troch hostiteľov. tls.existingSecret
cert-manager ClusterIssuer, ktorý už prevádzkujete. Chart si od neho vyžiada jeden certifikát pre každého hostiteľa. tls.clusterIssuer
none Nikto v klastri. TLS končí pred ním, na vašom vyvažovači záťaže (load balancer) alebo proxy serveri. Nič, ale prečítajte si upozornenie nižšie

existujúci

# harrow-tls-existing.yaml (Helm values)
tls:
  mode: existing
  existingSecret: harrow-public-tls

Každý Ingress obsluhuje objekt Secret harrow-public-tls, takže jeho certifikát musí uvádzať console.harrow.example, api.harrow.example a auth.harrow.example. Vytvorte ho v mennom priestore pred inštaláciou:

kubectl -n nexus create secret tls harrow-public-tls --cert=harrow-public.crt --key=harrow-public.key

Predletová kontrola (preflight) ho načíta, upozorní, ak jeho platnosť končí do 30 dní, a uvedie názov objektu Secret, ak chýba. Keď je režim nastavený na existing a názov je prázdny, generovanie sa zastaví s chybou tls.existingSecret is required when tls.mode is existing.

cert-manager

# harrow-tls-cert-manager.yaml (Helm values)
tls:
  mode: cert-manager
  clusterIssuer: harrow-internal-ca

Chart pridá anotáciu cert-manager.io/cluster-issuer ku každému z troch objektov Ingress a cert-manager vytvorí objekty Secret nexus-console-tls, nexus-api-tls a nexus-auth-tls. Bez tls.clusterIssuer sa generovanie zastaví s chybou tls.clusterIssuer is required when tls.mode is cert-manager.

Ak váš vydavateľ používa protokol ACME (Automatic Certificate Management Environment) s výzvou HTTP-01, nie je potrebné nič ďalšie. Chart nepridáva žiadne vlastné presmerovanie, takže požiadavka na /.well-known/acme-challenge/ dorazí k riešiteľovi (solver) vášho vydavateľa nezmenená. V lokalite bez prístupu na internet je riešiteľom taktiež obraz: vložte obraz cert-manager-acmesolver nástroja cert-manager do svojho registra, inak bude každý pod výzvy čakať v stave ErrImagePull.

žiadne

# harrow-tls-none.yaml (Helm values)
tls:
  mode: none
proxy:
  trustedCIDRs: "10.30.0.0/16"

Pri nastavení none neobsahujú objekty Ingress žiadnu sekciu TLS. Použite ho vtedy, keď vyvažovač záťaže alebo reverzný proxy server pred klastrom ukončuje TLS pre všetkých troch hostiteľov.

proxy.trustedCIDRs určuje skoky (hops) proxy serverov, ktorých hlavičke X-Forwarded-For služba nexus-auth dôveruje. Predvolená hodnota 10.42.0.0/16 je sieť podov systému k3s, v ktorej beží jeho ingress kontrolér. V akomkoľvek inom klastri ju nastavte na sieť, ktorú používajú pody vášho ingress kontroléra, aby limity frekvencie prihlasovania a audítorské záznamy videli adresu osoby a nie adresu proxy servera.

Adresa, certifikát, proxy a pošta
Adresa, certifikát, proxy a pošta
Po inštalácii majú adresa, certifikát, proxy a pošta svoj vlastný test na jednej stránke a výsledok je vypísaný slovne.

Kontroléry ingress

Chart vytvorí tri bežné objekty Kubernetes Ingress, jeden pre každého verejného hostiteľa. Každý z nich smeruje cestu / na jeden objekt Service.

Ingress Hostiteľ Služba a port
nexus-console hosts.console nexus-alpha, 3000
nexus-api hosts.api nexus-gateway, 9092
nexus-auth hosts.auth nexus-auth, 9101

Formujú ich tri hodnoty a jedna hodnota v sieťovej politike sa s nimi musí zhodovať.

# harrow-ingress.yaml (Helm values)
ingress:
  enabled: true
  className: harrow-nginx
  annotations:
    "<annotation-key>": "<annotation-value>"
networkPolicy:
  ingressNamespace: ingress-harrow
  • ingress.className určuje názov triedy IngressClass. Ak sa ponechá prázdne, chart triedu vynechá a tri objekty Ingress preberie predvolená trieda klastra. Predletová kontrola overí, či trieda existuje, alebo – ak ste žiadnu nepomenovali – či je presne jedna trieda označená ako predvolená.
  • ingress.annotations sa pridá ku všetkým trom objektom Ingress. Hodnoty sú reťazce, preto čísla a booleovské hodnoty uzavrite do úvodzoviek. Použite to pre vlastné nastavenia vášho kontroléra.
  • ingress.enabled: false nevygeneruje vôbec žiadny Ingress, čo je určené pre lokalitu, ktorá smeruje prevádzku na tri objekty Service iným spôsobom.
  • networkPolicy.ingressNamespace je menný priestor, v ktorom beží váš ingress kontrolér.

Práve táto posledná položka ľudí často zaskočí. Sieťová politika chartu štandardne zakazuje všetku prichádzajúcu prevádzku do menného priestoru a následne povolí ingress kontroléru prístup k trom verejným objektom Service iba z menného priestoru, ktorý uvediete. Predvolená hodnota kube-system je správna pre systém k3s, ktorý tam prevádzkuje Traefik. Ak ju pri akomkoľvek inom kontroléri ponecháte nezmenenú, kontrolér sa so systémom Nexus nedokáže spojiť: objekty Ingress síce existujú, ale kontrolér zaznamenáva vypršania časového limitu pripojenia a prehliadač dostane chybu brány (gateway error). Kontrola „Ingress ports“ v rámci predletovej kontroly hľadá v danom mennom priestore objekt Service otvorený na portoch 80 a 443 ako LoadBalancer alebo NodePort a jej riadok fix uvádza túto hodnotu.

Na ľavej strane sa nachádza pole „ingress controller“ vo vnútri prerušovanej hranice označenej „namespace: networkPolicy.ingressNamespace (kube-system on k3s)“. Vychádzajú z neho tri šípky označené console.harrow.example, api.harrow.example a auth.harrow.example. Prechádzajú cez plnú čiaru označenú „nexus namespace: default deny“ a prichádzajú k trom poliam: „nexus-alpha :3000“, „nexus-gateway :9092“ a „nexus-auth :9101“. Štvrtá, sivá šípka z poľa „any other namespace“ sa zastaví na plnej čiare s malým krížikom.
Traja verejní hostitelia, menný priestor ingress kontroléra a sieťová politika, ktorá povoľuje prístup iba tomuto mennému priestoru.

Zvyšok sieťovej politiky

networkPolicy.enabled je štandardne nastavené na true a tak by to malo aj zostať. Pri tomto nastavení sa nič v mennom priestore nedostane von okrem systému DNS (Domain Name System), rozhrania Kubernetes API (aplikačné programovacie rozhranie) pre overovateľov tokenov a adries, ktoré uvediete.

# harrow-network.yaml (Helm values)
networkPolicy:
  apiServerCIDRs: ["10.30.0.1/32"]
  externalEgressCIDRs: ["10.30.40.25/32"]

apiServerCIDRs je adresa servera API vo formáte /32 CIDR (Classless Inter-Domain Routing). Ak je prázdna, chart ju pri inštalácii načíta z klastra. Príkaz helm template nemá k dispozícii žiadny klaster, z ktorého by ju načítal, preto ju zadajte tam. externalEgressCIDRs predstavuje všetko ostatné, kam sa môže pracovná záťaž (workload) pripojiť; štandardne je táto hodnota prázdna. Spoločnosť Harrow tu uvádza svoj poštový prenosový server (mail relay). Musí tu byť uvedené aj každé externé dátové úložisko mimo menného priestoru, inak politika predvoleného zamietnutia zabráni službám, aby sa s ním spojili.

So serverom API komunikujú iba tri pracovné záťaže: služba dôkazov nexus-probitas, orchestrátor a úloha správy (custody Job) úložiska kľúčov. Kontrolujú tokeny servisných účtov, ktorými sa preukazujú ostatné pracovné záťaže. Politika sprístupňuje adresu servera API na portoch 6443 a 443 iba týmto trom a ničomu inému. Ak sa k nemu tieto tri nedokážu pripojiť, nemôžu skontrolovať tokeny, ktorými sa preukazujú ostatné pracovné záťaže, preto uveďte každú adresu, ktorú môže mať.

Výber režimu TLS

Spoločnosť Harrow si zvolila cert-manager so svojou internou CA ako objektom ClusterIssuer a dôvodom bola obnova certifikátov. Pri režime existing musí človek obnoviť certifikát v objekte Secret predtým, ako vyprší jeho platnosť, a jediným pripomenutím je 30-dňové upozornenie predletovej kontroly. Pri režime cert-manager prebieha obnova automaticky a nikto na ňu nemusí myslieť. Režim none vyhovuje lokalite, kde už každá verejná adresa sedí za vyvažovačom záťaže, ktorý ukončuje TLS pre mnohé systémy, a kde certifikáty spravuje príslušný tím. Nech si vyberiete ktorúkoľvek možnosť, certifikát, ktorý vidí prehliadač, musí byť taký, ktorému prehliadač dôveruje. Certifikát s vlastným podpisom (self-signed), cez ktorého varovanie sa ľudia preklikajú, znefunkční prístupové kľúče (passkeys), pretože prehliadač Chrome nevytvorí ani nepoužije prístupový kľúč za varovaním o certifikáte.

Úložisko, pošta, repliky a prostriedky

Trieda úložiska (StorageClass)

# harrow-storage.yaml (Helm values)
storage:
  className: harrow-ssd
dataTier:
  postgres:
    size: 200Gi
  objectStore:
    size: 500Gi

storage.className sa vzťahuje na každú požiadavku PVC (persistent volume claim) dátovej vrstvy a na zväzky úložiska kľúčov. Prázdna hodnota znamená predvolenú triedu klastra a predletová kontrola zlyhá, ak žiadna trieda nie je označená ako predvolená a vy ste žiadnu nepomenovali. Každé úložisko v klastri má vlastné nastavenie size. Pre úložisko kľúčov sú to keys.openbao.storage.unsealer a keys.openbao.storage.keystore, pričom keys.receiptsStorage slúži pre potvrdenia (receipts). Zvoľte veľkosti s ohľadom na ročný nárast.

Pošta

# harrow-mail.yaml (Helm values)
smtp:
  existingSecret: harrow-smtp

Nexus odosiela pozvánky a oznámenia prostredníctvom vášho poštového servera. smtp.existingSecret určuje názov objektu Secret, ktorý vytvoríte v mennom priestore s údajmi o poštovom serveri. Tak ako pri každej integrácii, chart prijíma názov objektu Secret a nikdy nie priamo prihlasovacie údaje. Pamätajte na sieťovú politiku: pridajte adresu prenosového servera do networkPolicy.externalEgressCIDRs, inak sa pošta zastaví na hranici menného priestoru. Kým pošta nefunguje, pozvánky nie je možné odosielať a kontrolný zoznam prvého správcu na to upozorní.

Repliky a prostriedky

Každý základný komponent má počet replík a prostriedky Kubernetes pod kľúčom components a každé úložisko v klastri má prostriedky pod kľúčom 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 } }

Predvolený pod Neo4j si vyžaduje 2 GiB a môže využiť až 4 GiB. Pri 3 GB haldy (heap) a vyrovnávacej pamäte stránok (page cache) zvýšte aj jeho požiadavku (request), aby bol pod umiestnený na uzol, ktorý má dostatok pamäte.

Komponenty s nastaveniami replicas a resources sú console, bff, auth, orchestrator, workflows, gateway, graphrag, probitas a skillsEngine. Služba kľúčov keys prijíma iba resources. Tieto základné komponenty sú povinné a nie je možné ich vypnúť; chart ich spustí bez ohľadu na to, čo hovorí ich prepínač enabled. Úložiská dátovej vrstvy bežia každé v jednej replike.

Na pomalom úložisku dávajú službám čas na spustenie ďalšie dve hodnoty: probes.startupFailureThreshold (štandardne 60) a schemaWait.timeoutSeconds (1800), čo určuje, ako dlho služba čaká na svoje databázové migrácie, kým jej štartovací kontajner zlyhá podľa názvu.

Prihlasovacie relácie, limity frekvencie požiadaviek a súkromné hostiteľské servery modelov

Pred inštaláciou sa oplatí poznať tri menšie skupiny hodnôt, pretože si ich ľudia všimnú už v prvý deň.

# harrow-auth.yaml (Helm values)
auth:
  accessTokenTTL: 15m
  refreshTokenTTL: 12h
  rateLimitPerMinute: 5000
ai:
  installationHosts: [models.harrow.internal, .gpu.harrow.internal]

auth.accessTokenTTL a auth.refreshTokenTTL určujú, ako dlho platia dva tokeny relácie. Predvolené hodnoty, 15 minút a 12 hodín, znamenajú, že osoba, ktorá večer zatvorí prenosný počítač, sa ráno prihlási znova. Skráťte platnosť obnovovacieho (refresh) tokenu, ak si to vyžaduje vaša politika, a počítajte s častejším prihlasovaním.

auth.rateLimitPerMinute je maximálny počet požiadaviek, ktoré môže jedna prihlásená osoba odoslať prihlasovacej službe za minútu predtým, ako služba odpovie kódom 429. Predvolená hodnota 5000 predstavuje približne 83 požiadaviek za sekundu z jedného účtu, čo je dostatok pre konzolu aj pre skripty. Inštalácia nemá žiadne plány predplatného, takže každá osoba dostane rovnaký limit. Znížte ho na sprísnenie ochrany proti zneužitiu alebo ho zvýšte pri intenzívnej automatizácii. Ochrana prihlasovania pred útokmi hrubou silou (brute-force), ako je zablokovanie účtu a limity na pokusy o druhé overenie, je samostatná a nenastavuje sa tu.

ai.installationHosts uvádza zoznam ďalších názvov hostiteľov vo vnútri inštalácie pre vlastné servery modelov AI (umelej inteligencie) organizácie na súkromných názvoch. Každá položka je názov hostiteľa, vzor .suffix, ktorý sa zhoduje s každým názvom pod ním, adresa IP alebo blok IPv4 CIDR (Classless Inter-Domain Routing). Smerovač (router) s nimi zaobchádza ako so súčasťou inštalácie popri vlastných hostiteľoch vydania. Samotný server modelov je pomenovaný v ai.localProvider.baseUrl; kapitola 2.14, Poskytovatelia a modely AI, sa venuje obom.

Čo nikdy nie je hodnota

Niektoré veci, ktoré ľudia hľadajú v súbore hodnôt, tam zámerne nie sú.

Nie je v súbore hodnôt Prečo a kde sa nachádza namiesto toho
Licencia Importuje sa po inštalácii v konzole alebo pomocou nexusctl licence import <file>. Licencia nikdy nie je hodnotou chartu ani pripojeným súborom. Podrobnosti obsahuje kapitola 2.13, Licencie.
Kľúče modelov Každá organizácia si uchováva vlastné kľúče vo vlastnom fonde (pool), ktoré sa zadávajú v konzole. Žiadne prihlasovacie údaje poskytovateľa AI nikdy nie sú hodnotou chartu.
Sprísnenie zabezpečenia registrácie Internetová kontrola CAPTCHA aj sieťové preverovanie pri registrácii sú v inštalácii vypnuté a neexistuje žiadna hodnota, ktorou by sa dali zapnúť. CAPTCHA by vyžadovala prístup na internet pri každej registrácii. Sieťové preverovanie by vyžadovalo licencovanú geolokačnú databázu, ktorú chart neobsahuje. Registrácia neznámej osoby je namiesto toho podržaná na schválenie správcom, ako vysvetľuje kapitola 2.12, Prvé spustenie.
Telemetria Schéma prijíma pre telemetry.enabled jediné nastavenie, ktorým je false. Inštaláciu nič neopúšťa a vypnuté je aj vlastné hlásenie dátovej vrstvy (hlásenie o používaní Neo4j, telemetria Qdrant).

Kontrola celého súboru pred inštaláciou

Keď máte útržky zlúčené do jedného súboru, spustite na ňom zo svojej pracovnej stanice dve kontroly. helm lint --strict overí každý kľúč voči schéme chartu a helm template vygeneruje celé vydanie, aby ste si ho mohli prečítať predtým, ako sa čokoľvek vytvorí. Príkazy používajú adresu chartu edície Community; pre edíciu Enterprise zadajte namiesto toho cestu k chartu Enterprise, ktorý ste si stiahli (kapitola 2.7, Inštalácia edície Enterprise a použitie licencie). Generovanie na vašej pracovnej stanici nedokáže načítať adresu servera API z klastra, preto najprv v súbore nastavte networkPolicy.apiServerCIDRs.

Dve kontroly:

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.yaml

Preklep v názve kľúča spôsobí zlyhanie kontroly lint s chybou „additional properties“ a uvedie názov kľúča. Chýbajúca povinná hodnota, napríklad hostiteľ v prípade externého úložiska, spôsobí zlyhanie generovania s vetou citovanou v tejto kapitole. Príkaz helm template nemá k dispozícii žiadny klaster, z ktorého by čítal, preto pri offline generovaní zadajte networkPolicy.apiServerCIDRs, inak sa zastaví a vyžiada si ich.

Následne spustite predletovú kontrolu s tým istým súborom. Predletová kontrola je jediná kontrola, ktorá číta klaster a hodnoty spoločne: práve pri nej sa ukáže nesprávny menný priestor pre ingress, chýbajúca trieda úložiska alebo certifikát, ktorému o týždeň končí platnosť, ešte predtým, ako bude niekto od inštalácie závislý.

Spravovaný Kubernetes

Nexus beží na akomkoľvek súladnom systéme Kubernetes 1.33 alebo novšom, vrátane spravovanej služby cloudového poskytovateľa. Nič v charte nie je špecifické pre jedného poskytovateľa. Oproti systému k3s sa mení len niekoľko hodnôt, pričom každá z nich je popísaná vyššie:

  • Ako prvý sa nainštaluje cert-manager v1.21.3, rovnako ako na akomkoľvek inom klastri. | V spravovanom klastri | Čo nastaviť alebo skontrolovať | |---|---| | Úložisko | Uveďte názov triedy poskytovateľa v storage.className alebo označte jednu ako predvolenú. | | Ingress | Nainštalujte ingress kontrolér, ktorý používate, sprístupnite ho na portoch 80 a 443, nastavte ingress.className, ak nie je predvolený, a nastavte networkPolicy.ingressNamespace na jeho menný priestor. | | Skoky proxy servera | Nastavte proxy.trustedCIDRs na sieť podov daného kontroléra. | | Server API | Ak inštalácia nedokáže načítať adresu servera API z klastra, zadajte ju v networkPolicy.apiServerCIDRs. | | Vynucovanie sieťovej politiky | Politiky chartu sa uplatnia iba tam, kde sieťový zásuvný modul klastra vynucuje objekty NetworkPolicy. Zvoľte konfiguráciu klastra, ktorá to robí. | | Obrazy | Uzly musia mať prístup k registry.adverant.ai alebo k vášmu vlastnému registru uvedenému v global.imageRegistry. |

Pred čímkoľvek iným spustite predletovú kontrolu. Načíta klaster a súbor hodnôt spoločne a vypíše každú z týchto položiek ako riadok, pričom pri každej chýbajúcej uvedie aj spôsob opravy. Kapitola 2.5, Predletová kontrola pomocou nexusctl, ukazuje toto hlásenie.

Pred inštaláciou
Pred inštaláciou
Úspešná predletová kontrola na produkčnom klastri. Každý riadok predstavuje jednu požiadavku a každé upozornenie obsahuje na riadku pod sebou návod na opravu.