Kirjaudu sisäänVaraa esittely

Luku 2.11

Muunnelmat: ulkoiset tietovarastot, TLS ja ingress

Arvot, joilla Nexus sovitetaan muuhun kuin tyhjään klusteriin, mukaan lukien TLS (Transport Layer Security), jo käytössäsi olevat tietokannat, omat varmenteesi, toinen ingress-ohjain, tallennusluokat, sähköposti, välityspalvelimet, replikat ja hallinnoitu Kubernetes.

Tämä sivu on käännetty tekoälyllä englanninkielisestä alkuperäistekstistä. Jos jokin kohta on epäselvä, englanninkielinen sivu on ensisijainen lähde. Lue tämä sivu englanniksi

17 minuutin lukuaika

Harrow Port Authorityn tuotantoklusteri ei ole tyhjä, ja pelkästään sen TLS-ratkaisussa (Transport Layer Security) on kolme osaa. Tietokantatiimi ajaa PostgreSQL:ää omilla koneillaan ja haluaa jokaisen tietokannan sinne, varmuuskopioituna heidän tavallaan. Varmenteet tulevat Harrow'n sisäiseltä varmentajalta (CA, certificate authority) cert-managerin kautta. Ingress-ohjain ei ole Traefik, ja se sijaitsee omassa nimiavaruudessaan. Mikään tästä ei vaadi Helm-kaavion (chart) haarauttamista. Jokainen ero on arvo, ja tässä luvussa ne käydään läpi siinä järjestyksessä kuin Tomás Reilly kohtasi ne.

Jokainen tämän luvun arvolohko on katkelma. Yhdistä tarvitsemasi osat omaan arvotiedostoosi luvun 2.6, Community-version asentaminen Kubernetekseen, arvojen global, hosts, edition ja keys rinnalle. Kaavion skeema hylkää kaikki avaimet, joita se ei tunne, joten väärin kirjoitettu avain kaataa helm lint --strict-komennon ja asennuksen sen sijaan, että se jätettäisiin huomiotta. Tämä on tarkoituksellista: kirjoitusvirhe arvossa dataTier, joka jättäisi tietovaraston huomaamatta klusterin sisään, olisi pahempi kuin virhe.

Ulkoiset tietovarastot

Nexus säilyttää tietonsa viidessä tietovarastossa. Oletusarvoisesti kukin niistä ajetaan klusterin sisällä julkaisun omasta allekirjoitetusta levykuvasta, omalla tallennusosiollaan.

Tietovarasto Values-avain Klusterin sisäinen oletus Oletustallennusosa
PostgreSQL 16 sekä PostGIS 3 ja pgvector 0.8 dataTier.postgres julkaisun levykuva 50Gi
Valkey 8.1 dataTier.valkey julkaisun levykuva 5Gi
Neo4j 5.26 Community Edition dataTier.neo4j julkaisun levykuva 20Gi
Qdrant 1.15 dataTier.qdrant julkaisun levykuva 10Gi
SeaweedFS 4.48, Amazon S3:n (Simple Storage Service) kanssa yhteensopiva objektivarasto dataTier.objectStore julkaisun levykuva 50Gi

Mikä tahansa niistä voi olla sen sijaan itse ylläpitämäsi. Aseta sen mode arvoon external, anna sen palvelinosoite ja nimeä Secret, joka sisältää sen kirjautumistiedot. Lisää tietovaraston osoite myös arvoon networkPolicy.externalEgressCIDRs (katso alla oleva verkkokäytäntöosio), koska nimiavaruus estää kaiken muun lähtevän liikenteen. Ulkoiselle tietovarastolle kaavio ei luo mitään kyseiseen varastoon liittyvää: ei StatefulSetiä, ei Serviceä eikä tallennusosiota. Palvelut yhdistävät antamaasi palvelinosoitteeseen.

# 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

Luot itse Secretin ennen asennusta siihen nimiavaruuteen, johon Nexus asennetaan. Kaavio säilyttää aina vain sen nimen: kirjautumistietoa tarvitsevat podit lukevat sen Secretistäsi käynnistyessään, eikä mitään kopioida kaavion omiin Secreteihin. Kun vaihdat kirjautumistiedon ja käynnistät sitä käyttävät podit uudelleen, mitään ei tarvitse renderöidä uudelleen.

