BejelentkezésBemutató kérése

2.11. fejezet

Variációk: külső adattárak, TLS és ingress

Azok az értékek, amelyekkel a Nexus egy nem üres klaszterhez igazítható, beleértve a TLS-t (Transport Layer Security), valamint a már futó adatbázisokat, a saját tanúsítványokat, egy másik ingress vezérlőt, a tárolási osztályokat (storage class), a levelezést, a proxykat, a replikákat és a menedzselt Kubernetest.

Ezt az oldalt AI fordította az eredeti angol szövegből. Ha bármi nem egyértelmű, az angol nyelvű oldal az irányadó. Oldal olvasása angolul

17 perc olvasási idő

A Harrow Port Authority éles fürtje nem egy üres fürt, és önmagában a TLS (Transport Layer Security) története is három részből áll. Az adatbáziscsapat saját gépeken futtatja a PostgreSQL-t, és minden adatbázist ott szeretne tudni, a saját módszerével mentve. A tanúsítványok a Harrow belső CA-jától (tanúsítványkiállító, certificate authority) érkeznek a cert-manageren keresztül. A bejövőforgalom-vezérlő (ingress controller) nem a Traefik, és saját névtérben fut. Mindehhez nincs szükség a chart elágaztatására (forkolására). Minden eltérés egy-egy érték, és ez a fejezet abban a sorrendben veszi végig őket, ahogyan Tomás Reilly találkozott velük.

Ebben a fejezetben minden értékblokk egy-egy töredék. Fésülje össze a szükségeseket a saját values fájljába a 2.6. fejezet (A Community kiadás telepítése Kubernetesre) global, hosts, edition és keys értékei mellé. A chart sémája elutasít minden olyan kulcsot, amelyet nem ismer, így egy elgépelt kulcs nem marad figyelmen kívül, hanem hibára futtatja a helm lint --strict parancsot és a telepítést. Ez szándékos: egy elírás a dataTier kulcsban, amely észrevétlenül a fürtben hagyna egy tárolót, rosszabb lenne, mint egy hibaüzenet.

Külső adattárak

A Nexus öt tárolóban tartja az adatait. Alapértelmezés szerint mindegyik a fürtön belül fut a kiadás saját, aláírt lemezképéből, saját kötettel.

Adattár Values kulcs Fürtön belüli alapértelmezés Alapértelmezett kötet
PostgreSQL 16 PostGIS 3-mal és pgvector 0.8-cal dataTier.postgres a kiadás lemezképe 50Gi
Valkey 8.1 dataTier.valkey a kiadás lemezképe 5Gi
Neo4j 5.26 Community Edition dataTier.neo4j a kiadás lemezképe 20Gi
Qdrant 1.15 dataTier.qdrant a kiadás lemezképe 10Gi
SeaweedFS 4.48, az Amazon S3-mal (Simple Storage Service) kompatibilis objektumtároló dataTier.objectStore a kiadás lemezképe 50Gi

Ezek bármelyikét üzemeltetheti Ön is. Állítsa a mode értékét external-re, adja meg a kiszolgálóját (host), és nevezzen meg egy Secretet, amely a hitelesítő adatait tartalmazza. Adja hozzá a tároló címét a networkPolicy.externalEgressCIDRs listához is (lásd alább a hálózati házirendről szóló részt), mivel a névtér minden egyéb kimenő forgalmat (egress) tilt. Külső tároló esetén a chart semmit sem generál (renderel) az adott tárolóból: nincs StatefulSet, nincs Service és nincs kötet. A szolgáltatások az Ön által megadott kiszolgálóhoz csatlakoznak.

# 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

A Secretet Ön hozza létre a telepítés előtt abban a névtérben, amelybe a Nexus települ. A chart kizárólag a nevét tárolja: a hitelesítő adatot igénylő podok induláskor az Ön Secretjéből olvassák ki azt, és semmi sem másolódik át a chart saját Secretjeibe. Ha módosít egy hitelesítő adatot, indítsa újra az azt használó podokat; nincs mit újragenerálni.

Mindegyik tároló rögzített kulcsneveket keres a saját Secretjében:

