InnskráningBóka kynningu

Kafli 2.11

Tilbrigði: ytri gagnageymslur, TLS og inngangsumferð

Gildin sem aðlaga Nexus að klasa sem er ekki tómur, þar á meðal TLS (Transport Layer Security), ásamt gagnagrunnum sem þú rekur nú þegar, þínum eigin skilríkjum, öðrum stýringum fyrir inngangsumferð, geymsluflokkum, pósti, milliþjónum, eftirmyndum og stýrðu Kubernetes.

Þessi síða var þýdd með gervigreind úr enska frumtextanum. Ef eitthvað er óljóst gildir enska síðan til viðmiðunar. Lesa þessa síðu á ensku

17 mínútna lestur

Framleiðsluþyrping Harrow Port Authority er ekki óskrifað blað og TLS-uppsetningin (Transport Layer Security) ein og sér er í þremur hlutum. Gagnagrunnsteymið rekur PostgreSQL á eigin vélum og vill hafa alla gagnagrunna þar, afritaða eftir þeirra hætti. Skilríki koma frá innri vottunarstöð (CA – certificate authority) Harrow í gegnum cert-manager. Ingress-stýringin er ekki Traefik og hún er í sínu eigin nafnrými. Ekkert af þessu krefst þess að Helm-kortinu (chart) sé breytt í nýja útgáfu (fork). Hver munur er bara gildi og þessi kafli fer yfir þau í sömu röð og Tomás Reilly mætti þeim.

Hver gildisblokk í þessum kafla er brot. Sameinið þau brot sem þið þurfið inn í ykkar eigin gildisskrá (values file), við hlið global, hosts, edition og keys úr kafla 2.6, Uppsetning Community á Kubernetes. Skema kortsins hafnar öllum lyklum sem það þekkir ekki, þannig að rangt stafsettur lykill fellir helm lint --strict og uppsetninguna í stað þess að vera hunsaður. Það er gert af ásettu ráði: innsláttarvilla í dataTier sem myndi þegjandi og hljóðalaust skilja gagnageymslu eftir inni í þyrpingunni væri verri en villa.

Ytri gagnageymslur

Nexus geymir gögn sín í fimm gagnageymslum. Sjálfgefið keyrir hver þeirra inni í þyrpingunni af eigin undirritaðri mynd (image) útgáfunnar, með sitt eigið gagnasvæði (volume).

Gagnageymsla Gildislykill Sjálfgefið innan þyrpingar Sjálfgefið gagnasvæði
PostgreSQL 16 með PostGIS 3 og pgvector 0.8 dataTier.postgres útgáfumyndin 50Gi
Valkey 8.1 dataTier.valkey útgáfumyndin 5Gi
Neo4j 5.26 Community Edition dataTier.neo4j útgáfumyndin 20Gi
Qdrant 1.15 dataTier.qdrant útgáfumyndin 10Gi
SeaweedFS 4.48, hlutageymslan (object store) sem er samhæf við Amazon S3 (Simple Storage Service) dataTier.objectStore útgáfumyndin 50Gi

Hver sem er af þeim getur verið geymsla sem þið rekið í staðinn. Stillið mode hennar á external, gefið upp hýsil hennar og tilgreinið Secret sem geymir auðkenni hennar. Bætið vistfangi geymslunnar einnig við networkPolicy.externalEgressCIDRs (sjá kaflann um netreglur hér að neðan), vegna þess að nafnrýmið hafnar allri annarri útleiðarumferð (egress). Fyrir ytri geymslu teiknar (renders) kortið ekkert upp fyrir þá geymslu: ekkert StatefulSet, ekkert Service og ekkert gagnasvæði (volume). Þjónusturnar tengjast hýslinum sem þið gáfuð upp.

# 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

Þið búið til þetta Secret í nafnrýminu sem Nexus er sett upp í, fyrir uppsetninguna. Kortið geymir aðeins nafn þess: podarnir sem þurfa auðkenni lesa það úr ykkar Secret þegar þeir ræsast og ekkert er afritað yfir í eigin Secret kortsins. Breytið auðkenni og endurræsið podana sem nota það; það þarf ekkert að teikna upp (render) aftur.

