HyniRezervoni një prezantim

Kapitulli 2.11

Variacionet: ruajtëset e jashtme, TLS dhe ingress

Vlerat që e përshtatin Nexus me një klaster që nuk është bosh, përfshirë TLS (Transport Layer Security), së bashku me bazat e të dhënave që tashmë i përdorni, certifikatat tuaja, një tjetër kontrollues ingress, klasat e ruajtjes, postën, proksit, replikat dhe Kubernetes të menaxhuar.

Kjo faqe u përkthye nga AI prej origjinalit në anglisht. Nëse diçka është e paqartë, faqja në anglisht shërben si referencë. Lexoni këtë faqe në anglisht

17 minuta lexim

Klasteri i prodhimit i Harrow Port Authority nuk është bosh, dhe vetëm historia e tij e TLS (Transport Layer Security) ka tre pjesë. Ekipi i bazave të të dhënave ekzekuton PostgreSQL në makinat e veta dhe dëshiron çdo bazë të dhënash atje, me kopje rezervë sipas mënyrës së tyre. Certifikatat vijnë nga CA (autoriteti i certifikatave) i brendshëm i Harrow përmes cert-manager. Kontrolluesi i hyrjes (ingress) nuk është Traefik, dhe ndodhet në hapësirën e vet të emrave (namespace). Asnjë nga këto nuk ka nevojë për një degëzim (fork) të chart-it. Çdo ndryshim është një vlerë, dhe ky kapitull i shqyrton ato sipas rendit që i hasi Tomás Reilly.

Çdo bllok vlerash në këtë kapitull është një fragment. Bashkoni ato që ju nevojiten në skedarin tuaj të vlerave, krahas global, hosts, edition dhe keys nga kapitulli 2.6, Instalimi i Community në Kubernetes. Skema e chart-it refuzon çdo çelës që nuk e njeh, kështu që një çelës i shkruar gabim dështon në helm lint --strict dhe në instalim në vend që të injorohet. Kjo është e qëllimshme: një gabim shtypi në dataTier që do të linte në heshtje një depo në klaster do të ishte më keq se një gabim.

Ruajtëset e jashtme të të dhënave

Nexus i mban të dhënat e tij në pesë depo. Si parazgjedhje, secila ekzekutohet brenda klasterit nga imazhi i nënshkruar i vetë lëshimit (release), me vëllimin e vet.

Depoja Çelësi i vlerave Parazgjedhja brenda klasterit Vëllimi i parazgjedhur
PostgreSQL 16 me PostGIS 3 dhe pgvector 0.8 dataTier.postgres imazhi i lëshimit 50Gi
Valkey 8.1 dataTier.valkey imazhi i lëshimit 5Gi
Neo4j 5.26 Community Edition dataTier.neo4j imazhi i lëshimit 20Gi
Qdrant 1.15 dataTier.qdrant imazhi i lëshimit 10Gi
SeaweedFS 4.48, depoja e objekteve e përputhshme me Amazon S3 (Simple Storage Service) dataTier.objectStore imazhi i lëshimit 50Gi

Secila prej tyre mund të jetë një që e ekzekutoni ju në vend të saj. Vendoseni mode e saj në external, jepni strehuesin (host) e saj dhe emërtoni një Secret që mban kredencialet e saj. Shtoni gjithashtu adresën e depos te networkPolicy.externalEgressCIDRs (shihni seksionin e politikës së rrjetit më poshtë), sepse hapësira e emrave mohon çdo dalje (egress) tjetër. Për një depo të jashtme, chart-i nuk gjeneron asgjë për atë depo: asnjë StatefulSet, asnjë Service dhe asnjë vëllim. Shërbimet lidhen me strehuesin që dhatë.

# 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

Secret krijohet nga ju, në hapësirën e emrave ku instalohet Nexus, përpara instalimit. Chart-i mban vetëm emrin e tij: pod-et që kanë nevojë për një kredencial e lexojnë atë nga Secret juaj kur nisen, dhe asgjë nuk kopjohet në Secret-et e vetë chart-it. Ndryshoni një kredencial dhe rinisni pod-et që e përdorin atë; nuk ka asgjë për të gjeneruar përsëri.