Kukin tietovarasto etsii Secretistään kiinteitä avainten nimiä:

Tietovarasto Avaimet sen Secretissä
PostgreSQL username ja password kyseisen palvelimen pääkäyttäjälle (superuser) sekä ca.crt, varmentaja (CA), joka allekirjoitti palvelimen varmenteen
Valkey password
Neo4j username ja password
Qdrant api-key
Objektivarasto access-key ja secret-key

Lataa kukin arvo tiedostosta, jotta se ei jää komentorivihistoriaasi eikä arvotiedostoosi:

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

Ulkoinen tietovarasto, jolle ei ole nimetty Secretiä, pysäyttää renderöinnin aivan kuten varasto, jolle ei ole annettu palvelinosoitetta.

PostgreSQL

Ulkoisen palvelimen on tarjottava sama kuin julkaisun levykuva: PostgreSQL 16, jossa on PostGIS 3 ja pgvector. Liikenne sinne on aina salattua ja se tarkistetaan Secretissäsi olevaa ca.crt-arvoa vasten. Aseta sslmode arvoon verify-full, mikä tarkistaa myös, että palvelimen varmenne sisältää antamasi palvelinosoitteen, tai arvoon verify-ca. Ulkoisen palvelimen kanssa renderöinti hylkää arvot disable ja require. Klusterin sisäinen Postgres toimii päinvastoin: sen liikenne ei koskaan poistu nimiavaruudesta, verkkokäytäntö pitää sen siellä, ja se hyväksyy vain arvon disable. Valitsitpa kumman tilan tahansa, varmenteessa on oltava arvossa external.host annettu palvelinosoite, koska jotkin palvelut tarkistavat nimen jokaisella yhteydellä.

Asennuksen yhteydessä alustus-Job (bootstrap) yhdistää palvelimeen Secretissäsi olevalla tilillä ja luo roolit, joina Nexus toimii. Se luo skeeman omistavan migraattoriroolin, ajonaikaisen roolin ja yhden kirjautumisroolin kullekin palvelulle. Nexus luo niiden salasanat ja säilyttää ne. Mikään niistä ei ole pääkäyttäjä (superuser) eikä mikään niistä voi ohittaa rivitason suojausta (row-level security), joten jokainen tietokannan eristyskäytäntö koskee jokaista palvelua. Itse alustus tarvitsee pääkäyttäjän: yksi sen vaiheista lukitsee sisäänrakennetun PostgreSQL-funktion, ja vain pääkäyttäjä voi tehdä sen. Vain alustus ja konsolin oma käyttöönoton valmisteluvaihe käyttävät tätä tiliä. Hallinnoitu tietokantapalvelu, jonka järjestelmänvalvojan rooli ei ole oikea pääkäyttäjä, ei tästä syystä voi isännöidä Nexuksen tietokantaa.

Job tarkistaa palvelimesi ennen kuin se tekee siihen muutoksia. Se pysähtyy muuttamatta mitään, jos Secretissäsi oleva tili ei ole pääkäyttäjä. Jos nexus-niminen rooli on jo olemassa attribuuteilla SUPERUSER tai BYPASSRLS, Job pysähtyy virheeseen 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. Poista kyseiset attribuutit tältä roolilta tai käytä palvelinta, jossa nimi on vapaa, ja asenna uudelleen.

Valkey, Neo4j, Qdrant ja objektivarasto

Muut neljä ottavat samat kolme asetusta: mode, external.host ja external.existingSecret. Tässä kaikki neljä on vaihdettu Harrow'n omiin:

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

Aja yllä olevassa taulukossa lueteltuja julkaisun levykuvien mukaisia versioita niissä porteissa, joita palvelut käyttävät. Valkey kuuntelee porttia 6379 ja Neo4j porttia 7687; Qdrant käyttää porttia 6333 ja objektivarasto porttia 8333. Objektivaraston on oltava S3-yhteensopiva. Valkeyn salasana sijoitetaan yhteysosoitteeseen kunkin podin sisällä, joten käytä siinä vain kirjaimia ja numeroita (myös merkit -._~ käyvät).