Hver geymsla leitar að föstum lyklanöfnum í sínu Secret:

Gagnageymsla Lyklar í hennar Secret
PostgreSQL username og password fyrir ofurnotanda (superuser) á þeim netþjóni, og ca.crt, vottunarstöðina (CA) sem undirritaði skilríki netþjónsins
Valkey password
Neo4j username og password
Qdrant api-key
Hlutageymsla access-key og secret-key

Hlaðið hverju gildi inn úr skrá, svo það haldist utan skipanaferils skeljarinnar (shell history) og utan gildisskrárinnar ykkar:

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

Ytri geymsla þar sem ekkert Secret er nefnt stöðvar útteikninguna (render), nákvæmlega eins og geymsla án hýsils.

PostgreSQL

Ytri netþjónninn verður að bjóða upp á það sama og útgáfumyndin býður upp á: PostgreSQL 16 með PostGIS 3 og pgvector. Umferð til hans er alltaf dulkóðuð og sannreynd gegn ca.crt í ykkar Secret. Stillið sslmode á verify-full, sem athugar einnig hvort skilríki netþjónsins tilgreini hýsilinn sem þið gáfuð upp, eða á verify-ca. Með ytri netþjóni hafnar útteikningin disable og require. Postgres innan þyrpingar er andstæðan: umferð hans fer aldrei út fyrir nafnrýmið, netreglan heldur henni þar og hann tekur aðeins disable. Hvorn haminn sem þið veljið verður skilríkið að tilgreina hýsilinn í external.host, vegna þess að sumar þjónusturnar athuga nafnið við hverja tengingu.

Við uppsetningu tengist ræsiverk (bootstrap Job) netþjóninum með aðganginum í ykkar Secret og býr til hlutverkin (roles) sem Nexus keyrir sem. Það býr til migrator-hlutverk sem á skemað, keyrsluhlutverk (runtime role) og eitt innskráningarhlutverk fyrir hverja þjónustu. Nexus býr til lykilorð þeirra og geymir þau. Ekkert þeirra er ofurnotandi (superuser) og ekkert getur farið fram hjá öryggi á línustigi (row-level security), þannig að allar einangrunarreglur í gagnagrunninum gilda um allar þjónustur. Ræsiverkið sjálft þarf hins vegar ofurnotanda: eitt af skrefum þess læsir innbyggðu PostgreSQL-falli og aðeins ofurnotandi má gera það. Aðeins ræsiverkið og frumstillingarskref stjórnborðsins nota þennan aðgang. Stýrð gagnagrunnsþjónusta þar sem stjórnandahlutverkið er ekki raunverulegur ofurnotandi getur af þeim sökum ekki hýst Nexus-gagnagrunninn.

Verkið (Job) athugar netþjóninn ykkar áður en það snertir við honum. Það stöðvast, án þess að hafa breytt neinu, ef aðgangurinn í ykkar Secret er ekki ofurnotandi. Ef hlutverk sem heitir nexus er þegar til með SUPERUSER eða BYPASSRLS, stöðvast verkið með 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. Fjarlægið þessa eiginleika af því hlutverki, eða notið netþjón þar sem nafnið er laust, og setjið upp aftur.

Valkey, Neo4j, Qdrant og hlutageymslan

Hinar fjórar taka sömu þrjár stillingarnar: mode, external.host og external.existingSecret. Hér eru þær allar fjórar færðar yfir á eigin geymslur 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 }

Keyrið þær útgáfur sem útgáfumyndirnar innihalda, sem taldar eru upp í töflunni hér að ofan, á þeim gáttum sem þjónusturnar nota. Valkey hlustar á 6379 og Neo4j á 7687; Qdrant tekur 6333 og hlutageymslan 8333. Hlutageymslan verður að vera S3-samhæf. Lykilorð Valkey fer inn í tengivisfang inni í hverjum pod, svo haldið því við bókstafi og tölustafi (stafirnir -._~ eru líka í lagi).