Adattár Kulcsok a Secretben
PostgreSQL username és password egy superuser jogosultságú felhasználóhoz az adott szerveren, valamint ca.crt, a szerver tanúsítványát aláíró tanúsítványkiállító (CA)
Valkey password
Neo4j username és password
Qdrant api-key
Objektumtároló access-key és secret-key

Minden értéket fájlból töltsön be, hogy ne kerüljön be a parancssori előzményekbe és a values fájlba:

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

Ha egy külső tárolóhoz nincs megnevezve Secret, az ugyanúgy leállítja a generálást, mintha nem lenne megadva kiszolgáló.

PostgreSQL

A külső szervernek ugyanazt kell nyújtania, amit a kiadás lemezképe: PostgreSQL 16-ot PostGIS 3-mal és pgvectorral. A hozzá irányuló forgalom mindig titkosított, és a rendszer ellenőrzi a Secretben lévő ca.crt alapján. Állítsa a sslmode értékét verify-full-ra – ami azt is ellenőrzi, hogy a szerver tanúsítványa tartalmazza-e az Ön által megadott kiszolgálónevet – vagy verify-ca-ra. Külső szerver esetén a generálás elutasítja a disable és require értékeket. A fürtön belüli Postgres ennek az ellentéte: a forgalma soha nem hagyja el a névteret, a hálózati házirend ott tartja, és kizárólag a disable értéket fogadja el. Bármelyik módot választja is, a tanúsítványnak tartalmaznia kell a external.host alatt megadott kiszolgálónevet, mert egyes szolgáltatások minden csatlakozáskor ellenőrzik a nevet.

Telepítéskor egy előkészítő (bootstrap) Job csatlakozik a szerverhez a Secretben megadott fiókkal, és létrehozza azokat a szerepköröket (role), amelyekkel a Nexus fut. Létrehoz egy sémát birtokló migrator szerepkört, egy futásidejű (runtime) szerepkört, valamint szolgáltatásonként egy-egy bejelentkezési szerepkört. A Nexus generálja és tárolja a jelszavaikat. Egyikük sem superuser, és egyikük sem kerülheti meg a sorszintű biztonságot (row-level security), így az adatbázisban minden elkülönítési házirend minden szolgáltatásra érvényes. Magának az előkészítésnek szüksége van superuserre: az egyik lépése lezár egy beépített PostgreSQL-függvényt, és ezt csak superuser teheti meg. Kizárólag az előkészítés és a konzol saját létesítési (provisioning) lépése használja ezt a fiókot. Emiatt egy olyan felügyelt adatbázis-szolgáltatás, amelynek az adminisztrátori szerepköre nem valódi superuser, nem adhat helyet a Nexus adatbázisnak.

A Job ellenőrzi a szervert, mielőtt hozzányúlna. Ha a Secretben lévő fiók nem superuser, a Job anélkül áll le, hogy bármit módosított volna. Ha már létezik egy nexus nevű szerepkör SUPERUSER vagy BYPASSRLS attribútummal, a Job a következő üzenettel áll le: 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. Távolítsa el ezeket az attribútumokat az adott szerepkörről, vagy használjon olyan szervert, ahol a név szabad, majd indítsa el újra a telepítést.

Valkey, Neo4j, Qdrant és az objektumtároló

A másik négy tároló ugyanazt a három beállítást használja: mode, external.host és external.existingSecret. Íme mind a négy, átállítva a Harrow saját tárolóira:

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

Futtassa a kiadási lemezképekben szereplő, a fenti táblázatban felsorolt verziókat azokon a portokon, amelyeket a szolgáltatások használnak. A Valkey a 6379-es, a Neo4j a 7687-es porton figyel; a Qdrant a 6333-ast, az objektumtároló pedig a 8333-ast használja. Az objektumtárolónak S3-kompatibilisnek kell lennie. A Valkey jelszava minden podon belül bekerül egy csatlakozási címbe, ezért csak betűket és számjegyeket használjon benne (a -._~ karakterek is megfelelőek).

Ha a mode értéke external, és a external.host üres, a generálás a dataTier.<store>.external.host is required when mode is external üzenettel leáll. Egy tároló áthelyezése a fürtön belülről külső helyre azután, hogy már használták a Nexust, olyan adatmigráció, amelyet Önnek kell elvégeznie; a chart semmit sem fog átmásolni Ön helyett. Döntsön még az első telepítés előtt.

