Přihlásit seDomluvit prezentaci

Kapitola 2.11

Varianty: externí úložiště, TLS a ingress

Hodnoty, které přizpůsobí Nexus clusteru, jenž není prázdný – včetně TLS (Transport Layer Security), databází, které již provozujete, vlastních certifikátů, jiného ingress controlleru, tříd úložiště, pošty, proxy serverů, replik a spravovaného prostředí Kubernetes.

Tato stránka byla přeložena pomocí AI z anglického originálu. Pokud je cokoliv nejasné, směrodatná je anglická stránka. Přečíst tuto stránku v angličtině

17 min čtení

Produkční cluster organizace Harrow Port Authority není prázdný a samotná záležitost s TLS (Transport Layer Security) má tři části. Databázový tým provozuje PostgreSQL na vlastních strojích a chce mít každou databázi tam, zálohovanou vlastním způsobem. Certifikáty pocházejí z interní CA (certifikační autority) organizace Harrow prostřednictvím nástroje cert-manager. Ingress controller není Traefik a běží ve svém vlastním jmenném prostoru. Nic z toho nevyžaduje vytváření forku chartu. Každý rozdíl je jen hodnota a tato kapitola je prochází v pořadí, v jakém se s nimi setkal Tomás Reilly.

Každý blok hodnot v této kapitole je fragment. Sloučte ty, které potřebujete, do svého vlastního souboru hodnot vedle global, hosts, edition a keys z kapitoly 2.6, Instalace edice Community na Kubernetes. Schéma chartu odmítne jakýkoli klíč, který nezná, takže překlep v klíči způsobí selhání helm lint --strict i samotné instalace, místo aby byl ignorován. Je to záměr: překlep v dataTier, který by tiše ponechal úložiště v clusteru, by byl horší než chyba.

Externí datová úložiště

Nexus uchovává svá data v pěti úložištích. Ve výchozím nastavení běží každé z nich uvnitř clusteru z vlastního podepsaného obrazu daného vydání a s vlastním svazkem.

Úložiště Klíč v souboru hodnot Výchozí stav v clusteru Výchozí svazek
PostgreSQL 16 s PostGIS 3 a pgvector 0.8 dataTier.postgres obraz vydání 50Gi
Valkey 8.1 dataTier.valkey obraz vydání 5Gi
Neo4j 5.26 Community Edition dataTier.neo4j obraz vydání 20Gi
Qdrant 1.15 dataTier.qdrant obraz vydání 10Gi
SeaweedFS 4.48, objektové úložiště kompatibilní s Amazon S3 (Simple Storage Service) dataTier.objectStore obraz vydání 50Gi

Kterékoli z nich můžete místo toho provozovat sami. Nastavte jeho mode na external, zadejte jeho hostitele a uveďte název objektu Secret, který obsahuje jeho přístupové údaje. Přidejte adresu úložiště také do networkPolicy.externalEgressCIDRs (viz část o síťové politice níže), protože jmenný prostor zakazuje veškerý ostatní odchozí provoz. Pro externí úložiště chart nevykreslí nic, co k tomuto úložišti patří: žádný StatefulSet, žádnou Service a žádný svazek. Služby se připojují k hostiteli, kterého jste 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 vytváříte vy, a to před instalací ve jmenném prostoru, do kterého se Nexus instaluje. Chart si vždy uchovává pouze jeho název: pody, které potřebují přístupový údaj, jej při spuštění načtou z vašeho objektu Secret a nic se nekopíruje do vlastních objektů Secret chartu. Změňte přístupový údaj a restartujte pody, které jej používají; není třeba nic znovu vykreslovat.

Každé úložiště hledá ve svém objektu Secret pevně dané názvy klíčů:

Úložiště Klíče v jeho objektu Secret
PostgreSQL username a password pro superuživatele na daném serveru a ca.crt, certifikační autorita (CA), která podepsala certifikát serveru
Valkey password
Neo4j username a password
Qdrant api-key
Objektové úložiště access-key a secret-key

Načtěte každou hodnotu ze souboru, aby nezůstala v historii vašeho shellu ani v souboru hodnot:

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žiště bez uvedeného názvu objektu Secret zastaví vykreslování, přesně jako úložiště bez zadaného hostitele.