Jos mode on external ja external.host on tyhjä, renderöinti pysähtyy virheeseen dataTier.<store>.external.host is required when mode is external. Tietovaraston siirtäminen klusterin sisältä ulkoiseksi sen jälkeen, kun Nexusta on jo käytetty, on tietomigraatio, jonka teet itse, eikä kaavio kopioi mitään puolestasi. Päätä asia ennen ensimmäistä asennusta.

Avainvarasto, OpenBao, ei ole tällä listalla eikä se voi olla ulkoinen. Se on osa asennuksen identiteettiä ja sitä ajetaan klusterissa jokaisessa asennuksessa.

TLS julkisella reunalla

tls.mode päättää vain sen, miten kolme julkista palvelinosoitetta saavat varmenteensa, ei muuta. Palveluiden välinen liikenne käyttää aina molemminpuolista TLS:ää (mTLS) varmenteilla, jotka cert-manager on myöntänyt kaavion omasta paikallisesta CA:sta, tilasta riippumatta. Palveluverkkoa (service mesh) ei ole, ja istio.enabled pysyy arvossa false.

tls.mode Kuka luo varmenteen Mitä sinun on asetettava
existing (oletus) Sinä. Yksi Secret sisältää varmenteen kaikille kolmelle palvelinosoitteelle. tls.existingSecret
cert-manager ClusterIssuer, jota jo ajat. Kaavio pyytää siltä yhden varmenteen palvelinosoitetta kohden. tls.clusterIssuer
none Ei kukaan klusterissa. TLS päättyy sen edessä, kuormantasaimellasi tai välityspalvelimellasi. Ei mitään, mutta lue alla oleva varoitus

existing

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

Jokainen Ingress tarjoaa Secretin harrow-public-tls, joten sen varmenteessa on oltava nimet console.harrow.example, api.harrow.example ja auth.harrow.example. Luo se nimiavaruuteen ennen asennusta:

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

Preflight-tarkistus lukee sen, varoittaa, jos se vanhenee 30 päivän kuluessa, ja nimeää Secretin, jos se puuttuu. Kun tila on existing ja nimi on tyhjä, renderöinti pysähtyy virheeseen 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

Kaavio lisää annotaation cert-manager.io/cluster-issuer jokaiseen kolmesta Ingressistä, ja cert-manager luo Secretit nexus-console-tls, nexus-api-tls ja nexus-auth-tls. Ilman arvoa tls.clusterIssuer renderöinti pysähtyy virheeseen tls.clusterIssuer is required when tls.mode is cert-manager.

Jos myöntäjäsi käyttää ACME-protokollaa (Automatic Certificate Management Environment) HTTP-01-haasteen kanssa, muuta ei tarvita. Kaavio ei lisää omaa uudelleenohjausta, joten pyyntö polkuun /.well-known/acme-challenge/ saavuttaa myöntäjäsi ratkaisijan (solver) muuttumattomana. Ympäristössä, jossa ei ole internet-yhteyttä, myös ratkaisija on levykuva: sijoita cert-managerin cert-manager-acmesolver-levykuva rekisteriisi, tai jokainen haaste-podi jää odottamaan tilaan ErrImagePull.

ei mitään

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

Arvolla none Ingresseissä ei ole TLS-osiota. Käytä sitä, kun klusterin edessä oleva kuormantasain tai käänteinen välityspalvelin päättää TLS:n kolmen palvelinosoitteen osalta.

proxy.trustedCIDRs nimeää välityspalvelinhypyt, joiden X-Forwarded-For-otsikkoon nexus-auth luottaa. Oletus, 10.42.0.0/16, on k3s:n pod-verkko, jossa sen ingress-ohjain toimii. Missä tahansa muussa klusterissa aseta se verkkoon, jota ingress-ohjaimesi podit käyttävät, jotta kirjautumisen nopeusrajoitukset ja tarkastuslokit näkevät käyttäjän osoitteen eivätkä välityspalvelimen osoitetta.

Osoite, varmenne, välityspalvelin ja sähköposti
Osoite, varmenne, välityspalvelin ja sähköposti
Asennuksen jälkeen osoitteella, varmenteella, välityspalvelimella ja sähköpostilla on kullakin oma testinsä yhdellä sivulla, ja tulos kirjoitetaan sanallisesti.