Ef mode er external og external.host er tómt, stöðvast útteikningin með dataTier.<store>.external.host is required when mode is external. Að færa geymslu úr þyrpingunni yfir í ytri geymslu eftir að fólk hefur tekið Nexus í notkun er gagnaflutningur sem þið sjáið um sjálf og kortið mun ekki afrita neitt fyrir ykkur. Ákveðið þetta fyrir fyrstu uppsetningu.

Lyklageymslan, OpenBao, er ekki á þessum lista og getur ekki verið ytri. Hún er hluti af auðkenni uppsetningarinnar og keyrir í þyrpingunni í hverri uppsetningu.

TLS á ytri jaðrinum

tls.mode ræður því hvernig opinberu hýslarnir þrír fá skilríki sín, og engu öðru. Umferð milli þjónusta notar alltaf gagnkvæmt TLS (mutual TLS) með skilríkjum frá eigin staðbundinni vottunarstöð (CA) kortsins, útgefnum af cert-manager, óháð haminum. Það er ekkert þjónustunet (service mesh) og istio.enabled helst false.

tls.mode Hver býr til skilríkið Hvað þið verðið að stilla
existing (sjálfgefið) Þið. Eitt Secret geymir skilríki fyrir alla þrjá hýslana. tls.existingSecret
cert-manager ClusterIssuer sem þið keyrið nú þegar. Kortið biður hann um eitt skilríki fyrir hvern hýsil. tls.clusterIssuer
none Enginn í þyrpingunni. TLS endar fyrir framan hana, á álagsjafnara (load balancer) eða milliþjóni (proxy). Ekkert, en lesið viðvörunina hér að neðan

existing

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

Hvert Ingress þjónustar Secret-ið harrow-public-tls, þannig að skilríki þess verður að nefna console.harrow.example, api.harrow.example og auth.harrow.example. Búið það til í nafnrýminu áður en þið setjið upp:

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

Forathugun (preflight) les það, varar við þegar það rennur út innan 30 daga og nefnir Secret-ið þegar það vantar. Þegar hamurinn er existing og nafnið er tómt, stöðvast útteikningin með 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

Kortið bætir skýringunni (annotation) cert-manager.io/cluster-issuer við hvert af Ingress-unum þremur og cert-manager býr til Secret-in nexus-console-tls, nexus-api-tls og nexus-auth-tls. Án tls.clusterIssuer stöðvast útteikningin með tls.clusterIssuer is required when tls.mode is cert-manager.

Ef útgefandinn ykkar notar ACME (Automatic Certificate Management Environment) með HTTP-01 áskoruninni þarf ekkert annað. Kortið bætir engri eigin áframsendingu (redirect) við, þannig að beiðni um /.well-known/acme-challenge/ berst óbreytt til leysara (solver) útgefandans. Á stað án internetsambands er leysarinn líka mynd (image): setjið cert-manager-acmesolver mynd cert-manager í myndasafnið (registry) ykkar, annars bíður hver áskorunarpod í ErrImagePull.

ekkert

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

Með none bera Ingress-in engan TLS-hluta. Notið það þegar álagsjafnari eða öfugur milliþjónn (reverse proxy) fyrir framan þyrpinguna endar TLS fyrir hýslana þrjá.

proxy.trustedCIDRs tilgreinir þau milliþjónahopp (proxy hops) sem nexus-auth treystir X-Forwarded-For hausnum frá. Sjálfgefna gildið, 10.42.0.0/16, er pod-net k3s, þar sem ingress-stýring þess keyrir. Á öllum öðrum þyrpingum skuluð þið stilla það á netið sem podar ingress-stýringarinnar ykkar nota, svo að fjöldatakmarkanir innskráninga og endurskoðunarskrár (audit records) sjái vistfang notandans en ekki milliþjónsins.

Vistfang, skilríki, milliþjónn og póstur
Vistfang, skilríki, milliþjónn og póstur
Eftir uppsetningu hafa vistfang, skilríki, milliþjónn og póstur hvert sitt próf á einni síðu og niðurstaðan er skrifuð með orðum.