PostgreSQL

Externí server musí nabízet to, co nabízí obraz vydání: PostgreSQL 16 s PostGIS 3 a pgvector. Provoz k němu je vždy šifrován a kontrolován vůči ca.crt ve vašem objektu Secret. Nastavte sslmode na verify-full, což také kontroluje, zda certifikát serveru uvádí hostitele, kterého jste zadali, nebo na verify-ca. Při použití externího serveru vykreslování odmítne disable a require. Postgres v clusteru funguje opačně: jeho provoz nikdy neopouští jmenný prostor, síťová politika jej drží uvnitř a přijímá pouze disable. Ať už zvolíte kterýkoli režim, certifikát musí uvádět hostitele z external.host, protože některé služby kontrolují název při každém připojení.

Při instalaci se inicializační úloha (bootstrap Job) připojí k serveru pomocí účtu ve vašem objektu Secret a vytvoří role, pod kterými Nexus běží. Vytvoří roli pro migrace, která vlastní schéma, běhovou roli a jednu přihlašovací roli pro každou službu. Nexus vygeneruje jejich hesla a uchová je. Žádná z nich není superuživatel a žádná nemůže obejít zabezpečení na úrovni řádků (row-level security), takže každá politika izolace v databázi platí pro každou službu. Samotná inicializace však superuživatele potřebuje: jeden z jejích kroků uzamkne vestavěnou funkci PostgreSQL a to smí provést pouze superuživatel. Tento účet používá pouze inicializace a vlastní krok zřizování (provisioning) v konzoli. Spravovaná databázová služba, jejíž administrátorská role není skutečným superuživatelem, proto nemůže hostovat databázi systému Nexus.

Úloha Job zkontroluje váš server dříve, než do něj zasáhne. Pokud účet ve vašem objektu Secret není superuživatel, zastaví se, aniž by cokoli změnila. Pokud již existuje role s názvem nexus s atributy SUPERUSER nebo BYPASSRLS, úloha Job se 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. Odeberte tyto atributy z dané role, nebo použijte server, kde je tento název volný, a spusťte instalaci znovu.

Valkey, Neo4j, Qdrant a objektové úložiště

Zbývající čtyři úložiště přijímají stejná tři nastavení: mode, external.host a external.existingSecret. Zde jsou všechna čtyři přepnutá na vlastní úložiště organizace 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 }

Provozujte verze, které obsahují obrazy vydání uvedené v tabulce výše, na portech, které služby používají. Valkey naslouchá na portu 6379 a Neo4j na 7687; Qdrant používá port 6333 a objektové úložiště 8333. Objektové úložiště musí být kompatibilní s S3. Heslo pro Valkey se vkládá do adresy připojení uvnitř každého podu, proto v něm používejte pouze písmena a číslice (znaky -._~ jsou také v pořádku).

Pokud je mode nastaveno na external a external.host je prázdné, vykreslování se zastaví s chybou dataTier.<store>.external.host is required when mode is external. Přesun úložiště z clusteru na externí server poté, co lidé začali Nexus používat, představuje migraci dat, kterou musíte provést sami; chart za vás nic nezkopíruje. Rozhodněte se před první instalací.

Úložiště klíčů, OpenBao, v tomto seznamu není a nemůže být externí. Je součástí identity instalace a při každé instalaci běží v clusteru.

TLS na veřejném okraji sítě

tls.mode rozhoduje o tom, jak tři veřejní hostitelé získají své certifikáty, a o ničem jiném. Provoz mezi službami vždy využívá oboustranné TLS (mTLS) s certifikáty z vlastní lokální CA chartu, vydanými nástrojem cert-manager, bez ohledu na zvolený režim. Nepoužívá se žádný service mesh a istio.enabled zůstává false.

tls.mode Kdo vytváří certifikát Co musíte nastavit
existing (výchozí) Vy. Jeden objekt Secret obsahuje certifikát pro všechny tři hostitele. tls.existingSecret
cert-manager ClusterIssuer, který již provozujete. Chart jej požádá o jeden certifikát pro každého hostitele. tls.clusterIssuer
none Nikdo v clusteru. TLS končí před ním, na vašem load balanceru nebo proxy serveru. Nic, ale přečtěte si varování níže