Çdo depo kërkon emra fiks çelësash në Secret e vet:

Depoja Çelësat në Secret e vet
PostgreSQL username dhe password për një superpërdorues në atë server, dhe ca.crt, autoriteti i certifikatave (CA) që nënshkroi certifikatën e serverit
Valkey password
Neo4j username dhe password
Qdrant api-key
Depoja e objekteve access-key dhe secret-key

Ngarkoni çdo vlerë nga një skedar, në mënyrë që të mbetet jashtë historikut të shell-it tuaj dhe jashtë skedarit tuaj të vlerave:

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

Një depo e jashtme pa një Secret të emërtuar e ndalon gjenerimin, njëlloj si një depo pa strehues.

PostgreSQL

Serveri i jashtëm duhet të ofrojë atë që ofron imazhi i lëshimit: PostgreSQL 16 me PostGIS 3 dhe pgvector. Trafiku drejt tij është gjithmonë i enkriptuar dhe kontrollohet kundrejt ca.crt në Secret tuaj. Vendoseni sslmode në verify-full, i cili gjithashtu kontrollon që certifikata e serverit emërton strehuesin që dhatë, ose në verify-ca. Me një server të jashtëm, gjenerimi refuzon disable dhe require. Postgres brenda klasterit është e kundërta: trafiku i tij nuk del kurrë nga hapësira e emrave, politika e rrjetit e mban atje dhe pranon vetëm disable. Cilëndo mënyrë të zgjidhni, certifikata duhet të emërtojë strehuesin në external.host, sepse disa nga shërbimet e kontrollojnë emrin në çdo lidhje.

Gjatë instalimit, një Job fillestar (bootstrap) lidhet me serverin me llogarinë në Secret tuaj dhe krijon rolet me të cilat ekzekutohet Nexus. Ai krijon një rol migratori që zotëron skemën, një rol ekzekutimi (runtime) dhe një rol identifikimi për çdo shërbim. Nexus gjeneron fjalëkalimet e tyre dhe i ruan ato. Asnjë prej tyre nuk është superpërdorues dhe asnjë nuk mund të anashkalojë sigurinë në nivel rreshti, kështu që çdo politikë izolimi në bazën e të dhënave zbatohet për çdo shërbim. Vetë procesi fillestar (bootstrap) ka nevojë për një superpërdorues: një nga hapat e tij bllokon një funksion të integruar të PostgreSQL, dhe vetëm një superpërdorues mund ta bëjë këtë. Vetëm procesi fillestar dhe hapi i provizionimit të vetë konsolës e përdorin llogarinë. Një shërbim i menaxhuar i bazës së të dhënave, roli i administratorit i të cilit nuk është një superpërdorues i vërtetë, nuk mund të strehojë bazën e të dhënave të Nexus për këtë arsye.

Job kontrollon serverin tuaj përpara se ta prekë atë. Ai ndalon, pa ndryshuar asgjë, nëse llogaria në Secret tuaj nuk është superpërdorues. Nëse një rol i quajtur nexus ekziston tashmë me SUPERUSER ose BYPASSRLS, Job ndalon 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. Hiqni ato atribute nga ai rol, ose përdorni një server ku emri është i lirë, dhe instaloni përsëri.

Valkey, Neo4j, Qdrant dhe depoja e objekteve

Katër të tjerat marrin të njëjtat tre cilësime: mode, external.host dhe external.existingSecret. Ja ku janë të katërta të kaluara në ato të vetë 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 }

Ekzekutoni versionet që mbajnë imazhet e lëshimit, të renditura në tabelën më sipër, në portat që përdorin shërbimet. Valkey dëgjon në 6379 dhe Neo4j në 7687; Qdrant merr 6333 dhe depoja e objekteve 8333. Depoja e objekteve duhet të jetë e përputhshme me S3. Fjalëkalimi i Valkey shkon në një adresë lidhjeje brenda çdo pod-i, kështu që mbajeni me shkronja dhe shifra (karakteret -._~ janë gjithashtu në rregull).