A kulcstároló, az OpenBao, nem szerepel ezen a listán, és nem lehet külső. A telepített példány identitásának része, és minden telepítéskor a fürtön belül fut.

TLS a nyilvános végponton

A tls.mode határozza meg, hogyan kapja meg a tanúsítványát a három nyilvános kiszolgáló, és semmi többet. A szolgáltatások közötti forgalom módtól függetlenül mindig kölcsönös TLS-t (mTLS) használ a chart saját helyi CA-jától származó, a cert-manager által kiállított tanúsítványokkal. Nincs service mesh, és a istio.enabled értéke false marad.

tls.mode Ki készíti a tanúsítványt Mit kell beállítania
existing (az alapértelmezett) Ön. Egyetlen Secret tartalmazza mindhárom kiszolgáló tanúsítványát. tls.existingSecret
cert-manager Egy Ön által már futtatott ClusterIssuer. A chart kiszolgálónként egy tanúsítványt kér tőle. tls.clusterIssuer
none Senki a fürtön belül. A TLS a fürt előtt, a terheléselosztónál (load balancer) vagy proxynál ér véget. Semmit, de olvassa el az alábbi figyelmeztetést

existing

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

Minden Ingress a harrow-public-tls Secretet szolgálja ki, ezért a tanúsítványának tartalmaznia kell a console.harrow.example, api.harrow.example és auth.harrow.example neveket. Hozza létre a névtérben a telepítés előtt:

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

Az előzetes ellenőrzés (preflight) beolvassa a tanúsítványt, figyelmeztet, ha 30 napon belül lejár, és megnevezi a Secretet, ha az hiányzik. Ha a mód existing, és a név üres, a generálás a tls.existingSecret is required when tls.mode is existing üzenettel leáll.

cert-manager

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

A chart hozzáadja a cert-manager.io/cluster-issuer annotációt mindhárom Ingresshez, a cert-manager pedig létrehozza a nexus-console-tls, nexus-api-tls és nexus-auth-tls Secreteket. A tls.clusterIssuer nélkül a generálás a tls.clusterIssuer is required when tls.mode is cert-manager üzenettel leáll.

Ha a kiállítója (issuer) az ACME-t (Automatic Certificate Management Environment) használja HTTP-01 kihívással (challenge), nincs szükség semmi másra. A chart nem ad hozzá saját átirányítást, így a /.well-known/acme-challenge/ iránti kérés változatlanul jut el a kiállító megoldójához (solver). Internetkapcsolat nélküli telephelyen a megoldó is egy lemezkép: helyezze el a cert-manager cert-manager-acmesolver lemezképét a saját tárolójában (registry), különben minden kihíváspod ErrImagePull állapotban fog várakozni.

nincs

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

A none beállítással az Ingressek nem tartalmaznak TLS-szakaszt. Akkor használja ezt, ha a fürt előtt álló terheléselosztó vagy fordított proxy (reverse proxy) zárja le a TLS-t a három kiszolgáló számára.

A proxy.trustedCIDRs nevezi meg azokat a proxyugrásokat (proxy hops), amelyek X-Forwarded-For fejlécének a nexus-auth hitelt ad. Az alapértelmezett 10.42.0.0/16 a k3s podhálózata, ahol a bejövőforgalom-vezérlője fut. Bármely más fürtön állítsa ezt arra a hálózatra, amelyet a bejövőforgalom-vezérlő podjai használnak, hogy a bejelentkezési gyakoriságkorlátok (rate limits) és a naplóbejegyzések a felhasználó címét lássák, ne pedig a proxyét.

Cím, tanúsítvány, proxy és levelezés
Cím, tanúsítvány, proxy és levelezés
A telepítés után a cím, a tanúsítvány, a proxy és a levelezés mind saját tesztet kap egyetlen oldalon, és az eredmény szövegesen jelenik meg.

Ingress vezérlők

A chart három egyszerű Kubernetes Ingresst hoz létre, nyilvános kiszolgálónként egyet. Mindegyik a / útvonalat irányítja egy-egy Service-hez.

