PrijavaRezervirajte predstavitev

Poglavje 2.11

Različice: zunanje shrambe, TLS in ingress

Vrednosti, ki prilagodijo Nexus gruči, ki ni prazna, vključno z varnostjo transportne plasti TLS (Transport Layer Security), skupaj s podatkovnimi zbirkami, ki jih že poganjate, lastnimi potrdili, drugim krmilnikom ingress, razredi shranjevanja, e-pošto, posredniškimi strežniki, replikami in upravljanim okoljem Kubernetes.

To stran je iz angleškega izvirnika prevedla UI. Če je karkoli nejasno, je referenca angleška stran. Preberite to stran v angleščini

17 min branja

Produkcijski gručni sistem pri Harrow Port Authority ni prazen, že sama zgodba o protokolu TLS (Transport Layer Security) pa ima tri dele. Ekipa za podatkovne baze poganja PostgreSQL na lastnih strežnikih in želi imeti vse podatkovne baze tam, varnostno kopirane na njihov način. Digitalna potrdila prihajajo od internega overitelja (CA – certificate authority) pri Harrowu prek orodja cert-manager. Vhodni krmilnik (ingress controller) ni Traefik in se nahaja v svojem imenskem prostoru. Nič od tega ne zahteva razcepitve (forka) karte (chart). Vsaka razlika je le vrednost in to poglavje jih obravnava v vrstnem redu, kot je nanje naletel Tomás Reilly.

Vsak blok vrednosti v tem poglavju je izsek. Tiste, ki jih potrebujete, združite v lastno datoteko vrednosti, poleg global, hosts, edition in keys iz poglavja 2.6, Nameščanje izdaje Community v okolju Kubernetes. Shema karte zavrne vsak ključ, ki ga ne pozna, zato napačno črkovan ključ povzroči neuspeh pri helm lint --strict in namestitvi, namesto da bi bil prezrt. To je namerno: zatipk pri dataTier, ki bi tiho pustil shrambo v gruči, bi bil hujši kot napaka.

Zunanje shrambe podatkov

Nexus hrani svoje podatke v petih shrambah. Privzeto se vsaka izvaja znotraj gruče iz lastne podpisane slike izdaje in z lastnim nosilcem (volume).

Shramba Ključ vrednosti Privzeto v gruči Privzeti nosilec podatkov
PostgreSQL 16 s PostGIS 3 in pgvector 0.8 dataTier.postgres slika izdaje 50Gi
Valkey 8.1 dataTier.valkey slika izdaje 5Gi
Neo4j 5.26 Community Edition dataTier.neo4j slika izdaje 20Gi
Qdrant 1.15 dataTier.qdrant slika izdaje 10Gi
SeaweedFS 4.48, predmetna shramba, združljiva s storitvijo Amazon S3 (Simple Storage Service) dataTier.objectStore slika izdaje 50Gi

Katero koli izmed njih lahko namesto tega upravljate sami. Nastavite njen mode na external, navedite gostitelja in poimenujte skrivnost (Secret), ki hrani njene poverilnice. Naslov shrambe dodajte tudi v networkPolicy.externalEgressCIDRs (glejte razdelek o omrežnem pravilniku spodaj), saj imenski prostor zavrača ves preostali izhodni promet (egress). Za zunanjo shrambo karta ne izriše ničesar za to shrambo: nobenega StatefulSeta, nobene storitve (Service) in nobenega nosilca. Storitve se povežejo z gostiteljem, ki ste ga navedli.

# 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

Skrivnost (Secret) ustvarite vi pred namestitvijo v imenskem prostoru, v katerega se namesti Nexus. Karta hrani le njeno ime: podi, ki potrebujejo poverilnico, jo ob zagonu preberejo iz vaše skrivnosti in nič se ne kopira v lastne skrivnosti karte. Če spremenite poverilnico, znova zaženite pode, ki jo uporabljajo; ničesar ni treba znova izrisati (render).

Vsaka shramba v svoji skrivnosti išče fiksna imena ključev:

Shramba Ključi v njeni skrivnosti
PostgreSQL username in password za superuporabnika na tem strežniku ter ca.crt, overitelja digitalnih potrdil (CA), ki je podpisal potrdilo strežnika
Valkey password
Neo4j username in password
Qdrant api-key
Predmetna shramba access-key in secret-key

Vsako vrednost naložite iz datoteke, da ne ostane v zgodovini vaše lupine in zunaj vaše datoteke vrednosti:

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