Nëse mode është external dhe external.host është bosh, gjenerimi ndalon me dataTier.<store>.external.host is required when mode is external. Zhvendosja e një depoje nga brenda klasterit në të jashtme pasi njerëzit kanë përdorur Nexus është një migrim të dhënash që e bëni vetë, dhe chart-i nuk do të kopjojë asgjë për ju. Vendosni përpara instalimit të parë.

Depoja e çelësave, OpenBao, nuk është në këtë listë dhe nuk mund të jetë e jashtme. Ajo është pjesë e identitetit të instalimit dhe ekzekutohet në klaster në çdo instalim.

TLS në skajin publik

tls.mode vendos se si tre strehuesit publikë marrin certifikatat e tyre, dhe asgjë më shumë. Trafiku midis shërbimeve përdor gjithmonë TLS të ndërsjellë me certifikata nga CA lokale e vetë chart-it, të lëshuara nga cert-manager, pavarësisht mënyrës. Nuk ka rrjetë shërbimesh (service mesh), dhe istio.enabled mbetet false.

tls.mode Kush e bën certifikatën Çfarë duhet të vendosni
existing (parazgjedhja) Ju. Një Secret mban një certifikatë për të tre strehuesit. tls.existingSecret
cert-manager Një ClusterIssuer që ju tashmë e ekzekutoni. Chart-i i kërkon atij një certifikatë për strehues. tls.clusterIssuer
none Askush në klaster. TLS përfundon përpara tij, te balancuesi i ngarkesës (load balancer) ose proxy juaj. Asgjë, por lexoni paralajmërimin më poshtë

existing

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

Çdo Ingress shërben Secret-in harrow-public-tls, kështu që certifikata e tij duhet të emërtojë console.harrow.example, api.harrow.example dhe auth.harrow.example. Krijojeni atë në hapësirën e emrave përpara se të instaloni:

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

Kontrolli paraprak (preflight) e lexon atë, paralajmëron kur skadon brenda 30 ditëve dhe emërton Secret-in kur ai mungon. Kur mënyra është existing dhe emri është bosh, gjenerimi ndalon 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

Chart-i shton shënimin (annotation) cert-manager.io/cluster-issuer në secilin prej tre Ingress-eve, dhe cert-manager krijon Secret-et nexus-console-tls, nexus-api-tls dhe nexus-auth-tls. Pa tls.clusterIssuer gjenerimi ndalon me tls.clusterIssuer is required when tls.mode is cert-manager.

Nëse lëshuesi juaj përdor ACME (Automatic Certificate Management Environment) me sfidën HTTP-01, nuk nevojitet asgjë tjetër. Chart-i nuk shton asnjë ridrejtim të vetin, kështu që një kërkesë për /.well-known/acme-challenge/ arrin te zgjidhësi i lëshuesit tuaj e pandryshuar. Në një vend pa internet, zgjidhësi është gjithashtu një imazh: vendosni imazhin cert-manager-acmesolver të cert-manager në regjistrin tuaj, përndryshe çdo pod sfide pret në ErrImagePull.

asnjë

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

Me none, Ingress-et nuk mbajnë asnjë seksion TLS. Përdoreni kur një balancues ngarkese ose reverse proxy përpara klasterit përfundon TLS për tre strehuesit.

proxy.trustedCIDRs emërton hapat e proxy-t (proxy hops), kokës (header) X-Forwarded-For të të cilëve i beson nexus-auth. Parazgjedhja, 10.42.0.0/16, është rrjeti i pod-eve të k3s, ku ekzekutohet kontrolluesi i tij i hyrjes. Në çdo klaster tjetër, vendoseni në rrjetin që përdorin pod-et e kontrolluesit tuaj të hyrjes, në mënyrë që kufijtë e shpejtësisë së identifikimit dhe regjistrimet e auditimit të shohin adresën e personit dhe jo të proxy-t.

Adresa, certifikata, proxy dhe posta
Adresa, certifikata, proxy dhe posta
Pasi të instalohen, adresa, certifikata, proxy dhe posta kanë secila testin e vet në një faqe, dhe rezultati shkruhet me fjalë.