Ingress Kiszolgáló Service és port
nexus-console hosts.console nexus-alpha, 3000
nexus-api hosts.api nexus-gateway, 9092
nexus-auth hosts.auth nexus-auth, 9101

Három érték határozza meg őket, és a hálózati házirend egy értékének egyeznie kell velük.

# harrow-ingress.yaml (Helm values)
ingress:
  enabled: true
  className: harrow-nginx
  annotations:
    "<annotation-key>": "<annotation-value>"
networkPolicy:
  ingressNamespace: ingress-harrow
  • A ingress.className nevezi meg az IngressClasst. Ha üresen hagyja, a chart elhagyja az osztályt, és a fürt alapértelmezett osztálya veszi át a három Ingresst. Az előzetes ellenőrzés megvizsgálja, hogy az osztály létezik-e, vagy ha nem adott meg egyet sem, akkor pontosan egy osztály van-e alapértelmezettként megjelölve.
  • A ingress.annotations mindhárom Ingresshez hozzáadódik. Az értékek karakterláncok (string), ezért a számokat és a logikai értékeket (boolean) tegye idézőjelbe. Használja ezt a vezérlő saját beállításaihoz.
  • A ingress.enabled: false egyáltalán nem generál Ingresst, olyan környezetek számára, amelyek valamilyen más módon irányítják a forgalmat a három Service-hez.
  • A networkPolicy.ingressNamespace az a névtér, amelyben a bejövőforgalom-vezérlő fut.

Ez az utolsó sokakat megtréfál. A chart hálózati házirendje alapértelmezés szerint minden bejövő forgalmat tilt a névtérbe, majd kizárólag az Ön által megnevezett névtérből engedi be a bejövőforgalom-vezérlőt a három nyilvános Service-hez. Az alapértelmezett kube-system megfelelő a k3s-hez, amely ott futtatja a Traefiket. Bármely más vezérlő esetén, ha ezt változatlanul hagyja, a vezérlő nem éri el a Nexust: az Ingressek léteznek, a vezérlő csatlakozási időtúllépéseket naplóz, a böngésző pedig átjáróhibát (gateway error) kap. Az előzetes ellenőrzés „Ingress ports” vizsgálata egy olyan Service-t keres az adott névtérben, amely nyitva áll a 80-as és 443-as porton LoadBalancerként vagy NodePortként, és a fix sora ezt az értéket nevezi meg.

Bal oldalon egy „ingress controller” feliratú doboz látható egy szaggatott vonallal határolt területen belül, amelynek felirata „namespace: networkPolicy.ingressNamespace (kube-system on k3s)”. Három nyíl indul ki belőle console.harrow.example, api.harrow.example és auth.harrow.example felirattal. Ezek áthaladnak egy „nexus namespace: default deny” feliratú folytonos vonalon, és három dobozhoz érkeznek meg: „nexus-alpha :3000”, „nexus-gateway :9092” és „nexus-auth :9101”. Egy negyedik, beszürkített nyíl, amely az „any other namespace” dobozból indul, egy kis kereszttel megáll a folytonos vonalnál.
A három nyilvános kiszolgáló, a bejövőforgalom-vezérlő névtere, valamint a hálózati házirend, amely kizárólag ezt a névteret engedi be.

A hálózati házirend többi része

A networkPolicy.enabled alapértelmezés szerint true, és annak is kell maradnia. Ezzel a névtérből semmi sem ér el kifelé, kivéve a DNS-t (Domain Name System), a Kubernetes API-t (alkalmazásprogramozási felület) a tokenellenőrzők számára, valamint az Ön által felsorolt címeket.

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

A apiServerCIDRs az API-szerver címe /32-es CIDR-ekként (Classless Inter-Domain Routing). Ha üres, a chart telepítéskor a fürtből olvassa ki. A helm template parancsnak nincs fürtje, amiből olvashatna, ezért ott adja meg. A externalEgressCIDRs minden egyéb olyan cím, amelyet egy számítási feladat (workload) elérhet; alapértelmezés szerint üres. A Harrow itt sorolja fel a levelezési továbbítóját (mail relay). A névtéren kívüli összes külső adattárolót is fel kell itt sorolni, különben az alapértelmezett tiltó házirend megakadályozza, hogy a szolgáltatások elérjék őket.