stávající

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

Každý Ingress poskytuje objekt Secret harrow-public-tls, takže jeho certifikát musí uvádět console.harrow.example, api.harrow.example a auth.harrow.example. Vytvořte jej ve jmenném prostoru před instalací:

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

Předběžná kontrola (preflight) jej načte, upozorní, pokud jeho platnost končí do 30 dnů, a uvede název objektu Secret, pokud chybí. Když je režim nastaven na existing a název je prázdný, vykreslování se 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 přidá anotaci cert-manager.io/cluster-issuer ke každému ze tří objektů Ingress a cert-manager vytvoří objekty Secret nexus-console-tls, nexus-api-tls a nexus-auth-tls. Bez tls.clusterIssuer se vykreslování zastaví s chybou tls.clusterIssuer is required when tls.mode is cert-manager.

Pokud váš vydavatel používá ACME (Automatic Certificate Management Environment) s výzvou HTTP-01, není potřeba nic dalšího. Chart nepřidává žádné vlastní přesměrování, takže požadavek na /.well-known/acme-challenge/ dorazí k řešiteli (solveru) vašeho vydavatele beze změny. V prostředí bez přístupu k internetu je řešitel také obrazem: vložte obraz cert-manager-acmesolver nástroje cert-manager do svého registru, jinak každý pod výzvy zůstane čekat ve stavu ErrImagePull.

žádná

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

Při použití none neobsahují objekty Ingress žádnou sekci TLS. Použijte tuto možnost, když load balancer nebo reverzní proxy před clusterem ukončuje TLS pro všechny tři hostitele.

proxy.trustedCIDRs určuje proxy uzly (hopy), jejichž hlavičce X-Forwarded-For služba nexus-auth důvěřuje. Výchozí hodnota, 10.42.0.0/16, je síť podů v k3s, kde běží jeho ingress controller. V jakémkoli jiném clusteru ji nastavte na síť, kterou používají pody vašeho ingress controlleru, aby limity počtu přihlášení a auditní záznamy viděly adresu uživatele, a nikoli adresu proxy serveru.

Adresa, certifikát, proxy a pošta
Adresa, certifikát, proxy a pošta
Po instalaci mají adresa, certifikát, proxy a pošta na jedné stránce svůj vlastní test a výsledek je vypsán slovy.

Ingress controllery

Chart vytváří tři běžné objekty Kubernetes Ingress, jeden pro každého veřejného hostitele. Každý směruje cestu / na jednu službu (Service).

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

Tři hodnoty určují jejich podobu a jedna hodnota v síťové politice s nimi musí souhlasit.

# 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ázev třídy IngressClass. Pokud zůstane prázdný, chart třídu vynechá a tři objekty Ingress převezme výchozí třída clusteru. Předběžná kontrola (preflight) ověří, zda třída existuje, nebo – pokud jste žádnou neuvedli – zda je přesně jedna třída označena jako výchozí.
  • ingress.annotations se přidá ke všem třem objektům Ingress. Hodnoty jsou řetězce, takže čísla a logické hodnoty (boolean) uzavřete do uvozovek. Použijte toto pole pro vlastní nastavení vašeho controlleru.
  • ingress.enabled: false nevykreslí vůbec žádný Ingress, což je určeno pro prostředí, které směruje provoz na tyto tři služby jiným způsobem.
  • networkPolicy.ingressNamespace je jmenný prostor, ve kterém běží váš ingress controller.

Tato poslední položka lidi často zaskočí. Síťová politika chartu ve výchozím nastavení zakazuje veškerý příchozí provoz do jmenného prostoru a poté povolí ingress controlleru přístup ke třem veřejným službám pouze ze jmenného prostoru, který uvedete. Výchozí hodnota, kube-system, je správná pro k3s, který tam provozuje Traefik. Pokud u jakéhokoli jiného controlleru ponecháte hodnotu beze změny, controller se k systému Nexus nedostane: objekty Ingress sice existují, ale controller zaznamenává vypršení časového limitu připojení a prohlížeč obdrží chybu brány (gateway error). Kontrola „Ingress ports“ v rámci předběžné kontroly (preflight) hledá v daném jmenném prostoru službu (Service) otevřenou na portech 80 a 443 jako LoadBalancer nebo NodePort a její řádek fix uvádí tuto hodnotu.