Kontrolluesit ingress

Chart-i krijon tre Ingress-e të thjeshta të Kubernetes, një për çdo strehues publik. Secili drejton shtegun / te një Service.

Ingress Strehuesi Shërbimi dhe porta
nexus-console hosts.console nexus-alpha, 3000
nexus-api hosts.api nexus-gateway, 9092
nexus-auth hosts.auth nexus-auth, 9101

Tre vlera u japin formë atyre, dhe një vlerë në politikën e rrjetit duhet të përputhet.

# harrow-ingress.yaml (Helm values)
ingress:
  enabled: true
  className: harrow-nginx
  annotations:
    "<annotation-key>": "<annotation-value>"
networkPolicy:
  ingressNamespace: ingress-harrow
  • ingress.className emërton IngressClass. E lënë bosh, chart-i e lë klasën jashtë dhe klasa e parazgjedhur e klasterit merr tre Ingress-et. Kontrolli paraprak (preflight) kontrollon që klasa ekziston ose, kur nuk keni emërtuar asnjë, që saktësisht një klasë është e shënuar si e parazgjedhur.
  • ingress.annotations u shtohet të tre Ingress-eve. Vlerat janë vargje (strings), prandaj vendosni në thonjëza numrat dhe vlerat booleane. Përdoreni atë për cilësimet e vetë kontrolluesit tuaj.
  • ingress.enabled: false nuk gjeneron asnjë Ingress fare, për një vend që drejton te tre Service-et në një mënyrë tjetër.
  • networkPolicy.ingressNamespace është hapësira e emrave ku ekzekutohet kontrolluesi juaj i hyrjes.

Kjo e fundit i zë njerëzit në befasi. Politika e rrjetit e chart-it mohon të gjithë trafikun në hapësirën e emrave si parazgjedhje dhe më pas pranon kontrolluesin e hyrjes në tre Service-et publike vetëm nga hapësira e emrave që ju emërtoni. Parazgjedhja, kube-system, është e duhura për k3s, i cili ekzekuton Traefik atje. Me çdo kontrollues tjetër, lëreni të pandryshuar dhe kontrolluesi nuk mund të arrijë Nexus: Ingress-et ekzistojnë, kontrolluesi regjistron skadime kohe të lidhjes (connection timeouts) dhe shfletuesi merr një gabim gateway. Kontrolli "Ingress ports" i kontrollit paraprak kërkon një Service në atë hapësirë emrash të hapur në portat 80 dhe 443, si një LoadBalancer ose një NodePort, dhe rreshti i tij fix emërton këtë vlerë.

Në të majtë, një kuti "ingress controller" qëndron brenda një kufiri me vija të ndërprera të etiketuar "namespace: networkPolicy.ingressNamespace (kube-system on k3s)". Tre shigjeta dalin prej saj, të etiketuara console.harrow.example, api.harrow.example dhe auth.harrow.example. Ato kalojnë një vijë të plotë të etiketuar "nexus namespace: default deny" dhe mbërrijnë në tre kuti: "nexus-alpha :3000", "nexus-gateway :9092" dhe "nexus-auth :9101". Një shigjetë e katërt, me ngjyrë gri, nga një kuti "any other namespace" ndalon te vija e plotë me një kryq të vogël.
Tre strehuesit publikë, hapësira e emrave e kontrolluesit të hyrjes dhe politika e rrjetit që pranon vetëm atë hapësirë emrash.

Pjesa tjetër e politikës së rrjetit

networkPolicy.enabled është true si parazgjedhje dhe duhet të mbetet kështu. Me të, asgjë në hapësirën e emrave nuk del jashtë përveç DNS (Domain Name System), API (application programming interface) të Kubernetes për rishikuesit e token-ave dhe adresave që ju renditni.

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