Mindössze három számítási feladat beszél az API-szerverrel: a nexus-probitas bizonyítékszolgáltatás (evidence service), az orchestrator és a kulcstároló felügyeleti (custody) Jobja. Ezek ellenőrzik a más számítási feladatok által bemutatott szolgáltatásfiók-tokeneket (service-account token). A házirend a 6443-as és 443-as porton kizárólag ennek a háromnak adja meg az API-szerver címét, semmi másnak. Ha ez a három nem éri el a szervert, nem tudják ellenőrizni a más számítási feladatok által bemutatott tokeneket, ezért adja meg az összes lehetséges címét.

TLS-mód kiválasztása

A Harrow a cert-manager módot választotta a belső CA-jával mint ClusterIssuerrel, mégpedig a megújítás miatt. Az existing használatakor egy embernek kell megújítania a tanúsítványt a Secretben a lejárat előtt, és az előzetes ellenőrzés 30 napos figyelmeztetése az egyetlen emlékeztető. A cert-manager esetében a megújítás magától megtörténik, és senkinek sem kell észben tartania. Az none olyan helyre illik, ahol minden nyilvános cím már eleve egy olyan terheléselosztó mögött ül, amely számos rendszer számára zárja le a TLS-t, és ahol az adott csapat felel a tanúsítványokért. Bármelyiket is választja, a böngésző által látott tanúsítványnak olyannak kell lennie, amelyben a böngésző megbízik. Egy önaláírt tanúsítvány, amelyen a felhasználók átkattintanak, tönkreteszi a passkey-ket, mert a Chrome nem hoz létre és nem használ passkey-t tanúsítványfigyelmeztetés mögött.

Tárhely, levelezés, valamint replikák és erőforrások

Tárolóosztály

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

A storage.className minden adatszintű PVC-re (persistent volume claim) és a kulcstároló köteteire vonatkozik. Az üres érték a fürt alapértelmezett osztályát jelenti, és az előzetes ellenőrzés sikertelen lesz, ha egyetlen osztály sincs alapértelmezettként megjelölve, és Ön sem nevezett meg egyet sem. Minden fürtön belüli tárolónak saját size értéke van. A kulcstárolóéi a keys.openbao.storage.unsealer és a keys.openbao.storage.keystore, a nyugtákhoz (receipts) pedig a keys.receiptsStorage tartozik. Válasszon egyéves növekedésnek megfelelő méreteket.

Levelezés

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

A Nexus az Ön levelezőszerverén keresztül küldi a meghívókat és az értesítéseket. A smtp.existingSecret egy Ön által a névtérben létrehozott Secretet nevez meg, amely a levelezőszerver adatait tartalmazza. Mint minden integrációnál, a chart itt is csak a Secret nevét fogadja el, hitelesítő adatot soha. Ne feledkezzen meg a hálózati házirendről: adja hozzá a továbbító (relay) címét a networkPolicy.externalEgressCIDRs listához, különben a levelek elakadnak a névtér határán. Amíg a levelezés nem működik, nem küldhetők meghívók, és ezt az első adminisztrátor ellenőrzőlistája is jelzi.

Replikák és erőforrások

Minden alapkomponensnek van replikaszáma és Kubernetes-erőforrása a components alatt, és minden fürtön belüli tárolónak vannak erőforrásai a dataTier alatt.

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

Az alapértelmezett Neo4j pod 2 GiB-ot kér, és legfeljebb 4 GiB-ot használhat. 3 GB heap és lapgyorsítótár (page cache) esetén növelje meg az igényelt értéket (request) is, hogy a pod olyan csomópontra kerüljön, amely rendelkezik a szükséges memóriával.

A replicas és resources értékekkel rendelkező komponensek a következők: console, bff, auth, orchestrator, workflows, gateway, graphrag, probitas és skillsEngine. A kulcsszolgáltatás, a keys, csak a resources értéket fogadja el. Ezek az alapkomponensek kötelezőek, és nem kapcsolhatók ki; a chart a enabled kapcsolójuk állásától függetlenül futtatja őket. Az adatszintű tárolók egy-egy replikával futnak.