Stýringar fyrir inngangsumferð

Kortið býr til þrjú einföld Kubernetes Ingress, eitt fyrir hvern opinberan hýsil. Hvert þeirra beinir slóðinni / á eitt Service.

Ingress Hýsill Service og gátt
nexus-console hosts.console nexus-alpha, 3000
nexus-api hosts.api nexus-gateway, 9092
nexus-auth hosts.auth nexus-auth, 9101

Þrjú gildi móta þau og eitt gildi í netreglunni verður að stemma við þau.

# harrow-ingress.yaml (Helm values)
ingress:
  enabled: true
  className: harrow-nginx
  annotations:
    "<annotation-key>": "<annotation-value>"
networkPolicy:
  ingressNamespace: ingress-harrow
  • ingress.className nefnir IngressClass. Sé það skilið eftir tómt sleppir kortið flokknum og sjálfgefinn flokkur þyrpingarinnar tekur við Ingress-unum þremur. Forathugun (preflight) athugar hvort flokkurinn sé til eða, þegar þið nefnduð engan, hvort nákvæmlega einn flokkur sé merktur sem sjálfgefinn.
  • ingress.annotations er bætt við öll þrjú Ingress-in. Gildin eru strengir, svo setjið tölur og boole-gildi innan gæsalappa. Notið þetta fyrir eigin stillingar stýringarinnar ykkar.
  • ingress.enabled: false teiknar ekkert Ingress upp, fyrir staði sem beina umferð á þjónusturnar (Services) þrjár á einhvern annan hátt.
  • networkPolicy.ingressNamespace er nafnrýmið sem ingress-stýringin ykkar keyrir í.

Þetta síðastnefnda kemur fólki oft í opna skjöldu. Netregla kortsins hafnar sjálfgefið allri umferð inn í nafnrýmið og hleypir síðan ingress-stýringunni aðeins að opinberu þjónustunum (Services) þremur úr nafnrýminu sem þið tilgreinið. Sjálfgefna gildið, kube-system, er rétt fyrir k3s, sem keyrir Traefik þar. Með hvaða annarri stýringu sem er, ef þetta er látið óbreytt, nær stýringin ekki til Nexus: Ingress-in eru til, stýringin skráir tímatakmarkanir á tengingum (connection timeouts) og vafrinn fær gáttarvillu (gateway error). „Ingress ports“ athugun forathugunarinnar (preflight) leitar að Service í því nafnrými sem er opið á gáttum 80 og 443, sem LoadBalancer eða NodePort, og fix lína hennar nefnir þetta gildi.

Vinstra megin situr kassi „ingress controller“ innan brotinnar útlínu sem merkt er „namespace: networkPolicy.ingressNamespace (kube-system on k3s)“. Þrjár örvar liggja út frá honum, merktar console.harrow.example, api.harrow.example og auth.harrow.example. Þær fara yfir heila línu sem merkt er „nexus namespace: default deny“ og enda á þremur kössum: „nexus-alpha :3000“, „nexus-gateway :9092“ og „nexus-auth :9101“. Fjórða, gráa örin frá kassa „any other namespace“ stöðvast við heilu línuna með litlum krossi.
Opinberu hýslarnir þrír, nafnrými ingress-stýringarinnar og netreglan sem hleypir aðeins því nafnrými inn.

Restin af netreglunni

networkPolicy.enabled er true sjálfgefið og ætti að haldast þannig. Með því nær ekkert í nafnrýminu út fyrir það nema DNS (Domain Name System), Kubernetes API (application programming interface) fyrir tókasannreynana (token reviewers) og vistföngin sem þið teljið upp.

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

apiServerCIDRs er vistfang API-netþjónsins sem /32 CIDR-blokkir (Classless Inter-Domain Routing). Sé það tómt les kortið það úr þyrpingunni við uppsetningu. helm template hefur enga þyrpingu til að lesa úr, svo gefið það upp þar. externalEgressCIDRs er allt annað sem vinnuálag (workload) má ná til, tómt sjálfgefið. Harrow telur upp póstendurvarpa (mail relay) sinn. Allar ytri gagnageymslur utan nafnrýmisins verða líka að vera taldar upp hér, annars stöðvar sjálfgefna höfnunarreglan þjónusturnar í að ná til þeirra.