Zunanja shramba brez imenovane skrivnosti ustavi izris (render) natanko tako kot tista brez gostitelja.

PostgreSQL

Zunanji strežnik mora ponujati tisto, kar ponuja slika izdaje: PostgreSQL 16 z razširitvama PostGIS 3 in pgvector. Promet do njega je vedno šifriran in preverjen glede na ca.crt v vaši skrivnosti. Nastavite sslmode na verify-full, kar prav tako preveri, ali potrdilo strežnika navaja ime gostitelja, ki ste ga podali, ali na verify-ca. Pri zunanjem strežniku izris zavrne disable in require. Postgres znotraj gruče deluje obratno: njegov promet nikoli ne zapusti imenskega prostora, omrežni pravilnik ga zadrži tam in sprejme samo disable. Ne glede na to, kateri način izberete, mora potrdilo vsebovati ime gostitelja v external.host, saj nekatere storitve preverijo ime ob vsaki povezavi.

Ob namestitvi se zagonsko opravilo (bootstrap Job) poveže s strežnikom z računom iz vaše skrivnosti in ustvari vloge, pod katerimi teče Nexus. Ustvari vlogo migratorja, ki je lastnik sheme, izvajalno vlogo ter po eno prijavno vlogo za vsako storitev. Nexus ustvari njihova gesla in jih hrani. Nobena izmed njih ni superuporabnik in nobena ne more zaobiti varnosti na ravni vrstic (row-level security), zato vsak pravilnik o izolaciji v podatkovni bazi velja za vsako storitev. Sam zagonski postopek pa potrebuje superuporabnika: eden od njegovih korakov zaklene vgrajeno funkcijo PostgreSQL, to pa lahko stori le superuporabnik. Ta račun uporabljata samo zagonski postopek in lastni korak konzole za pripravo okolja (provisioning). Upravljana storitev podatkovne baze, katere skrbniška vloga ni pravi superuporabnik, zaradi tega ne more gostiti podatkovne baze Nexus.

Opravilo (Job) preveri vaš strežnik, preden se ga dotakne. Ustavi se, ne da bi kar koli spremenilo, če račun v vaši skrivnosti ni superuporabnik. Če vloga z imenom nexus že obstaja z SUPERUSER ali BYPASSRLS, se opravilo ustavi s sporočilom 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. Odstranite te atribute iz te vloge ali uporabite strežnik, kjer je ime prosto, in znova zaženite namestitev.

Valkey, Neo4j, Qdrant in predmetna shramba

Ostale štiri sprejmejo iste tri nastavitve: mode, external.host in external.existingSecret. Tukaj so vse štiri preklopljene na lastne strežnike pri Harrowu:

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

Uporabite različice, ki jih vsebujejo slike izdaje, navedene v zgornji tabeli, na vratih, ki jih uporabljajo storitve. Valkey posluša na 6379 in Neo4j na 7687; Qdrant uporablja 6333, predmetna shramba pa 8333. Predmetna shramba mora biti združljiva s S3. Geslo za Valkey je vključeno v naslov za povezavo znotraj vsakega poda, zato uporabite le črke in številke (tudi znaki -._~ so dovoljeni).

Če je mode nastavljen na external in je external.host prazen, se izris ustavi z dataTier.<store>.external.host is required when mode is external. Premik shrambe iz gruče na zunanji strežnik po tem, ko so ljudje že uporabljali Nexus, pomeni selitev podatkov, ki jo morate opraviti sami, saj karta ne bo kopirala ničesar namesto vas. Odločite se pred prvo namestitvijo.

Shramba ključev, OpenBao, ni na tem seznamu in ne more biti zunanja. Je del identitete namestitve in se pri vsaki namestitvi izvaja v gruči.

TLS na javnem robu omrežja

tls.mode določa le, kako trije javni gostitelji pridobijo svoja digitalna potrdila, in nič več. Promet med storitvami vedno uporablja obojestranski TLS (mutual TLS) s potrdili lastnega lokalnega overitelja (CA) karte, ki jih izda cert-manager, ne glede na način. Storitvene mreže (service mesh) ni in istio.enabled ostane false.

tls.mode Kdo ustvari digitalno potrdilo Kaj morate nastaviti
existing (privzeto) Vi. Ena skrivnost (Secret) hrani digitalno potrdilo za vse tri gostitelje. tls.existingSecret
cert-manager ClusterIssuer, ki ga že poganjate. Karta ga zaprosi za eno digitalno potrdilo na gostitelja. tls.clusterIssuer
none Nihče v gruči. TLS se zaključi pred njo, na vašem izravnalniku obremenitve (load balancer) ali posredniškem strežniku (proxy). Nič, vendar preberite spodnje opozorilo