apiServerCIDRs është adresa e serverit API si CIDR (Classless Inter-Domain Routing) /32. Kur është bosh, chart-i e lexon atë nga klasteri gjatë instalimit. helm template nuk ka klaster për të lexuar, kështu që jepeni atje. externalEgressCIDRs është çdo gjë tjetër që një ngarkesë pune mund të arrijë, bosh si parazgjedhje. Harrow rendit rele-në e vet të postës. Çdo depo e jashtme e të dhënave jashtë hapësirës së emrave duhet të renditet gjithashtu këtu, përndryshe politika e mohimit si parazgjedhje ndalon shërbimet që ta arrijnë atë.

Vetëm tre ngarkesa pune flasin ndonjëherë me serverin API: shërbimi i provave nexus-probitas, orkestruesi dhe Job i kujdestarisë së depos së çelësave. Ato kontrollojnë token-at e llogarisë së shërbimit që paraqesin ngarkesat e tjera të punës. Politika ua jep adresën e serverit API, në portat 6443 dhe 443, atyre të treve dhe asgjëje tjetër. Nëse të tre nuk mund ta arrijnë atë, nuk mund të kontrollojnë token-at që paraqesin ngarkesat e tjera të punës, kështu që jepni çdo adresë që mund të ketë.

Zgjedhja e një mënyre TLS

Harrow zgjodhi cert-manager me CA e saj të brendshme si një ClusterIssuer, dhe arsyeja ishte rinovimi. Me existing, një person rinovon certifikatën në Secret përpara se të skadojë, dhe paralajmërimi 30-ditor i kontrollit paraprak është kujtesa e vetme. Me cert-manager, rinovimi ndodh vetë dhe askush nuk duhet të kujtohet. none i përshtatet një vendi ku çdo adresë publike ndodhet tashmë pas një balancuesi ngarkese që përfundon TLS për shumë sisteme, dhe ku ai ekip zotëron certifikatat. Cilëndo të zgjidhni, certifikata që sheh një shfletues duhet të jetë një që shfletuesi i beson. Një certifikatë e vetë-nënshkruar që njerëzit e kalojnë me klikim prish çelësat e kalimit (passkeys), sepse Chrome nuk do të krijojë ose përdorë një çelës kalimi pas një paralajmërimi certifikate.

Ruajtja, posta, si dhe replikat dhe burimet

Klasa e ruajtjes (Storage class)

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

storage.className zbatohet për çdo PVC (persistent volume claim) të shtresës së të dhënave dhe për vëllimet e depos së çelësave. Bosh do të thotë klasa e parazgjedhur e klasterit, dhe kontrolli paraprak dështon kur asnjë klasë nuk është e shënuar si e parazgjedhur dhe ju nuk keni emërtuar asnjë. Çdo depo brenda klasterit ka size e vet. Ato të depos së çelësave janë keys.openbao.storage.unsealer dhe keys.openbao.storage.keystore, me keys.receiptsStorage për faturat. Zgjidhni madhësi për rritjen e një viti.

Posta elektronike

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

Nexus dërgon ftesa dhe njoftime përmes serverit tuaj të postës. smtp.existingSecret emërton një Secret që ju krijoni, në hapësirën e emrave, me detajet e serverit të postës. Ashtu si me çdo integrim, chart-i merr emrin e një Secret-i dhe kurrë një kredencial. Mbani mend politikën e rrjetit: shtoni adresën e rele-së te networkPolicy.externalEgressCIDRs, përndryshe posta ndalon në kufirin e hapësirës së emrave. Derisa posta të funksionojë, ftesat nuk mund të dërgohen, dhe lista e kontrollit e administratorit të parë e thotë këtë.

Replikat dhe burimet

Çdo komponent bazë ka një numër replikash dhe burime të Kubernetes nën components, dhe çdo depo brenda klasterit ka burime nën 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 } }

Pod-i i parazgjedhur i Neo4j kërkon 2 GiB dhe mund të përdorë deri në 4 GiB. Me 3 GB heap dhe memorie të përkohshme të faqeve (page cache), rrisni gjithashtu kërkesën e tij, në mënyrë që pod-i të vendoset në një nyje që e ka memorien.

Komponentët me replicas dhe resources janë console, bff, auth, orchestrator, workflows, gateway, graphrag, probitas dhe skillsEngine. Shërbimi i çelësave, keys, pranon vetëm resources. Këta komponentë bazë janë të detyrueshëm dhe nuk mund të çaktivizohen; chart-i i ekzekuton ata pavarësisht se çfarë thotë çelësi i tyre enabled. Depot e shtresës së të dhënave ekzekutojnë nga një replikë secila.