Ingress-ohjaimet

Kaavio luo kolme tavallista Kubernetes Ingressiä, yhden kutakin julkista palvelinosoitetta kohden. Kukin reitittää polun / yhteen Serviceen.

Ingress Palvelinosoite Service ja portti
nexus-console hosts.console nexus-alpha, 3000
nexus-api hosts.api nexus-gateway, 9092
nexus-auth hosts.auth nexus-auth, 9101

Kolme arvoa muovaavat niitä, ja yhden verkkokäytännön arvon on täsmättävä.

# harrow-ingress.yaml (Helm values)
ingress:
  enabled: true
  className: harrow-nginx
  annotations:
    "<annotation-key>": "<annotation-value>"
networkPolicy:
  ingressNamespace: ingress-harrow
  • ingress.className nimeää IngressClassin. Jos se jätetään tyhjäksi, kaavio jättää luokan pois ja klusterin oletusluokka ottaa kolme Ingressiä hoitaakseen. Preflight tarkistaa, että luokka on olemassa tai, jos et nimennyt yhtäkään, että täsmälleen yksi luokka on merkitty oletukseksi.
  • ingress.annotations lisätään kaikkiin kolmeen Ingressiin. Arvot ovat merkkijonoja, joten laita numerot ja totuusarvot lainausmerkkeihin. Käytä sitä ohjaimesi omiin asetuksiin.
  • ingress.enabled: false ei renderöi lainkaan Ingressiä ympäristölle, joka reitittää liikenteen kolmeen Serviceen jollakin muulla tavalla.
  • networkPolicy.ingressNamespace on nimiavaruus, jossa ingress-ohjaimesi toimii.

Viimeksi mainittu yllättää monet. Kaavion verkkokäytäntö estää oletusarvoisesti kaiken liikenteen nimiavaruuteen ja päästää sitten ingress-ohjaimen kolmeen julkiseen Serviceen vain nimeämästäsi nimiavaruudesta. Oletus, kube-system, on oikea k3s:lle, joka ajaa Traefikia siellä. Minkä tahansa muun ohjaimen kanssa sen jättäminen ennalleen estää ohjainta saavuttamasta Nexusta: Ingressit ovat olemassa, ohjain kirjaa lokiin yhteyden aikakatkaisuja ja selain saa yhdyskäytävävirheen. Preflightin "Ingress ports" -tarkistus etsii kyseisestä nimiavaruudesta Serviceä, joka on avoinna porteissa 80 ja 443 LoadBalancerina tai NodePortina, ja sen fix-rivi nimeää tämän arvon.

Vasemmalla laatikko "ingress controller" sijaitsee katkoviivalla rajatun alueen sisällä, jonka otsikko on "namespace: networkPolicy.ingressNamespace (kube-system on k3s)". Siitä lähtee kolme nuolta, joiden otsikot ovat console.harrow.example, api.harrow.example ja auth.harrow.example. Ne ylittävät yhtenäisen viivan, jonka otsikko on "nexus namespace: default deny", ja saapuvat kolmeen laatikkoon: "nexus-alpha :3000", "nexus-gateway :9092" ja "nexus-auth :9101". Neljäs, harmaa nuoli laatikosta "any other namespace" pysähtyy yhtenäiseen viivaan pienen rastin kohdalle.
Kolme julkista palvelinosoitetta, ingress-ohjaimen nimiavaruus ja verkkokäytäntö, joka sallii vain kyseisen nimiavaruuden.

Muu verkkokäytäntö

networkPolicy.enabled on oletusarvoisesti true, ja sen tulisi pysyä sellaisena. Sen avulla mikään nimiavaruudessa ei pääse ulos lukuun ottamatta DNS:ää (Domain Name System), Kubernetes API:a (application programming interface) valtuustietojen tarkistajia varten ja luettelemiasi osoitteita.

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