existing

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

Vsak Ingress uporablja skrivnost harrow-public-tls, zato mora njeno potrdilo vsebovati imena console.harrow.example, api.harrow.example in auth.harrow.example. Ustvarite jo v imenskem prostoru pred namestitvijo:

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

Predhodno preverjanje (preflight) jo prebere, opozori, če poteče v 30 dneh, in navede ime skrivnosti, če ta manjka. Ko je način existing in je ime prazno, se izris ustavi z 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

Karta doda anotacijo cert-manager.io/cluster-issuer vsakemu od treh Ingressov, cert-manager pa ustvari skrivnosti nexus-console-tls, nexus-api-tls in nexus-auth-tls. Brez tls.clusterIssuer se izris ustavi z tls.clusterIssuer is required when tls.mode is cert-manager.

Če vaš izdajatelj uporablja protokol ACME (Automatic Certificate Management Environment) z izzivom HTTP-01, ni potrebno nič drugega. Karta ne dodaja lastnih preusmeritev, zato zahteva za /.well-known/acme-challenge/ nespremenjena doseže razreševalnik (solver) vašega izdajatelja. Na lokaciji brez interneta je tudi razreševalnik slika: v svoj register vstavite sliko cert-manager-acmesolver orodja cert-manager, sicer bo vsak pod za izziv čakal v stanju ErrImagePull.

brez

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

Pri nastavitvi none Ingressi nimajo razdelka TLS. Uporabite jo, ko izravnalnik obremenitve ali obratni posredniški strežnik (reverse proxy) pred gručo zaključuje TLS za vse tri gostitelje.

proxy.trustedCIDRs navaja skoke posredniškega strežnika (proxy hops), katerih glavi X-Forwarded-For storitev nexus-auth zaupa. Privzeta vrednost, 10.42.0.0/16, je omrežje podov sistema k3s, kjer teče njegov vhodni krmilnik. V kateri koli drugi gruči jo nastavite na omrežje, ki ga uporabljajo podi vašega vhodnega krmilnika, tako da omejitve pogostosti prijav in revizijski zapisi zaznajo naslov osebe in ne naslova posredniškega strežnika.

Naslov, potrdilo, posredniški strežnik in pošta
Naslov, potrdilo, posredniški strežnik in pošta
Po namestitvi imajo naslov, potrdilo, posredniški strežnik in pošta vsak svoj preizkus na eni strani, rezultat pa je izpisan z besedami.

Krmilniki ingress

Karta ustvari tri navadne Kubernetes Ingresse, po enega za vsakega javnega gostitelja. Vsak usmerja pot / k eni storitvi (Service).

Ingress Gostitelj Storitev in vrata
nexus-console hosts.console nexus-alpha, 3000
nexus-api hosts.api nexus-gateway, 9092
nexus-auth hosts.auth nexus-auth, 9101

Tri vrednosti jih oblikujejo, ena vrednost v omrežnem pravilniku pa se mora z njimi ujemati.

# harrow-ingress.yaml (Helm values)
ingress:
  enabled: true
  className: harrow-nginx
  annotations:
    "<annotation-key>": "<annotation-value>"
networkPolicy:
  ingressNamespace: ingress-harrow
  • ingress.className poimenuje IngressClass. Če ostane prazno, karta razred izpusti in privzeti razred gruče prevzame vse tri Ingresse. Predhodno preverjanje (preflight) preveri, ali razred obstaja, oziroma, če niste navedli nobenega, ali je natanko en razred označen kot privzeti.
  • ingress.annotations se doda vsem trem Ingressom. Vrednosti so nizi, zato številke in logične vrednosti (booleans) navedite v narekovajih. Uporabite to za lastne nastavitve vašega krmilnika.
  • ingress.enabled: false ne izriše nobenega Ingressa, kar je namenjeno lokacijam, ki promet do treh storitev usmerjajo na drug način.
  • networkPolicy.ingressNamespace je imenski prostor, v katerem teče vaš vhodni krmilnik.