Vlevo se nachází pole „ingress controller“ uvnitř přerušované hranice označené „namespace: networkPolicy.ingressNamespace (kube-system on k3s)“. Vycházejí z něj tři šipky označené console.harrow.example, api.harrow.example a auth.harrow.example. Překračují plnou čáru označenou „nexus namespace: default deny“ a směřují do tří polí: „nexus-alpha :3000“, „nexus-gateway :9092“ a „nexus-auth :9101“. Čtvrtá, zašedlá šipka z pole „any other namespace“ se zastavuje o plnou čáru s malým křížkem.
Tři veřejní hostitelé, jmenný prostor ingress controlleru a síťová politika, která povoluje přístup pouze tomuto jmennému prostoru.

Zbytek síťové politiky

networkPolicy.enabled má ve výchozím nastavení hodnotu true a mělo by to tak zůstat. S tímto nastavením se nic ve jmenném prostoru nedostane ven kromě DNS (Domain Name System), Kubernetes API (aplikačního programovacího rozhraní) pro ověřovatele tokenů a adres, které uvedete.

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

apiServerCIDRs je adresa API serveru ve formátu /32 CIDR (Classless Inter-Domain Routing). Pokud je pole prázdné, chart ji při instalaci načte z clusteru. Příkaz helm template nemá žádný cluster, ze kterého by mohl číst, takže adresu zadejte tam. externalEgressCIDRs představuje vše ostatní, kam se může úloha (workload) připojit; ve výchozím nastavení je prázdné. Organizace Harrow zde uvádí svůj poštovní relay server. Každé externí datové úložiště mimo jmenný prostor zde musí být rovněž uvedeno, jinak politika výchozího zákazu zabrání službám v přístupu k němu.

S API serverem komunikují pouze tři úlohy (workloads): služba pro důkazy nexus-probitas, orchestrátor a úloha úschovy (custody Job) úložiště klíčů. Kontrolují tokeny servisních účtů, které předkládají ostatní úlohy. Politika zpřístupňuje adresu API serveru na portech 6443 a 443 těmto třem úlohám a ničemu jinému. Pokud se k němu tyto tři úlohy nedostanou, nemohou zkontrolovat tokeny předkládané ostatními úlohami, proto zadejte každou adresu, kterou může mít.

Výběr režimu TLS

Organizace Harrow zvolila cert-manager se svou interní CA jako ClusterIssuer a důvodem byla obnova certifikátů. Při použití existing musí člověk obnovit certifikát v objektu Secret před koncem jeho platnosti a jediným připomenutím je 30denní varování předběžné kontroly. S cert-manager probíhá obnova sama a nikdo na ni nemusí myslet. Možnost none vyhovuje prostředí, kde každá veřejná adresa již leží za load balancerem, který ukončuje TLS pro mnoho systémů, a kde certifikáty spravuje příslušný tým. Ať už zvolíte cokoli, certifikát, který vidí prohlížeč, musí být takový, kterému prohlížeč důvěřuje. Certifikát podepsaný svým držitelem (self-signed), přes jehož varování se uživatelé proklikají, znefunkční přístupové klíče (passkeys), protože Chrome za varováním o certifikátu přístupový klíč nevytvoří ani nepoužije.

Úložiště, pošta, repliky a prostředky

Třída úložiště

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

storage.className se použije pro každý PVC (persistent volume claim) datové vrstvy a pro svazky úložiště klíčů. Prázdná hodnota znamená výchozí třídu clusteru; předběžná kontrola selže, pokud žádná třída není označena jako výchozí a vy jste žádnou neuvedli. Každé úložiště v clusteru má své vlastní size. Pro úložiště klíčů jsou to keys.openbao.storage.unsealer a keys.openbao.storage.keystore, přičemž keys.receiptsStorage slouží pro potvrzení (receipts). Zvolte velikosti s ohledem na roční růst.

Pošta

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