Aðeins þrjú vinnuálög (workloads) tala nokkurn tímann við API-netþjóninn: sönnunarþjónustan nexus-probitas, samhæfarinn (orchestrator) og vörsluverk (custody Job) lyklageymslunnar. Þau sannreyna þjónustuaðgangstókana (service-account tokens) sem önnur vinnuálög framvísa. Reglan gefur þessum þremur vistfang API-netþjónsins, á gáttum 6443 og 443, og engu öðru. Ef þessi þrjú ná ekki til hans geta þau ekki sannreynt tókana sem önnur vinnuálög framvísa, svo gefið upp öll vistföng sem hann getur haft.

Val á TLS-ham

Harrow valdi cert-manager með innri vottunarstöð (CA) sinni sem ClusterIssuer, og ástæðan var endurnýjun. Með existing endurnýjar manneskja skilríkið í Secret-inu áður en það rennur út og 30 daga viðvörun forathugunarinnar (preflight) er eina áminningin. Með cert-manager gerist endurnýjun sjálfkrafa og enginn þarf að muna eftir henni. none hentar stað þar sem öll opinber vistföng sitja þegar á bak við álagsjafnara sem endar TLS fyrir mörg kerfi, og þar sem það teymi á skilríkin. Hvað sem þið veljið verður skilríkið sem vafri sér að vera skilríki sem vafrinn treystir. Sjálfundirritað skilríki sem fólk smellir sér í gegnum eyðileggur aðgangslykla (passkeys), vegna þess að Chrome býr hvorki til né notar aðgangslykil á bak við skilríkjaviðvörun.

Geymsla, póstur, eftirmyndir og tilföng

Geymsluflokkur (storage class)

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

storage.className gildir um allar PVC-kröfur (persistent volume claim) gagnalagsins og um gagnasvæði (volumes) lyklageymslunnar. Tómt þýðir sjálfgefinn flokk þyrpingarinnar, og forathugun (preflight) fellur þegar enginn flokkur er merktur sjálfgefinn og þið nefnduð engan. Hver geymsla innan þyrpingar hefur sitt eigið size. Fyrir lyklageymsluna eru það keys.openbao.storage.unsealer og keys.openbao.storage.keystore, ásamt keys.receiptsStorage fyrir kvittanir. Veljið stærðir sem duga fyrir eins árs vöxt.

Póstur

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

Nexus sendir boð og tilkynningar í gegnum póstþjóninn ykkar. smtp.existingSecret nefnir Secret sem þið búið til, í nafnrýminu, með upplýsingum um póstþjóninn. Líkt og með allar samþættingar tekur kortið nafn á Secret en aldrei auðkenni. Munið eftir netreglunni: bætið vistfangi póstendurvarpans við networkPolicy.externalEgressCIDRs, annars stöðvast póstur við mörk nafnrýmisins. Þangað til póstur virkar er ekki hægt að senda boð og gátlisti fyrsta kerfisstjórans tekur það fram.

Eintök og tilföng

Hver kjarnaeining hefur fjölda eintaka (replica count) og Kubernetes-tilföng (resources) undir components, og hver geymsla innan þyrpingar hefur tilföng undir 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 } }

Sjálfgefni Neo4j-podinn biður um 2 GiB og má nota allt að 4 GiB. Með 3 GB af kös (heap) og síðuskyndiminni (page cache) skuluð þið hækka beiðni hans líka, svo podinn sé settur á hnút (node) sem hefur minnið.

Einingarnar með replicas og resources eru console, bff, auth, orchestrator, workflows, gateway, graphrag, probitas og skillsEngine. Lyklaþjónustan, keys, tekur aðeins resources. Þessar kjarnaeiningar eru nauðsynlegar og ekki er hægt að slökkva á þeim; kortið keyrir þær óháð því hvað enabled rofi þeirra segir. Geymslur gagnalagsins keyra eitt eintak (replica) hver.