Lassú háttértáron további két érték ad időt a szolgáltatásoknak az elindulásra: a probes.startupFailureThreshold (alapértelmezés szerint 60) és a schemaWait.timeoutSeconds (1800), ami azt adja meg, mennyi ideig vár egy szolgáltatás az adatbázis-migrációira, mielőtt az indítókonténere név szerint hibára futna.

Bejelentkezési munkamenetek, sebességkorlátok és privát modellkiszolgálók

Három kisebb értékcsoportot érdemes ismerni a telepítés előtt, mert ezeket már az első napon észreveszik a felhasználók.

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

A auth.accessTokenTTL és a auth.refreshTokenTTL határozza meg, meddig érvényes egy munkamenet két tokenje. Az alapértelmezett 15 perc és 12 óra azt jelenti, hogy aki este lecsukja a laptopját, annak reggel újra be kell jelentkeznie. Rövidítse le a frissítési tokent (refresh token), ha a házirendje ezt írja elő, és számítson gyakoribb bejelentkezésekre.

A auth.rateLimitPerMinute az a maximális kérésszám, amelyet egy bejelentkezett felhasználó egy perc alatt intézhet a bejelentkezési szolgáltatáshoz, mielőtt az 429-es kóddal válaszolna. Az alapértelmezett 5000 egyetlen fiókból másodpercenként körülbelül 83 kérést jelent, ami bőségesen elegendő a konzolhoz és a szkriptekhez. Egy telepített példányban nincsenek előfizetési csomagok, így mindenki ugyanazt a korlátot kapja. Csökkentse a visszaélések elleni védelem szigorításához, vagy növelje meg intenzív automatizálás esetén. A bejelentkezési brute-force támadások elleni védelem – például a fiókzárolás és a másodlagos ellenőrzési kísérletek korlátozása – ettől különálló, és nem itt kell beállítani.

A ai.installationHosts további, a telepítésen belüli kiszolgálóneveket sorol fel a szervezet saját, privát neveken elérhető AI-modellszerverei (mesterséges intelligencia) számára. Minden bejegyzés egy kiszolgálónév, egy alatta lévő összes névre illeszkedő .suffix, egy IP-cím vagy egy IPv4 CIDR-blokk (Classless Inter-Domain Routing). Az útválasztó (router) a kiadás saját kiszolgálói mellett ezeket is a telepítés részeként kezeli. Magát a modellszervert a ai.localProvider.baseUrl nevezi meg; a 2.14. fejezet (AI-szolgáltatók és -modellek) mindkettőt tárgyalja.

Mi az, ami soha nem lehet konfigurációs érték

Néhány dolog, amit a felhasználók a values fájlban keresnek, szándékosan nincs ott.

Nincs a values fájlban Miért, és hol található helyette
A licenc A telepítés után kell importálni a konzolon vagy a nexusctl licence import <file> paranccsal. A licenc soha nem chartérték vagy felcsatolt fájl. A részleteket a 2.13. fejezet (Licencek) tartalmazza.
Modellkulcsok Minden szervezet a saját készletében (pool) tartja a saját kulcsait, amelyeket a konzolon adnak meg. Egyetlen AI-szolgáltatói hitelesítő adat sem lehet chartérték.
Regisztráció megerősítése (hardening) Az internetes CAPTCHA és a regisztrációs hálózati szűrés egyaránt ki van kapcsolva a telepített példányokon, és nincs olyan érték, amellyel bármelyiket be lehetne kapcsolni. A CAPTCHA-hoz minden regisztrációkor internetkapcsolatra lenne szükség. A hálózati szűréshez olyan licencelt geolokációs adatbázis kellene, amelyet a chart nem tartalmaz. Ehelyett az ismeretlenek regisztrációja adminisztrátori jóváhagyásra vár, ahogy azt a 2.12. fejezet (Az első indítás) elmagyarázza.
Telemetria A séma egyetlen beállítást fogad el a telemetry.enabled számára, ez pedig a false. Semmi sem hagyja el a telepített példányt, és az adatszint saját jelentéskészítése (a Neo4j használati jelentése, a Qdrant telemetriája) szintén ki van kapcsolva.