Nexus odesílá pozvánky a oznámení prostřednictvím vašeho poštovního serveru. smtp.existingSecret určuje název objektu Secret, který vytvoříte ve jmenném prostoru s údaji poštovního serveru. Stejně jako u každé integrace přijímá chart název objektu Secret a nikdy samotný přístupový údaj. Pamatujte na síťovou politiku: přidejte adresu relay serveru do networkPolicy.externalEgressCIDRs, jinak se pošta zastaví na hranici jmenného prostoru. Dokud pošta nefunguje, nelze odesílat pozvánky, na což upozorňuje i kontrolní seznam prvního administrátora.

Repliky a prostředky

Každá základní komponenta má počet replik a prostředky Kubernetes pod components a každé úložiště v clusteru má prostředky pod 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 } }

Výchozí pod Neo4j požaduje 2 GiB a může využít až 4 GiB. Při 3 GB haldy (heap) a mezipaměti stránek (page cache) zvyšte také jeho požadavek (request), aby byl pod umístěn na uzel, který má dostatek paměti.

Komponenty s replicas a resources jsou console, bff, auth, orchestrator, workflows, gateway, graphrag, probitas a skillsEngine. Služba klíčů, keys, přijímá pouze resources. Tyto základní komponenty jsou povinné a nelze je vypnout; chart je spustí bez ohledu na to, co říká jejich přepínač enabled. Úložiště datové vrstvy běží každé v jedné replice.

Na pomalém úložišti poskytují službám čas na spuštění další dvě hodnoty: probes.startupFailureThreshold (ve výchozím nastavení 60) a schemaWait.timeoutSeconds (1800), což je doba, po kterou služba čeká na své databázové migrace, než její spouštěcí kontejner selže s uvedením příčiny.

Přihlašovací relace, limity požadavků a privátní hostitelé modelů

Tři menší skupiny hodnot stojí za to znát před instalací, protože si jich lidé všimnou hned první den.

# 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í, jak dlouho platí dva tokeny relace. Výchozí hodnoty, 15 minut a 12 hodin, znamenají, že člověk, který večer zavře notebook, se ráno musí znovu přihlásit. Zkraťte platnost obnovovacího (refresh) tokenu, pokud to vaše bezpečnostní politika vyžaduje, a počítejte s častějším přihlašováním.

auth.rateLimitPerMinute je maximální počet požadavků, které může jeden přihlášený uživatel vznést na přihlašovací službu za minutu, než služba odpoví kódem 429. Výchozí hodnota 5000 představuje přibližně 83 požadavků za sekundu z jednoho účtu, což je dostatečné pro konzoli i pro skripty. Instalace nemá žádné plány předplatného, takže pro každého uživatele platí stejný limit. Snižte jej pro zpřísnění ochrany proti zneužití, nebo jej zvyšte pro náročnou automatizaci. Ochrana proti útokům hrubou silou při přihlašování, jako je uzamčení účtu a limity pokusů o druhé ověření, je samostatná a zde se nenastavuje.

ai.installationHosts uvádí další názvy hostitelů uvnitř instalace pro vlastní servery modelů AI (umělé inteligence) organizace na privátních názvech. Každá položka je název hostitele, výraz .suffix, který odpovídá každému názvu pod ním, IP adresa nebo blok IPv4 CIDR (Classless Inter-Domain Routing). Směrovač (router) je považuje za součást instalace vedle vlastních hostitelů vydání. Samotný server modelu je uveden v ai.localProvider.baseUrl; kapitola 2.14, Poskytovatelé a modely AI, se věnuje obojímu.

Co nikdy není hodnotou

Některé věci, které lidé v souboru hodnot hledají, tam záměrně nejsou.