Ta zadnja nastavitev ljudi pogosto preseneti. Omrežni pravilnik karte privzeto zavrača ves promet v imenski prostor in nato vhodnemu krmilniku dovoli dostop do treh javnih storitev samo iz imenskega prostora, ki ga navedete. Privzeta vrednost, kube-system, je pravilna za k3s, ki tam poganja Traefik. Če pri katerem koli drugem krmilniku to pustite nespremenjeno, krmilnik ne bo mogel doseči Nexusa: Ingressi obstajajo, krmilnik beleži časovne omejitve povezav, brskalnik pa prejme napako prehoda (gateway error). Preizkus »Ingress ports« pri predhodnem preverjanju v tem imenskem prostoru išče storitev (Service), odprto na vratih 80 in 443, kot LoadBalancer ali NodePort, njegova vrstica fix pa navaja to vrednost.

Na levi strani je okvir »ingress controller« znotraj črtkane meje z oznako »namespace: networkPolicy.ingressNamespace (kube-system on k3s)«. Iz njega vodijo tri puščice z oznakami console.harrow.example, api.harrow.example in auth.harrow.example. Prečkajo polno črto z oznako »nexus namespace: default deny« in pripeljejo do treh okvirjev: »nexus-alpha :3000«, »nexus-gateway :9092« in »nexus-auth :9101«. Četrta, siva puščica iz okvirja »any other namespace« se ustavi pri polni črti z majhnim križcem.
Trije javni gostitelji, imenski prostor vhodnega krmilnika in omrežni pravilnik, ki dovoljuje dostop samo temu imenskemu prostoru.

Preostanek omrežnega pravilnika

networkPolicy.enabled je privzeto nastavljen na true in tako naj tudi ostane. S tem nič v imenskem prostoru ne more doseči zunanjega sveta, razen sistema DNS (Domain Name System), vmesnika Kubernetes API (application programming interface) za pregledovalnike žetonov in naslovov, ki jih navedete.

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

apiServerCIDRs je naslov strežnika API v obliki /32 CIDR-jev (Classless Inter-Domain Routing). Če je prazno, ga karta ob namestitvi prebere iz gruče. helm template nima gruče, iz katere bi lahko bral, zato ga navedite tam. externalEgressCIDRs predstavlja vse ostalo, kar lahko delovna obremenitev doseže, in je privzeto prazno. Harrow tu navaja svoj poštni posredovalnik (mail relay). Tudi vsaka zunanja podatkovna shramba zunaj imenskega prostora mora biti navedena tukaj, sicer pravilnik o privzeti zavrnitvi storitvam prepreči dostop do nje.

S strežnikom API komunicirajo le tri delovne obremenitve: storitev za dokaze nexus-probitas, orkestrator in opravilo skrbništva (custody Job) shrambe ključev. Preverjajo žetone storitvenih računov, ki jih predložijo druge delovne obremenitve. Pravilnik dodeli naslov strežnika API na vratih 6443 in 443 samo tem trem in ničemur drugemu. Če ga te tri ne morejo doseči, ne morejo preveriti žetonov, ki jih predložijo druge delovne obremenitve, zato navedite vse naslove, ki jih strežnik API lahko ima.

Izbira načina TLS

Harrow je izbral cert-manager s svojim internim overiteljem (CA) kot ClusterIssuerjem, razlog pa je bilo podaljševanje veljavnosti. Pri existing mora oseba sama obnoviti potrdilo v skrivnosti, preden poteče, pri čemer je 30-dnevno opozorilo predhodnega preverjanja edini opomnik. Pri cert-manager se podaljšanje izvede samodejno in nikomur ni treba misliti na to. none ustreza lokaciji, kjer je vsak javni naslov že za izravnalnikom obremenitve, ki zaključuje TLS za številne sisteme, in kjer za potrdila skrbi tamkajšnja ekipa. Ne glede na vašo izbiro mora biti potrdilo, ki ga vidi brskalnik, takšno, ki mu brskalnik zaupa. Samopodpisano potrdilo, pri katerem uporabniki kliknejo mimo opozorila, onemogoči potrdila brez gesla (passkeys), saj Chrome za opozorilom o potrdilu ne bo ustvaril ali uporabil potrdila brez gesla.

Shranjevanje, e-pošta ter replike in viri

Razred shranjevanja (Storage class)

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

storage.className velja za vsak PVC (persistent volume claim – zahtevek za trajni nosilec) podatkovne ravni in za nosilce shrambe ključev. Prazna vrednost pomeni privzeti razred gruče; predhodno preverjanje ne uspe, če noben razred ni označen kot privzeti in niste navedli nobenega. Vsaka shramba v gruči ima svoj size. Pri shrambi ključev sta to keys.openbao.storage.unsealer in keys.openbao.storage.keystore, ter keys.receiptsStorage za potrdila o prejemu (receipts). Izberite velikosti, ki bodo zadostovale za enoletno rast.