Në ruajtje të ngadaltë, dy vlera të tjera u japin shërbimeve kohë për t'u nisur: probes.startupFailureThreshold (60 si parazgjedhje) dhe schemaWait.timeoutSeconds (1800), sa gjatë pret një shërbim për migrimet e bazës së tij të të dhënave përpara se kontejneri i tij i nisjes të dështojë sipas emrit.

Sesionet e identifikimit, kufijtë e shpejtësisë dhe strehuesit privatë të modeleve

Tre grupe më të vogla vlerash ia vlen të dihen përpara instalimit, sepse njerëzit i vënë re ato në ditën e parë.

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

auth.accessTokenTTL dhe auth.refreshTokenTTL tregojnë se sa zgjasin dy token-at e një sesioni. Parazgjedhjet, 15 minuta dhe 12 orë, do të thotë që një person i cili mbyll laptopin në mbrëmje identifikohet përsëri në mëngjes. Shkurtoni token-in e rifreskimit nëse politika juaj e kërkon këtë, dhe prisni më shumë identifikime.

auth.rateLimitPerMinute është numri më i madh i kërkesave që një person i identifikuar mund t'i bëjë shërbimit të identifikimit në një minutë përpara se ai të përgjigjet me 429. Parazgjedhja, 5000, është rreth 83 në sekondë nga një llogari, mjaftueshëm për konsolën dhe për skriptet. Një instalim nuk ka plane abonimi, kështu që çdo person merr të njëjtin kufi. Uleni atë për të shtrënguar mbrojtjen nga abuzimi, ose rriteni për automatizim të rëndë. Mbrojtja nga sulmet brute-force në identifikim, siç është bllokimi i llogarisë dhe kufijtë në përpjekjet e kontrollit të dytë, është e ndarë dhe nuk vendoset këtu.

ai.installationHosts rendit emra strehuesish shtesë brenda instalimit, për serverët e modeleve të AI (inteligjencës artificiale) të vetë organizatës në emra privatë. Çdo hyrje është një emër strehuesi, një .suffix që përputhet me çdo emër nën të, një adresë IP ose një bllok IPv4 CIDR (Classless Inter-Domain Routing). Ruteri i trajton ata si pjesë të instalimit krahas strehuesve të vetë lëshimit. Vetë serveri i modelit emërtohet në ai.localProvider.baseUrl; kapitulli 2.14, Ofruesit dhe modelet e AI, i mbulon të dyja.

Çfarë nuk është kurrë një vlerë

Disa gjëra që njerëzit kërkojnë në një skedar vlerash nuk janë atje, me qëllim.

Jo në skedarin e vlerave Pse, dhe ku ndodhet në vend të kësaj
Licenca Ajo importohet pas instalimit, në konsolë ose me nexusctl licence import <file>. Një licencë nuk është kurrë një vlerë chart-i ose një skedar i montuar. Kapitulli 2.13, Licencat, ka detajet.
Çelësat e modeleve Çdo organizatë mban çelësat e vet në grupin e vet, të vendosur në konsolë. Asnjë kredencial i ofruesit të AI nuk është kurrë një vlerë chart-i.
Forcimi i regjistrimit CAPTCHA e internetit dhe ekrani i rrjetit të regjistrimit janë të dyja të çaktivizuara në një instalim, dhe nuk ka asnjë vlerë për të aktivizuar asnjërën. CAPTCHA do të kishte nevojë për internetin në çdo regjistrim. Ekrani i rrjetit do të kishte nevojë për një bazë të dhënash gjeolokacioni të licencuar që chart-i nuk e mban. Regjistrimi i një të huaji mbahet në pritje për miratimin e një administratori në vend të kësaj, siç shpjegon kapitulli 2.12, Ekzekutimi i parë.
Telemetria Skema pranon një cilësim për telemetry.enabled, i cili është false. Asgjë nuk del nga një instalim, dhe raportimi i vetë shtresës së të dhënave (raporti i përdorimit të Neo4j, telemetria e Qdrant) është gjithashtu i çaktivizuar.