Není v souboru hodnot Proč a kde se nachází místo toho
Licence Importuje se po instalaci, v konzoli nebo pomocí nexusctl licence import <file>. Licence není nikdy hodnotou chartu ani připojeným souborem. Podrobnosti obsahuje kapitola 2.13, Licence.
Klíče modelů Každá organizace si uchovává své vlastní klíče ve svém vlastním fondu (poolu), zadané v konzoli. Žádný přístupový údaj poskytovatele AI není nikdy hodnotou chartu.
Zabezpečení registrace Internetová CAPTCHA i síťová kontrola při registraci jsou v instalaci vypnuté a neexistuje žádná hodnota, kterou by bylo možné některou z nich zapnout. CAPTCHA by vyžadovala přístup k internetu při každé registraci. Síťová kontrola by vyžadovala licencovanou geolokační databázi, kterou chart neobsahuje. Registrace neznámého uživatele je místo toho pozdržena a čeká na schválení administrátorem, jak vysvětluje kapitola 2.12, První spuštění.
Telemetrie Schéma přijímá pro telemetry.enabled jediné nastavení, kterým je false. Instalaci nic neopouští a vlastní hlášení datové vrstvy (hlášení o využití v Neo4j, telemetrie v Qdrant) je rovněž vypnuto.

Kontrola celého souboru před instalací

Když máte fragmenty sloučené do jednoho souboru, spusťte nad ním ze své pracovní stanice dvě kontroly. Příkaz helm lint --strict ověří každý klíč vůči schématu chartu a helm template vykreslí celé vydání, abyste si jej mohli přečíst dříve, než se cokoli vytvoří. Příkazy používají adresu chartu edice Community; pro edici Enterprise zadejte místo toho cestu ke staženému chartu Enterprise (kapitola 2.7, Instalace edice Enterprise a použití licence). Vykreslování na vaší pracovní stanici nemůže načíst adresu API serveru z clusteru, proto v souboru nejprve nastavte networkPolicy.apiServerCIDRs.

Tyto dvě 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

Překlep v klíči způsobí selhání kontroly lint s hlášením „additional properties“ a uvede název klíče. Chybějící povinná hodnota, například hostitel u externího úložiště, způsobí selhání vykreslování s větou citovanou v této kapitole. Příkaz helm template nemá žádný cluster, ze kterého by mohl číst, takže při offline vykreslování zadejte networkPolicy.apiServerCIDRs, jinak se zastaví a vyžádá si je.

Poté spusťte předběžnou kontrolu (preflight) se stejným souborem. Předběžná kontrola je jediná kontrola, která čte cluster a hodnoty společně: právě zde se předtím, než na instalaci začne kdokoli záviset, odhalí špatný jmenný prostor pro ingress, chybějící třída úložiště nebo certifikát, kterému příští týden končí platnost.

Spravované prostředí Kubernetes

Nexus běží na jakémkoli kompatibilním Kubernetes 1.33 nebo novějším, včetně spravovaných služeb cloudových poskytovatelů. Nic v chartu není specifické pro jednoho poskytovatele. Oproti k3s se mění jen hrstka hodnot, přičemž každá z nich byla popsána výše:

  • Jako na každém clusteru se nejprve nainstaluje cert-manager v1.21.3. | Na spravovaném clusteru | Co nastavit nebo zkontrolovat | |---|---| | Úložiště | Uveďte třídu poskytovatele v storage.className, nebo označte jednu jako výchozí. | | Ingress | Nainstalujte ingress controller, který používáte, vystavte jej na portech 80 a 443, nastavte ingress.className, pokud není výchozí, a nastavte networkPolicy.ingressNamespace na jeho jmenný prostor. | | Proxy uzly (hopy) | Nastavte proxy.trustedCIDRs na síť podů daného controlleru. | | API server | Pokud instalace nemůže načíst adresu API serveru z clusteru, zadejte ji v networkPolicy.apiServerCIDRs. | | Vynucování síťové politiky | Politiky chartu se uplatní pouze tam, kde síťový plugin clusteru vynucuje objekty NetworkPolicy. Zvolte konfiguraci clusteru, která to dělá. | | Obrazy | Uzly musí mít přístup k registry.adverant.ai, nebo k vašemu vlastnímu registru uvedenému v global.imageRegistry. |

Před čímkoli jiným spusťte předběžnou kontrolu (preflight). Načte cluster a soubor hodnot společně a vypíše každou z těchto položek jako řádek, s postupem opravy vedle každé, která nevyhovuje. Kapitola 2.5, Předběžná kontrola pomocí nexusctl, ukazuje toto hlášení.

Před instalací
Před instalací
Úspěšná předběžná kontrola na produkčním clusteru. Každý řádek představuje jeden požadavek a každé varování nese na řádku níže postup své opravy.