Pošta

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

Nexus pošilja vabila in obvestila prek vašega poštnega strežnika. smtp.existingSecret poimenuje skrivnost, ki jo ustvarite v imenskem prostoru in vsebuje podatke o poštnem strežniku. Kot pri vsaki integraciji karta sprejme le ime skrivnosti in nikoli same poverilnice. Ne pozabite na omrežni pravilnik: dodajte naslov posredovalnika v networkPolicy.externalEgressCIDRs, sicer se pošta ustavi na robu imenskega prostora. Dokler pošta ne deluje, vabil ni mogoče pošiljati, na kar opozarja tudi kontrolni seznam prvega skrbnika.

Replike in viri

Vsaka jedrna komponenta ima število replik in vire Kubernetes pod components, vsaka shramba v gruči pa ima vire 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 } }

Privzeti pod Neo4j zahteva 2 GiB in lahko porabi do 4 GiB. Pri 3 GB kopice (heap) in predpomnilnika strani (page cache) povečajte tudi njegovo zahtevo, da bo pod umeščen na vozlišče, ki ima dovolj pomnilnika.

Komponente z replicas in resources so console, bff, auth, orchestrator, workflows, gateway, graphrag, probitas in skillsEngine. Storitev za ključe, keys, sprejme samo resources. Te jedrne komponente so obvezne in jih ni mogoče izklopiti; karta jih zažene ne glede na to, kaj določa njihovo stikalo enabled. Shrambe podatkovne ravni izvajajo vsaka po eno repliko.

Na počasni shrambi dve dodatni vrednosti storitvam zagotovita čas za zagon: probes.startupFailureThreshold (privzeto 60) in schemaWait.timeoutSeconds (1800), kar določa, kako dolgo storitev čaka na migracije svoje podatkovne baze, preden njen zagonski vsebnik (container) javi napako.

Prijavne seje, omejitve hitrosti in zasebni gostitelji modelov

Pred namestitvijo je dobro poznati še tri manjše skupine vrednosti, saj jih uporabniki opazijo že prvi dan.

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

auth.accessTokenTTL in auth.refreshTokenTTL določata, kako dolgo trajata oba žetona seje. Privzeti vrednosti, 15 minut in 12 ur, pomenita, da se mora oseba, ki zvečer zapre prenosnik, zjutraj znova prijaviti. Skrajšajte žeton za osvežitev (refresh token), če to zahteva vaš pravilnik, in pričakujte več prijav.

auth.rateLimitPerMinute je največje število zahtev, ki jih lahko ena prijavljena oseba v eni minuti pošlje prijavni storitvi, preden ta odgovori s kodo 429. Privzeta vrednost 5000 pomeni približno 83 zahtev na sekundo iz enega računa, kar je povsem dovolj za konzolo in skripte. Namestitev nima naročniških paketov, zato za vsako osebo velja enaka omejitev. Znižajte jo za strožjo zaščito pred zlorabami ali pa jo zvišajte za obsežno avtomatizacijo. Zaščita pred napadi z grobo silo (brute-force) pri prijavi, kot sta zaklepanje računa in omejitve poskusov drugega preverjanja, je ločena in se ne nastavlja tukaj.

ai.installationHosts navaja dodatna imena gostiteljev znotraj namestitve za lastne strežnike modelov UI (umetne inteligence) organizacije na zasebnih imenih. Vsak vnos je ime gostitelja, .suffix, ki se ujema z vsakim imenom pod njim, naslov IP ali blok IPv4 CIDR (Classless Inter-Domain Routing). Usmerjevalnik jih obravnava kot del namestitve poleg lastnih gostiteljev izdaje. Sam strežnik modela je imenovan v ai.localProvider.baseUrl; poglavje 2.14, Ponudniki in modeli UI, obravnava oboje.

Kaj nikoli ni nastavljiva vrednost

Nekaterih stvari, ki jih ljudje iščejo v datoteki vrednosti, tam zanalašč ni.