A teljes fájl ellenőrzése telepítés előtt

Miután a töredékeket egyetlen fájlba fésülte össze, futtasson rajta két ellenőrzést a munkaállomásáról. A helm lint --strict minden kulcsot ellenőriz a chart sémája alapján, a helm template pedig kigenerálja a teljes kiadást, hogy elolvashassa, mielőtt bármi is létrejönne. A parancsok a Community chart címét használják; az Enterprise verzióhoz adja meg helyette a letöltött Enterprise chart elérési útját (2.7. fejezet, Az Enterprise telepítése és a licenc alkalmazása). A munkaállomáson végzett generálás nem tudja kiolvasni az API-szerver címét a fürtből, ezért előbb állítsa be a fájlban a networkPolicy.apiServerCIDRs értékét.

A két ellenőrzés:

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

Egy elgépelt kulcs „additional properties” hibával megbuktatja a lint ellenőrzést, és megnevezi a kulcsot. Egy hiányzó kötelező érték – például a kiszolgáló, ha egy tároló külső – az ebben a fejezetben idézett mondattal állítja le a generálást. A helm template parancsnak nincs fürtje, amiből olvashatna, ezért offline generáláskor adja meg a networkPolicy.apiServerCIDRs értékeit, különben leáll, és bekéri őket.

Ezután futtassa az előzetes ellenőrzést (preflight) ugyanezzel a fájllal. Az előzetes ellenőrzés az egyetlen vizsgálat, amely együtt olvassa be a fürtöt és az értékeket: itt derül ki a hibás ingress névtér, a hiányzó tárolóosztály (storage class) vagy a jövő héten lejáró tanúsítvány, még mielőtt bárki is függene a telepítéstől.

Menedzselt Kubernetes

A Nexus bármely szabványkövető, 1.33-as vagy újabb Kubernetesen fut, beleértve a felhőszolgáltatók felügyelt szolgáltatásait is. A chartban semmi sem kötődik egyetlen szolgáltatóhoz sem. Ami a k3s-hez képest változik, az csupán néhány érték, amelyek mindegyikét tárgyaltuk fentebb:

  • Elsőként a cert-manager v1.21.3-at kell telepíteni, mint bármely más fürtön. | Felügyelt fürtön | Mit kell beállítani vagy ellenőrizni | |---|---| | Háttértár | Nevezze meg a szolgáltató osztályát a storage.className alatt, vagy jelöljön meg egyet alapértelmezettként. | | Ingress | Telepítse a használt bejövőforgalom-vezérlőt, tegye elérhetővé a 80-as és 443-as porton, állítsa be a ingress.className értékét, ha nem az alapértelmezett, a networkPolicy.ingressNamespace értékét pedig állítsa a névterére. | | A proxyugrások | Állítsa a proxy.trustedCIDRs értékét az adott vezérlő podhálózatára. | | Az API-szerver | Ha a telepítés nem tudja kiolvasni az API-szerver címét a fürtből, adja meg a networkPolicy.apiServerCIDRs alatt. | | Hálózati házirend kikényszerítése | A chart házirendjei csak ott lépnek érvénybe, ahol a fürt hálózati beépülő modulja (plugin) kikényszeríti a NetworkPolicy-t. Válasszon olyan fürtkonfigurációt, amely ezt megteszi. | | Lemezképek | A csomópontoknak el kell érniük a registry.adverant.ai címet, vagy az Ön saját, global.imageRegistry alatt megnevezett tárolóját (registry). |

Minden más előtt futtassa az előzetes ellenőrzést. Ez együtt olvassa be a fürtöt és a values fájlt, és mindezeket egy-egy sorként írja ki, a javítással együtt minden olyan tétel mellett, amely hiányzik. A jelentést a 2.5. fejezet (Előzetes ellenőrzés a nexusctl-lel) mutatja be.

Telepítés előtt
A telepítés előtt
Sikeres előzetes ellenőrzés egy éles fürtön. Minden sor egy-egy követelmény, és minden figyelmeztetés az alatta lévő sorban tartalmazza a javítását.