Á hægvirkri geymslu gefa tvö gildi til viðbótar þjónustum tíma til að ræsast: probes.startupFailureThreshold (60 sjálfgefið) og schemaWait.timeoutSeconds (1800), hversu lengi þjónusta bíður eftir uppfærslum á gagnagrunni sínum (database migrations) áður en ræsigámur (start-up container) hennar fellur á nafni.

Innskráningarlotur, tíðnimörk og einkahýsingar líkana

Þrjá minni hópa gilda er gott að þekkja fyrir uppsetninguna, vegna þess að fólk tekur eftir þeim á fyrsta degi.

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

auth.accessTokenTTL og auth.refreshTokenTTL segja til um hversu lengi tókar lotu (session) gilda. Sjálfgefnu gildin, 15 mínútur og 12 klukkustundir, þýða að manneskja sem lokar fartölvunni á kvöldin skráir sig inn aftur að morgni. Styttið endurnýjunartókann (refresh token) ef reglur ykkar krefjast þess og búist þá við fleiri innskráningum.

auth.rateLimitPerMinute er hámarksfjöldi beiðna sem einn innskráður notandi má senda á innskráningarþjónustuna á einni mínútu áður en hún svarar með 429. Sjálfgefna gildið, 5000, er um 83 á sekúndu frá einum aðgangi, sem er yfirdrifið nóg fyrir stjórnborðið og fyrir skriftur. Uppsetning hefur engar áskriftarleiðir, þannig að allir fá sömu mörk. Lækkið þau til að herða vörn gegn misnotkun, eða hækkið þau fyrir mikla sjálfvirkni. Vörn gegn tæmandi innskráningartilraunum (brute-force), svo sem læsing aðgangs og takmarkanir á tilraunum við tvíþætta auðkenningu, er aðskilin og ekki stillt hér.

ai.installationHosts telur upp auka hýsilnöfn innan uppsetningarinnar, fyrir eigin netþjóna fyrirtækisins fyrir gervigreindarlíkön (AI – artificial intelligence) á einkanöfnum. Hver færsla er hýsilnafn, .suffix sem passar við öll nöfn undir því, IP-tala eða IPv4 CIDR-blokk (Classless Inter-Domain Routing). Beinirinn (router) meðhöndlar þau sem hluta af uppsetningunni við hlið eigin hýsla útgáfunnar. Líkanaþjónninn sjálfur er nefndur í ai.localProvider.baseUrl; kafli 2.14, Gervigreindarveitur og líkön, fjallar um hvort tveggja.

Hvað er aldrei gildi

Sumt af því sem fólk leitar að í gildisskrá er ekki þar, af ásettu ráði.

Ekki í gildisskránni Hvers vegna, og hvar það er í staðinn
Leyfið Það er flutt inn eftir uppsetninguna, í stjórnborðinu eða með nexusctl licence import <file>. Leyfi er aldrei gildi í korti eða tengd skrá (mounted file). Kafli 2.13, Leyfi, inniheldur nánari upplýsingar.
Líkanalyklar Hvert fyrirtæki geymir sína eigin lykla í sínum eigin brunni, sem slegnir eru inn í stjórnborðinu. Ekkert auðkenni gervigreindarveitu er nokkurn tímann gildi í korti.
Herðing nýskráningar Bæði internet-CAPTCHA og netsíun nýskráninga eru óvirk í uppsetningu og það er ekkert gildi til að kveikja á hvorugu. CAPTCHA myndi þurfa internetsamband við hverja nýskráningu. Netsíunin myndi þurfa leyfisskyldan gagnagrunn yfir landfræðilega staðsetningu sem kortið inniheldur ekki. Nýskráningu ókunnugra er í staðinn haldið eftir þar til kerfisstjóri samþykkir hana, eins og kafli 2.12, Fyrsta keyrslan, útskýrir.
Fjarmælingar (Telemetry) Skemað tekur við einni stillingu fyrir telemetry.enabled, sem er false. Ekkert fer út úr uppsetningu og einnig er slökkt á eigin skýrslugjöf gagnalagsins (notkunarskýrslu Neo4j, fjarmælingum Qdrant).