apiServerCIDRs on API-palvelimen osoite /32 CIDR-muodossa (Classless Inter-Domain Routing). Jos se on tyhjä, kaavio lukee sen klusterista asennuksen yhteydessä. Komennolla helm template ei ole klusteria luettavana, joten anna se silloin. externalEgressCIDRs kattaa kaiken muun, mihin työkuorma saa yhdistää, ja se on oletusarvoisesti tyhjä. Harrow luettelee siinä sähköpostivälittäjänsä. Jokainen nimiavaruuden ulkopuolinen tietovarasto on myös lueteltava tässä, tai oletuksena kaiken estävä käytäntö estää palveluita saavuttamasta sitä.

Vain kolme työkuormaa keskustelee koskaan API-palvelimen kanssa: todistepalvelu nexus-probitas, orkestroija ja avainvaraston hallinta-Job. Ne tarkistavat muiden työkuormien esittämät palvelutilien valtuustiedot (service-account tokens). Käytäntö antaa API-palvelimen osoitteen porteissa 6443 ja 443 vain näille kolmelle eikä millekään muulle. Jos nämä kolme eivät saavuta sitä, ne eivät voi tarkistaa muiden työkuormien esittämiä valtuustietoja, joten anna jokainen osoite, joka sillä voi olla.

TLS-tilan valitseminen

Harrow valitsi tilan cert-manager ja sisäisen CA:nsa ClusterIssuerina, ja syynä oli uusiminen. Tilassa existing ihmisen on uusittava Secretissä oleva varmenne ennen sen vanhenemista, ja preflightin 30 päivän varoitus on ainoa muistutus. Tilassa cert-manager uusiminen tapahtuu itsestään, eikä kenenkään tarvitse muistaa sitä. none sopii ympäristöön, jossa jokainen julkinen osoite on jo valmiiksi sellaisen kuormantasaimen takana, joka päättää TLS:n monille järjestelmille, ja jossa kyseinen tiimi omistaa varmenteet. Valitsitpa minkä tahansa, selaimen näkemän varmenteen on oltava sellainen, johon selain luottaa. Itse allekirjoitettu varmenne, jonka varoituksen käyttäjät ohittavat, rikkoo avainkoodit, koska Chrome ei luo eikä käytä avainkoodia varmennevaroituksen takana.

Tallennustila, sähköposti sekä replikat ja resurssit

Tallennusluokka (Storage class)

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

storage.className koskee jokaista tietokerroksen PVC:tä (persistent volume claim) ja avainvaraston tallennusosioita. Tyhjä tarkoittaa klusterin oletusluokkaa, ja preflight epäonnistuu, jos yhtäkään luokkaa ei ole merkitty oletukseksi etkä nimennyt sellaista. Jokaisella klusterin sisäisellä tietovarastolla on oma size. Avainvaraston vastaavat ovat keys.openbao.storage.unsealer ja keys.openbao.storage.keystore, sekä keys.receiptsStorage kuiteille. Valitse koot vuoden kasvua silmällä pitäen.

Sähköposti

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

Nexus lähettää kutsut ja ilmoitukset sähköpostipalvelimesi kautta. smtp.existingSecret nimeää nimiavaruuteen luomasi Secretin, joka sisältää sähköpostipalvelimen tiedot. Kuten jokaisessa integraatiossa, kaavio ottaa vastaan Secretin nimen eikä koskaan kirjautumistietoa. Muista verkkokäytäntö: lisää välittäjän osoite arvoon networkPolicy.externalEgressCIDRs, tai sähköposti pysähtyy nimiavaruuden reunalle. Ennen kuin sähköposti toimii, kutsuja ei voida lähettää, ja ensimmäisen järjestelmänvalvojan tarkistuslista kertoo tämän.

Replikat ja resurssit

Jokaisella ydinkomponentilla on replikamäärä ja Kubernetes-resurssit kohdassa components, ja jokaisella klusterin sisäisellä tietovarastolla on resurssit kohdassa 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 } }

Oletusarvoinen Neo4j-podi pyytää 2 GiB ja voi käyttää enintään 4 GiB. Kun kekomuistia (heap) ja sivuvälimuistia (page cache) on 3 GB, nosta myös sen pyyntöä, jotta podi sijoitetaan solmulle, jolla on tarvittava muisti.