Ni v datoteki vrednosti Zakaj in kje se nahaja namesto tega
Licenca Uvozi se po namestitvi, v konzoli ali z nexusctl licence import <file>. Licenca ni nikoli vrednost karte ali pripeta datoteka. Podrobnosti so v poglavju 2.13, Licence.
Ključi modelov Vsaka organizacija hrani svoje ključe v lastnem naboru, vnesenem v konzoli. Nobena poverilnica ponudnika UI ni nikoli vrednost karte.
Utrjevanje registracije Tako internetna CAPTCHA kot omrežni filter ob registraciji sta pri namestitvi izklopljena in ni vrednosti, s katero bi lahko katerega koli vklopili. CAPTCHA bi ob vsaki registraciji potrebovala internet. Omrežni filter bi potreboval licencirano geolokacijsko podatkovno bazo, ki pa je karta ne vsebuje. Namesto tega registracija neznanca počaka na odobritev skrbnika, kot pojasnjuje poglavje 2.12, Prvi zagon.
Telemetrija Shema sprejme eno nastavitev za telemetry.enabled, in sicer false. Nič ne zapusti namestitve, izklopljeno pa je tudi lastno poročanje podatkovne ravni (poročilo o uporabi Neo4j, telemetrija Qdrant).

Preverite celotno datoteko pred namestitvijo

Ko so izseki združeni v eno datoteko, na svoji delovni postaji zaženite dve preverjanji. helm lint --strict preveri vsak ključ glede na shemo karte, helm template pa izriše celotno izdajo, da jo lahko preberete, preden se kar koli ustvari. Ukaza uporabljata naslov karte Community; za izdajo Enterprise namesto tega navedite pot do karte Enterprise, ki ste jo prenesli (poglavje 2.7, Nameščanje izdaje Enterprise in uveljavljanje licence). Izris na vaši delovni postaji ne more prebrati naslova strežnika API iz gruče, zato v datoteki najprej nastavite networkPolicy.apiServerCIDRs.

Dve preverjanji:

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

Napačno črkovan ključ ne prestane preverjanja (lint) z napako »additional properties« in izpiše ime ključa. Manjkajoča obvezna vrednost, na primer gostitelj pri zunanji shrambi, ustavi izris s stavkom, navedenim v tem poglavju. helm template nima gruče za branje, zato pri izrisu brez povezave navedite networkPolicy.apiServerCIDRs, sicer se ustavi in jih zahteva.

Nato z isto datoteko zaženite predhodno preverjanje (preflight). Predhodno preverjanje je edini preizkus, ki hkrati bere gručo in vrednosti: tam se pokažejo napačen imenski prostor za ingress, manjkajoči razred shrambe ali potrdilo, ki poteče naslednji teden, še preden je kdor koli odvisen od namestitve.

Upravljani Kubernetes

Nexus teče na katerem koli skladnem okolju Kubernetes 1.33 ali novejšem, vključno z upravljanimi storitvami ponudnikov oblaka. Nič v karti ni specifično za posameznega ponudnika. Kar se spremeni v primerjavi z okoljem k3s, je le peščica vrednosti, od katerih je vsaka opisana zgoraj:

  • Najprej se namesti cert-manager v1.21.3, kot na vsaki gruči. | Na upravljani gruči | Kaj nastaviti ali preveriti | |---|---| | Shramba | V storage.className navedite razred ponudnika ali enega označite kot privzetega. | | Ingress | Namestite vhodni krmilnik, ki ga uporabljate, ga izpostavite na vratih 80 in 443, nastavite ingress.className, če ni privzeti, in nastavite networkPolicy.ingressNamespace na njegov imenski prostor. | | Skoki posredniškega strežnika | Nastavite proxy.trustedCIDRs na omrežje podov tega krmilnika. | | Strežnik API | Če namestitev ne more prebrati naslova strežnika API iz gruče, ga navedite v networkPolicy.apiServerCIDRs. | | Uveljavljanje omrežnega pravilnika | Pravilniki karte učinkujejo le tam, kjer omrežni vtičnik gruče uveljavlja NetworkPolicy. Izberite konfiguracijo gruče, ki to podpira. | | Slike | Vozlišča morajo doseči registry.adverant.ai ali vaš lastni register, imenovan v global.imageRegistry. |

Pred vsem drugim zaženite predhodno preverjanje (preflight). Hkrati prebere gručo in datoteko vrednosti ter vsako od teh zahtev izpiše v vrstici, skupaj z rešitvijo poleg vsake, ki ne uspe. Poglavje 2.5, Predhodno preverjanje z orodjem nexusctl, prikazuje poročilo.

Pred namestitvijo
Pred namestitvijo
Uspešno predhodno preverjanje na produkcijski gruči. Vsaka vrstica predstavlja eno zahtevo, vsako opozorilo pa v spodnji vrstici vsebuje rešitev.