Kontrolloni të gjithë skedarin përpara se të instaloni

Me fragmentet e bashkuara në një skedar, ekzekutoni dy kontrolle mbi të nga stacioni juaj i punës. helm lint --strict vlerëson çdo çelës kundrejt skemës së chart-it, dhe helm template gjeneron të gjithë lëshimin që ju ta lexoni përpara se të bëhet diçka. Komandat përdorin adresën e chart-it Community; për Enterprise, jepni shtegun e chart-it Enterprise që shkarkuat në vend të tij (kapitulli 2.7, Instalimi i Enterprise dhe aplikimi i një licence). Një gjenerim në stacionin tuaj të punës nuk mund të lexojë adresën e serverit API nga një klaster, kështu që vendosni networkPolicy.apiServerCIDRs në skedar së pari.

Dy kontrollet:

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

Një çelës i shkruar gabim dështon në lint me "additional properties" dhe emërton çelësin. Një vlerë e detyrueshme që mungon, siç është një strehues kur një depo është e jashtme, dështon në gjenerim me fjalinë e cituar në këtë kapitull. helm template nuk ka klaster për të lexuar, kështu që jepni networkPolicy.apiServerCIDRs kur gjeneroni jashtë linje, përndryshe ai ndalon dhe i kërkon ato.

Më pas ekzekutoni kontrollin paraprak (preflight) me të njëjtin skedar. Kontrolli paraprak është i vetmi kontroll që lexon klasterin dhe vlerat së bashku: aty shfaqet një hapësirë emrash e gabuar e hyrjes, një klasë ruajtjeje që mungon ose një certifikatë që skadon javën tjetër, përpara se dikush të varet nga instalimi.

Kubernetes i menaxhuar

Nexus ekzekutohet në çdo Kubernetes 1.33 ose më të ri në përputhje me standardet, përfshirë shërbimin e menaxhuar të një ofruesi cloud. Asgjë në chart nuk është specifike për një ofrues. Ajo që ndryshon nga k3s është një grusht vlerash, secila e mbuluar më sipër:

  • cert-manager v1.21.3 instalohet i pari, si në çdo klaster. | Në një klaster të menaxhuar | Çfarë duhet të vendosni ose kontrolloni | |---|---| | Ruajtja | Emërtoni klasën e ofruesit në storage.className, ose shënoni një si të parazgjedhur. | | Ingress | Instaloni kontrolluesin e hyrjes që përdorni, ekspozoni atë në portat 80 dhe 443, vendosni ingress.className nëse nuk është i parazgjedhuri, dhe vendosni networkPolicy.ingressNamespace në hapësirën e tij të emrave. | | Hapat e proxy-t | Vendosni proxy.trustedCIDRs në rrjetin e pod-eve të atij kontrolluesi. | | Serveri API | Nëse instalimi nuk mund të lexojë adresën e serverit API nga klasteri, jepeni atë në networkPolicy.apiServerCIDRs. | | Zbatimi i politikës së rrjetit | Politikat e chart-it hyjnë në fuqi vetëm kur shtojca (plugin) e rrjetit të klasterit zbaton NetworkPolicy. Zgjidhni një konfigurim klasteri që e bën këtë. | | Imazhet | Nyjet duhet të arrijnë registry.adverant.ai, ose regjistrin tuaj të emërtuar në global.imageRegistry. |

Ekzekutoni kontrollin paraprak përpara çdo gjëje tjetër. Ai lexon klasterin dhe skedarin e vlerave së bashku dhe printon secilën prej tyre si një rresht, me rregullimin krahas çdo njërës që mungon. Kapitulli 2.5, Kontrolli paraprak me nexusctl, tregon raportin.

Përpara se të instaloni
Përpara se të instaloni
Një kontroll paraprak i kaluar me sukses në një klaster prodhimi. Çdo rresht është një kërkesë, dhe çdo paralajmërim mban rregullimin e vet në rreshtin më poshtë.