Komponentit, joilla on replicas ja resources, ovat console, bff, auth, orchestrator, workflows, gateway, graphrag, probitas ja skillsEngine. Avainpalvelu, keys, ottaa vain arvon resources. Nämä ydinkomponentit ovat pakollisia eikä niitä voi kytkeä pois päältä; kaavio ajaa niitä riippumatta siitä, mitä niiden enabled-kytkin sanoo. Tietokerroksen varastoja ajetaan kutakin yhtenä replikana.

Hitaalla tallennusjärjestelmällä kaksi lisäarvoa antavat palveluille aikaa käynnistyä: probes.startupFailureThreshold (oletuksena 60) ja schemaWait.timeoutSeconds (1800), eli kuinka kauan palvelu odottaa tietokantamigraatioitaan ennen kuin sen käynnistyskontti epäonnistuu nimeltä.

Kirjautumisistunnot, nopeusrajoitukset ja yksityiset mallipalvelimet

Kolme pienempää arvoryhmää on hyvä tuntea ennen asennusta, koska käyttäjät huomaavat ne jo ensimmäisenä päivänä.

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

auth.accessTokenTTL ja auth.refreshTokenTTL määrittävät, kuinka kauan istunnon kaksi valtuustietoa (token) ovat voimassa. Oletukset, 15 minuuttia ja 12 tuntia, tarkoittavat, että illalla kannettavan tietokoneen sulkeva henkilö kirjautuu aamulla uudelleen sisään. Lyhennä virkistystunnisteen (refresh token) kestoa, jos käytäntösi vaatii sitä, ja varaudu useampiin kirjautumisiin.

auth.rateLimitPerMinute on enimmäismäärä pyyntöjä, jonka yksi sisäänkirjautunut henkilö voi tehdä kirjautumispalveluun minuutissa ennen kuin se vastaa koodilla 429. Oletus, 5000, on noin 83 pyyntöä sekunnissa yhdeltä tililtä, mikä riittää hyvin konsolille ja komentosarjoille. Asennuksessa ei ole tilaustasoja, joten jokainen henkilö saa saman rajan. Laske sitä tiukentaaksesi väärinkäytön estoa tai nosta sitä raskasta automaatiota varten. Kirjautumisen väsytyshyökkäysten (brute-force) suojaus, kuten tilin lukitus ja toisen vaiheen tarkistusyritysten rajat, on erillinen eikä sitä aseteta tässä.

ai.installationHosts luettelee asennuksen sisäiset lisäpalvelinnimet organisaation omille, yksityisillä nimillä toimiville tekoälymallien (AI, artificial intelligence) palvelimille. Jokainen merkintä on palvelinnimi, .suffix, joka täsmää jokaiseen sen alla olevaan nimeen, IP-osoite tai IPv4 CIDR -lohko (Classless Inter-Domain Routing). Reititin kohtelee niitä osana asennusta julkaisun omien palvelinosoitteiden rinnalla. Itse mallipalvelin nimetään kohdassa ai.localProvider.baseUrl; luku 2.14, Tekoälypalveluntarjoajat ja -mallit, käsittelee molempia.

Mikä ei koskaan ole arvo

Jotkin asiat, joita arvotiedostosta etsitään, puuttuvat sieltä tarkoituksella.

Ei arvotiedostossa Miksi, ja missä se on sen sijaan
Lisenssi Se tuodaan asennuksen jälkeen, konsolissa tai komennolla nexusctl licence import <file>. Lisenssi ei ole koskaan kaavion arvo tai liitetty tiedosto. Luvussa 2.13, Lisenssit, on tästä tarkemmat tiedot.
Malliavaimet Jokainen organisaatio säilyttää omat avaimensa omassa varannossaan, johon ne syötetään konsolissa. Mikään tekoälypalveluntarjoajan kirjautumistieto ei ole koskaan kaavion arvo.
Rekisteröitymisen koventaminen Internet-CAPTCHA ja rekisteröitymisen verkkoseulonta ovat molemmat pois päältä asennuksessa, eikä kummankaan kytkemiseksi päälle ole arvoa. CAPTCHA vaatisi internet-yhteyden jokaisella rekisteröitymiskerralla. Verkkoseulonta vaatisi lisensoidun paikannustietokannan, jota kaavio ei sisällä. Tuntemattoman käyttäjän rekisteröityminen pidetään sen sijaan odottamassa järjestelmänvalvojan hyväksyntää, kuten luku 2.12, Ensimmäinen käynnistys, selittää.
Telemetria Skeema hyväksyy yhden asetuksen arvolle telemetry.enabled, joka on false. Mikään ei poistu asennuksesta, ja myös tietokerroksen oma raportointi (Neo4j:n käyttöraportti, Qdrantin telemetria) on kytketty pois päältä.