Sannreyndu alla skrána áður en þú setur upp

Þegar brotin hafa verið sameinuð í eina skrá skuluð þið keyra tvær athuganir á hana af vinnustöðinni ykkar. helm lint --strict sannreynir hvern lykil gegn skema kortsins og helm template teiknar upp (renders) alla útgáfuna svo þið getið lesið hana áður en nokkuð er búið til. Skipanirnar nota vistfang Community-kortsins; fyrir Enterprise skuluð þið gefa upp slóðina að Enterprise-kortinu sem þið sóttuð í staðinn (kafli 2.7, Uppsetning Enterprise og virkjun leyfis). Útteikning á vinnustöðinni ykkar getur ekki lesið vistfang API-netþjónsins úr þyrpingu, svo stillið networkPolicy.apiServerCIDRs í skránni fyrst.

Athuganirnar tvær:

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

Rangt stafsettur lykill fellir villuleitina (lint) með „additional properties“ og nefnir lykilinn. Nauðsynlegt gildi sem vantar, svo sem hýsill þegar geymsla er ytri, fellir útteikninguna með setningunni sem vitnað er til í þessum kafla. helm template hefur enga þyrpingu til að lesa úr, svo gefið upp networkPolicy.apiServerCIDRs þegar þið teiknið upp án nettengingar, annars stöðvast hún og biður um þau.

Keyrið síðan forathugun (preflight) með sömu skrá. Forathugun er eina athugunin sem les þyrpinguna og gildin saman: þar kemur rangt ingress-nafnrými, geymsluflokkur sem vantar eða skilríki sem rennur út í næstu viku í ljós áður en nokkur treystir á uppsetninguna.

Stýrt Kubernetes

Nexus keyrir á hvaða samhæfðu Kubernetes 1.33 eða nýrra sem er, þar á meðal stýrðri þjónustu skýjaveitu. Ekkert í kortinu er sértækt fyrir eina veitu. Það sem breytist frá k3s eru nokkur gildi, sem öll er fjallað um hér að ofan:

  • cert-manager v1.21.3 er sett upp fyrst, líkt og á öllum þyrpingum. | Á stýrðri þyrpingu | Hvað á að stilla eða athuga | |---|---| | Geymsla | Nefnið flokk veitunnar í storage.className, eða merkið einn sem sjálfgefinn. | | Ingress | Setjið upp ingress-stýringuna sem þið notið, opnið hana á gáttum 80 og 443, stillið ingress.className ef hún er ekki sú sjálfgefna og stillið networkPolicy.ingressNamespace á nafnrými hennar. | | Milliþjónahoppin | Stillið proxy.trustedCIDRs á pod-net þeirrar stýringar. | | API-netþjónninn | Ef uppsetningin getur ekki lesið vistfang API-netþjónsins úr þyrpingunni skuluð þið gefa það upp í networkPolicy.apiServerCIDRs. | | Framfylgd netreglna | Reglur kortsins taka aðeins gildi þar sem netviðbót (network plugin) þyrpingarinnar framfylgir NetworkPolicy. Veljið þyrpingaruppsetningu sem gerir það. | | Myndir (Images) | Hnútarnir þurfa að ná til registry.adverant.ai, eða ykkar eigin myndasafns (registry) sem nefnt er í global.imageRegistry. |

Keyrið forathugun (preflight) áður en nokkuð annað er gert. Hún les þyrpinguna og gildisskrána saman og prentar hvert þessara atriða sem línu, með lagfæringunni við hlið hvers þess sem vantar. Kafli 2.5, Forathugun með nexusctl, sýnir skýrsluna.

Áður en þú setur upp
Áður en þú setur upp
Staðin forathugun á framleiðsluþyrpingu. Hver lína er ein krafa og hver viðvörun ber lagfæringu sína í línunni fyrir neðan.