Tarkista koko tiedosto ennen asennusta

Kun katkelmat on yhdistetty yhdeksi tiedostoksi, aja sille kaksi tarkistusta työasemaltasi. helm lint --strict validoi jokaisen avaimen kaavion skeemaa vasten, ja helm template renderöi koko julkaisun luettavaksesi ennen kuin mitään luodaan. Komennot käyttävät Community-kaavion osoitetta; anna Enterprise-versiota varten sen sijaan lataamasi Enterprise-kaavion polku (luku 2.7, Enterprise-version asentaminen ja lisenssin käyttöönotto). Työasemallasi tehtävä renderöinti ei voi lukea API-palvelimen osoitetta klusterista, joten aseta networkPolicy.apiServerCIDRs tiedostoon ensin.

Nämä kaksi tarkistusta:

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

Väärin kirjoitettu avain kaataa lint-tarkistuksen virheeseen "additional properties" ja nimeää avaimen. Puuttuva pakollinen arvo, kuten palvelinosoite tietovaraston ollessa ulkoinen, kaataa renderöinnin tässä luvussa lainatulla lauseella. Komennolla helm template ei ole klusteria luettavana, joten anna networkPolicy.apiServerCIDRs, kun renderöit offline-tilassa, tai se pysähtyy ja pyytää niitä.

Aja sen jälkeen preflight samalla tiedostolla. Preflight on ainoa tarkistus, joka lukee klusteria ja arvoja yhdessä: siinä väärä ingress-nimiavaruus, puuttuva tallennusluokka tai ensi viikolla vanheneva varmenne paljastuu ennen kuin kukaan on riippuvainen asennuksesta.

Hallinnoitu Kubernetes

Nexus toimii missä tahansa vaatimustenmukaisessa Kubernetes 1.33:ssa tai uudemmassa, mukaan lukien pilvipalveluntarjoajan hallinnoitu palvelu. Mikään kaaviossa ei ole sidottu yhteen palveluntarjoajaan. Se, mikä muuttuu k3s:ään verrattuna, on kourallinen arvoja, joista jokainen on käsitelty yllä:

  • cert-manager v1.21.3 asennetaan ensin, kuten missä tahansa klusterissa. | Hallinnoidussa klusterissa | Mitä asettaa tai tarkistaa | |---|---| | Tallennustila | Nimeä palveluntarjoajan luokka arvossa storage.className tai merkitse yksi oletukseksi. | | Ingress | Asenna käyttämäsi ingress-ohjain, julkaise se porteissa 80 ja 443, aseta ingress.className, jos se ei ole oletus, ja aseta networkPolicy.ingressNamespace sen nimiavaruuteen. | | Välityspalvelinhypyt | Aseta proxy.trustedCIDRs kyseisen ohjaimen pod-verkkoon. | | API-palvelin | Jos asennus ei voi lukea API-palvelimen osoitetta klusterista, anna se arvossa networkPolicy.apiServerCIDRs. | | Verkkokäytännön toimeenpano | Kaavion käytännöt tulevat voimaan vain silloin, kun klusterin verkkoliitännäinen panee NetworkPolicyn toimeen. Valitse klusterikokoonpano, joka tekee niin. | | Levykuvat | Solmujen on saavutettava registry.adverant.ai tai oma rekisterisi, joka on nimetty arvossa global.imageRegistry. |

Aja preflight ennen mitään muuta. Se lukee klusterin ja arvotiedoston yhdessä ja tulostaa jokaisen näistä rivinä, sekä korjauksen jokaisen puuttuvan kohdan viereen. Luku 2.5, Preflight-tarkistus nexusctl:llä, näyttää raportin.

Ennen asennusta
Ennen asennusta
Läpäisty preflight tuotantoklusterissa. Jokainen rivi on yksi vaatimus, ja jokaisen varoituksen alla olevalla rivillä on sen korjaus.