Versioni 1.0.0-alpha.1më i fundit
Kapitulli 2.3
Planifikimi i një instalimi
Çfarë i duhet një instalimi Kubernetes të Nexus para se të shkruani një komandë, sa i madh është ai dhe dy vendimet që nuk mund t'i ktheni pas, emri i instalimit dhe kujdestarët e çelësave. Përfundon me fletën e punës të plotësuar të planifikimit të Harrow Port Authority.
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

Kur instaluam Nexus në Harrow Port Authority, komandat morën një pasdite. Planifikimi mori një javë, dhe pjesa më e madhe e asaj jave shkoi për dy pyetje që nuk kanë të bëjnë fare me Kubernetes: si do ta quanim instalimin dhe cilët persona do të mbanin çelësat e tij të rikuperimit. Të dyja përgjigjet janë të përhershme. Gjithçka tjetër në këtë kapitull mund të ndryshohet më vonë me një skedar vlerash dhe një helm upgrade.
Unë jam Tomás Reilly, inxhinieri i platformës në Harrow. Harrow operon dy instalime. Ky kapitull planifikon instalimin e lidhur në rrjetin e korporatës sonë, ku ne pilotuam fillimisht versionin Community. Rrjeti i operacioneve të portit, i cili nuk ka dalje në internet, mori instalimin e vet më vonë; kapitulli 2.10, Instalimi i izoluar nga rrjeti (air-gapped), e mbulon atë. Ky kapitull është ajo që do të doja të kisha pasur mëngjesin e parë: klasterin që pret Nexus, emrat të cilëve u përgjigjet, sa kërkon nga nyjet tuaja dhe vendimet që duhen zgjidhur me drejtuesin tuaj të IT-së para instalimit. Ai mbyllet me fletën e punës që Aoife Brennan, drejtuesja jonë e IT-së, miratoi para se të fillonim. Kapitulli 2.4, Marrja dhe verifikimi i një versioni, mbulon shkarkimin dhe kontrollimin e versionit, dhe kapitulli 2.5, Kontrolli paraprak me nexusctl, kontrollon klasterin tuaj kundrejt gjithçkaje që ndodhet këtu.
Çfarë duhet të ketë klasteri
Nexus instalohet si një paketë e vetme (chart) Helm, nexus, versioni 1.0.0-alpha.1. Paketa përmban shërbimet e platformës dhe shtresën e tyre të të dhënave, dhe refuzon të instalohet në një klaster ku mungojnë pjesët e mëposhtme.
| Kërkesa | Çfarë pret Nexus | Pse |
|---|---|---|
| Kubernetes | 1.33 ose më i ri. Testuar në k3s v1.33.6+k3s1 |
kubeVersion e paketës është >=1.33.0-0, dhe helm install e detyron zbatimin e saj |
| cert-manager | v1.21.3, i instaluar para Nexus |
Paketa krijon autoritetin e vet lokal të certifikatave (CA) dhe certifikatat që shërbimet e saj përdorin për të komunikuar me njëra-tjetrën |
| Helm | v4 (ne përdorëm v4.3.1) | Helm 4 pret si parazgjedhje proceset Job (hook Jobs) të paketës, nga të cilat varet instalimi |
| Një klasë ruajtjeje (storage class) | Një e shënuar si parazgjedhje, ose një që e emërtoni në storage.className |
Çdo depo të dhënash kërkon një vëllim të qëndrueshëm (persistent volume) |
| Një klasë hyrjeje (ingress class) | Një e shënuar si parazgjedhje, ose një që e emërtoni në ingress.className |
Të tre adresat publike janë burime Ingress të thjeshta networking.k8s.io/v1 |
| Portat 80 dhe 443 | Të hapura në kontrolluesin e hyrjes (ingress controller), si një shërbim LoadBalancer ose NodePort | Njerëzit arrijnë te Nexus përmes kontrolluesit të hyrjes |
| Arkitektura | Nyje linux/amd64 ose linux/arm64 |
Çdo imazh është ndërtuar për të dyja |
Dy gjëra mungojnë qëllimisht në atë tabelë. Nexus nuk ka nevojë për rrjet shërbimesh (service mesh): TLS-ja e ndërsjellë (mTLS, Transport Layer Security në të dyja drejtimet) midis shërbimeve vjen nga CA-ja lokale e paketës përmes cert-manager. Paketa ka një çelës istio.enabled që ka si parazgjedhje false, dhe duhet ta lini ashtu. Nexus gjithashtu nuk ka nevojë për një motor të vetin të politikave të pranimit (admission policy engine).
Në stacionin tuaj të punës do t'ju duhet kubectl, Helm v4, cosign v3 për kontrollimin e nënshkrimeve, age për krijimin e çelësave të kujdestarëve, dhe nexusctl, ndërfaqja e rreshtit të komandës (CLI) e operatorit të Nexus. Kapitulli 2.4, Marrja dhe verifikimi i një versioni, tregon se ku ndodhet çdo shkarkim i Nexus.
Tri adresa
Çdo instalim përgjigjet në tre emra hostesh. Paketa i quan ato identiteti i instalimit, dhe çdo shërbim refuzon të niset pa to.
| Çelësi i vlerave | Emri i Harrow | Çfarë përgjigjet atje |
|---|---|---|
hosts.console |
console.harrow.example |
Konsola, aplikacioni ueb ku identifikohen njerëzit |
hosts.api |
api.harrow.example |
Porta (gateway), e cila shërben ndërfaqen e programimit të aplikacioneve (API) dhe drejton çdo kërkesë të inteligjencës artificiale (AI) |
hosts.auth |
auth.harrow.example |
Shërbimi i identifikimit, nexus-auth |
global.domain mban domenin nën të cilin ndodhen të treja, harrow.example për ne. Çdo host është një emër i plotë më vete dhe mund të ndodhet nën çdo domen që ju kontrolloni. Ne i mbajtëm të treja nën një domen sepse atëherë një certifikatë e vetme mund t'i mbulonte ato.
Krijoni një regjistrim në Sistemin e Emrave të Domenit (DNS) për secilin nga të tre, që tregon drejt adresës së kontrolluesit tuaj të hyrjes. Bëjeni këtë para kontrollit paraprak. nexusctl preflight kërkon secilin emër nga stacioni juaj i punës dhe e dështon instalimin nëse ndonjëri prej tyre nuk ka regjistrim, sepse një person nuk mund të arrijë një emër që nuk zgjidhet (resolve).
Zgjedhja se ku përfundon TLS
tls.mode e paketës vendos se kush i mban certifikatat për të tre adresat publike. Ka tre zgjedhje, dhe ju mund të ndryshoni midis tyre më vonë me një përditësim (upgrade).
tls.mode |
Ju siguroni | Çfarë bën paketa |
|---|---|---|
existing (parazgjedhja) |
Një Secret TLS i Kubernetes në hapësirën e emrave nexus, i emërtuar në tls.existingSecret |
Të tre burimet Ingress përdorin atë Secret të vetëm |
cert-manager |
Një ClusterIssuer që ju ekzekutoni, i emërtuar në tls.clusterIssuer |
Shënon (annotates) çdo Ingress në mënyrë që cert-manager të lëshojë nexus-console-tls, nexus-api-tls dhe nexus-auth-tls |
none |
Diçka përpara klasterit që përfundon TLS-në, siç është balancuesi juaj i ngarkesës (load balancer) | Gjeneron burimet Ingress pa seksion TLS |
Me existing, një certifikatë u shërben të tre hosteve, kështu që ajo duhet t'i emërtojë të treja, ose si tre emra alternativë të subjektit (SAN) ose si një simbol gjithëpërfshirës (wildcard) për domenin tuaj. Ne përdorëm një certifikatë nga CA-ja e brendshme e Harrow. Kontrolli paraprak lexon elementin Secret para se të instaloni dhe paralajmëron kur certifikata e tij skadon brenda 30 ditëve.
Me cert-manager dhe një lëshues të Mjedisit të Menaxhimit Automatik të Certifikatave (ACME), paketa nuk shton asnjë ridrejtim të vetin, kështu që një kërkesë /.well-known/acme-challenge/ në portën 80 arrin te zgjidhësi (solver) e paprekur. Mos shtoni një ridrejtim HTTP-në-HTTPS në kontrolluesin tuaj të hyrjes që ekzekutohet para shtegut të sfidës (challenge path); një certifikatë që nuk mund të rinovohet dështon në heshtje, javë më vonë.
Çfarëdo që të zgjidhni për skajin publik, shërbimet brenda hapësirës së emrave komunikojnë gjithmonë përmes TLS-së nga CA-ja lokale e paketës. Kjo pjesë nuk është me zgjedhje, dhe kjo është arsyeja pse cert-manager është një parakusht edhe kur tls.mode është existing ose none.
Çfarë del nga klasteri, dhe çfarë jo
Paketa gjeneron një politikë rrjeti që refuzon si parazgjedhje (default-deny) për hapësirën e emrave nexus. Pas kësaj, lejohen vetëm këto flukse:
- trafiku midis podeve të Nexus brenda hapësirës së emrave;
- kërkimet DNS drejt shërbimit DNS të klasterit;
- serveri API i Kubernetes, për ato pak shërbime që shqyrtojnë tokenët e ngarkesës së punës (workload tokens);
- hapësira e emrave e kontrolluesit të hyrjes, drejt tre shërbimeve (Services) publike;
- çdo interval i Rrugëzimit Ndër-Domenesh pa Klasa (CIDR) që ju listoni në
networkPolicy.externalEgressCIDRs.
Kjo lista e fundit është bosh si parazgjedhje. Nëse do të përdorni një rele poste (mail relay) ose një server modelesh jashtë klasterit, intervali i tij vendoset aty. Telemetria është e çaktivizuar dhe mbetet e çaktivizuar: skema pranon vetëm telemetry.enabled: false, dhe raportimi i përdorimit të vetë depove të të dhënave është gjithashtu i çaktivizuar.
Paketa lexon adresat e serverit API nga klasteri kur ju instaloni. Nëse llogaria juaj nuk mund të lexojë pikat fundore (Endpoints) kubernetes në hapësirën e emrave default, jepini ato vetë në networkPolicy.apiServerCIDRs, si intervale /32. proxy.trustedCIDRs emërton rrjetin e podeve ku ndodhet kontrolluesi juaj i hyrjes, në mënyrë që nexus-auth të dijë se cilit titull (header) X-Forwarded-For t'i besojë. Parazgjedhja, 10.42.0.0/16, është rrjeti i podeve i k3s.
Përmasat
Kërkesat e parazgjedhura të paketës arrijnë në total rreth 2.05 bërthama të njësisë qendrore të përpunimit (CPU) dhe 6.7 GiB memorie. Kjo është ajo që rezervon planifikuesi (scheduler); kufijtë janë më të lartë, dhe depot e të dhënave rriten deri në këta kufij ndërsa shtoni njerëz dhe skedarë.
| Pjesa | CPU e kërkuar | Memoria e kërkuar |
|---|---|---|
| Nëntë shërbime të platformës (console, backend for frontend (BFF), auth, orchestrator, workflows, gateway, graphrag, probitas, skills engine) | 1.1 bërthama | 2.6 GiB |
Shërbimi i çelësave, nexus-keys |
0.05 bërthama | 64 MiB |
| PostgreSQL | 0.25 bërthama | 1 GiB |
| Neo4j | 0.25 bërthama | 2 GiB |
| Valkey, Qdrant dhe depoja e objekteve së bashku | 0.25 bërthama | 640 MiB |
| Të dy serverët OpenBao të depos së çelësave | 0.15 bërthama | 384 MiB |
Vëllimet e parazgjedhura arrijnë në total 142 GiB:
| Depoja | Çelësi i vlerave | Madhësia e parazgjedhur |
|---|---|---|
| PostgreSQL 16 me PostGIS 3 dhe pgvector 0.8 | dataTier.postgres.size |
50Gi |
| Depoja e objekteve (SeaweedFS) | dataTier.objectStore.size |
50Gi |
| Neo4j 5.26 Community Edition | dataTier.neo4j.size |
20Gi |
| Qdrant | dataTier.qdrant.size |
10Gi |
| Valkey | dataTier.valkey.size |
5Gi |
| Depoja e çelësave dhe zhbllokuesi (unsealer) i saj | keys.openbao.storage.keystore, keys.openbao.storage.unsealer |
5Gi dhe 1Gi |
| Dëftesat e shërbimit të çelësave | keys.receiptsStorage |
1Gi |
Për një nyje të vetme, planifikoni 8 vCPU, 32 GiB memorie me akses të rastësishëm (RAM) dhe një disk të gjendjes së ngurtë (SSD) prej 250 GB. Për një vlerësim, 4 vCPU, 16 GiB dhe 200 GB do të mjaftojnë. Imazhi i diskut të instaluesit refuzon një makinë me më pak se 16 GiB memorie (shihni kapitullin 2.9, Imazhi i diskut të instaluesit), dhe unë do ta trajtoja këtë si kufirin minimal kudo.
Nyjet grafike janë opsionale. Pa një nyje që ofron një njësi të përpunimit grafik (GPU), asistenti përgjigjet përmes një modeli të hostuar, duke përdorur çelësin e vetë organizatës. Kontrolli paraprak e raporton këtë si një paralajmërim, kurrë si një dështim. Kapitulli 2.14, Ofruesit dhe modelet e AI, mbulon të dyja rrugët.
Çdo depo mund të ekzekutohet gjithashtu jashtë klasterit: caktoni dataTier.<store>.mode në external dhe emërtoni hostin e saj dhe një Secret. Një PostgreSQL i jashtëm ka nevojë për një llogari superpërdoruesi për nisjen fillestare (bootstrap) të instalimit dhe një certifikatë që Nexus mund ta verifikojë. Kapitulli 2.11, Variacionet: depot e jashtme, TLS dhe hyrja (ingress), e mbulon këtë. Nëse i mbani ato në klaster, vendosini në një klasë ruajtjeje me disqe reale pas saj. Baza e të dhënave është pjesa që do t'ju mungojë më shumë nëse disku lokal i një nyjeje prishet.
Emri i instalimit është i përhershëm
keys.installationName është mënyra se si operatorët e quajnë këtë instalim. Ai duhet të përputhet me ^[a-z][a-z0-9-]{0,62}$: një shkronjë e vogël, pastaj deri në 62 shkronja të vogla, shifra ose viza ndarëse.
Herën e parë që niset depoja e çelësave, ajo krijon identitetin e instalimit nën këtë emër, dhe ky identitet mbetet i pandryshueshëm përgjithmonë. Një licencë nga Adverant lëshohet për atë identitet, kështu që një licencë e bërë për një instalim refuzohet në një tjetër me LICENCE_OTHER_INSTALLATION. Riemërtimi do të nënkuptonte një instalim të ri, një identitet të ri dhe licenca të reja.
Paketa nuk ka një vlerë të parazgjedhur për emrin. Ajo refuzon një instalim pa emër (INSTALLATION_NAME_MISSING) dhe refuzon emrin e shembullit nga skedarët e saj të vlerave të shembullit (INSTALLATION_NAME_EXAMPLE). Kontrolli paraprak i raporton të dyja para se të arrini deri aty.
Në Harrow ne shpenzuam më shumë kohë për këtë sesa do të doja ta pranoja. Ne vendosëm për harrow-port-authority: ai emërton organizatën, nuk thotë asgjë se në cilin klaster ekzekutohet dhe do të jetë ende i vlefshëm kur pajisjet harduerike të zëvendësohen. Shmangni emra si prod-k3s-2 që përshkruajnë makinat e sotme.
Kujdestaria e çelësave
Nexus mban çelësat e çdo organizate në depon e vet të çelësave, brenda klasterit. Ju nuk e operoni atë në përditshmëri, por vendosni, para instalimit, se kush mund ta rikthejë atë në punë pas një rinisjeje. Ky është vendimi që kushton më shumë nëse e bëni gabim.
Depoja e çelësave përbëhet nga dy serverë OpenBao. Kryesori, openbao, mban çelësat dhe zhbllokohet (unseals) vetë përmes një të dyti, më të vogël, openbao-unsealer. Zhbllokuesi është i bllokuar (sealed) me skemën e Shamir: pesë pjesë (shares), çdo tre prej të cilave e hapin atë. Kur instaloni, një proces Job i kujdestarisë inicializon të dy serverët brenda klasterit. Në memorien e atij procesi Job, ai enkripton pjesët e zhbllokuesit dhe çelësat e rikuperimit të depos së çelësave për çdo kujdestar që ju emërtoni, ruan vetëm tekstin e shifruar (në elementët Secret openbao-unseal-shares-encrypted dhe openbao-recovery-keys-encrypted) dhe revokon të dy tokenët rrënjë (root tokens) para se të përfundojë. Asnjë pjesë e paenkriptuar nuk arrin kurrë në një disk ose në një regjistër (log).
Pas çdo rinisjeje të nyjes së zhbllokuesit, zhbllokuesi niset i bllokuar. Depoja e çelësave pret për të, dhe asgjë që ka nevojë për një çelës nuk funksionon derisa një kujdestar ta zhbllokojë atë. Kjo kërkon një dekriptim të vetëm me çelësin privat të vetë kujdestarit. Procedura ndodhet në kapitullin 2.15, Dita e dytë: operimi i Nexus.
Krijimi i një çelësi kujdestari
Një kujdestar emërtohet nga gjysma publike e një çelësi age, e quajtur marrësi (recipient) i tij. Çdo kujdestar krijon çelësin e vet në makinën e vet dhe ju jep vetëm marrësin:
age-keygen -o custodian.keyRreshti # public key: i skedarit është marrësi, që fillon me age1. Një kujdestar me një Mac mund ta mbajë çelësin në Secure Enclave të Mac-ut në vend të kësaj, në mënyrë që gjysma private të mos largohet kurrë nga çipi dhe çdo përdorim të kërkojë një shenjë gishti:
age-plugin-se keygen --access-control=any-biometry -o custodian.keyAi marrës fillon me age1se1. Procesi Job i kujdestarisë enkripton për pesë forma marrësish: age1 (X25519), age1tag1 dhe age1tagpq1 (tag), age1pq1 (hibrid post-kuantik), dhe age1se1 (Secure Enclave). Ai refuzon çdo formë tjetër shtojce (plugin), siç është age1yubikey1; emërtojeni atë çelës në njërën nga format e pranuara në vend të kësaj.
Paketa kontrollon çdo marrës kur gjenerohet. Një i shkruar gabim dështon në kontrollin e shumës (checksum) bech32 dhe refuzohet, kështu që asgjë nuk bllokohet kurrë me një çelës që nuk e mban askush. Nëse dikush ngjit gabimisht një çelës privat në listë, paketa e refuzon atë pa e shfaqur mbrapsht. Marrësi i shembullit në skedarët e vlerave të vetë paketës refuzohet gjithashtu (KEYS_CUSTODIAN_EXAMPLE); askush nuk e mban gjysmën e tij private.
Sa kujdestarë
Çdo pjesë enkriptohet për çdo kujdestar, kështu që çdo kujdestar i vetëm mund të kryejë zhbllokimin vetë. Më shumë kujdestarë do të thotë më shumë mënyra për të rikuperuar dhe më shumë njerëz që mund të veprojnë secili i vetëm. Ne zgjodhëm tre në Harrow: Aoife, unë, dhe një çelës Secure Enclave në një laptop rezervë që mbahet në kasafortën e portit. Dy është minimumi që do të pranoja. Një është një pikë e vetme dështimi që, herët a vonë, do të jetë me pushime kur një nyje të riniset.
Zgjedhja e edicionit
edition është community ose enterprise, dhe enterprise.enabled duhet të përputhet me të. Paketa refuzon një mospërputhje, dhe refuzon çdo edicion që nuk është një nga të dy.
Edicioni vendos gjithashtu se cilat imazhe instaloni. Çdo paketë (chart) përmban një bllokim imazhesh (images lock), listën e çdo imazhi sipas kodit unik (digest), për një edicion. Një instalim Community merr vetëm imazhe Community. Një instalim Enterprise merr bllokimin Enterprise, i cili përbëhet nga imazhet Community plus ndërtimet (builds) Enterprise, dhe i shkarkon ato me një token tërheqjeje (pull token) nga llogaria juaj Adverant. Kapitulli 2.4, Marrja dhe verifikimi i një versioni, shpjegon bllokimin, dhe kapitulli 2.2, Edicionet në brendësi, shpjegon se çfarë përmban çdo edicion.
Nuk keni pse të vendosni përfundimisht. Një instalim Community kalon në Enterprise aty ku është, duke ruajtur njerëzit, skedarët dhe historikun e tij; kapitulli 2.7, Instalimi i Enterprise dhe aplikimi i një licence, tregon se si. Ne ekzekutuam Community për pilotimin në Harrow dhe kaluam gjashtë javë më vonë.
Licenca nuk është kurrë pjesë e këtij plani. Ajo nuk është një vlerë e paketës ose një skedar i montuar: ju e importoni atë pas instalimit, përmes konsolës, nexusctl ose API-t.
Zgjedhja e formës së shpërndarjes
| Forma | Kur përshtatet | Kapitulli |
|---|---|---|
Paketa (chart) Helm nga registry.adverant.ai |
Klasteri juaj Kubernetes, me një rrugë drejt regjistrit | 2.6 dhe 2.7 |
nexusctl install |
I njëjti klaster, me kontrollin paraprak dhe kontrollin e nënshkrimit të ekzekutuara për ju | 2.6 |
nexusctl install --single-node |
Një makinë e vetme, ku nexusctl konfiguron edhe klasterin |
2.8 |
| Imazhi i diskut të instaluesit | Një server fizik (bare server) ose makinë virtuale (VM) që nuk do të donit ta përgatisnit manualisht | 2.9 |
| Paketa jashtë linje (offline bundle) | Asnjë rrugë daljeje fare; imazhet dhe paketa vijnë në një disk | 2.10 |
Paketa (chart) është e njëjtë në çdo formë. Ajo që ndryshon është se kush e krijon klasterin dhe nga vijnë imazhet.
Fleta e punës së planifikimit
Kjo është e Harrow, siç e miratoi Aoife. Kopjoni dy kolonat e majta dhe plotësoni atë të djathtën për instalimin tuaj.
| Vendimi | Çelësi i vlerave ose komanda | Harrow Port Authority |
|---|---|---|
| Kubernetes dhe versioni | (kontrolli paraprak e lexon atë) | k3s v1.33.6+k3s1, tre nyje |
| Konteksti Kube për instalimin | --context |
harrow-prod |
| Hapësira e emrave (Namespace) | --namespace |
nexus |
| Edicioni | edition, enterprise.enabled |
community për pilotimin, pastaj enterprise |
| Regjistri i imazheve | global.imageRegistry |
registry.adverant.ai |
| Domeni | global.domain |
harrow.example |
| Adresa e konsolës | hosts.console |
console.harrow.example |
| Adresa e API-t | hosts.api |
api.harrow.example |
| Adresa e identifikimit | hosts.auth |
auth.harrow.example |
| TLS në skaj | tls.mode, tls.existingSecret |
existing, Secret harrow-public-tls nga CA-ja e brendshme e Harrow |
| Klasa e hyrjes (Ingress class) | ingress.className |
traefik |
| Hapësira e emrave e hyrjes (Ingress namespace) | networkPolicy.ingressNamespace |
kube-system |
| Klasa e ruajtjes (Storage class) | storage.className |
local-path |
| Depot e të dhënave | dataTier.<store>.mode |
Të gjitha in-cluster, madhësitë e parazgjedhura |
| Intervalet dalëse | networkPolicy.externalEgressCIDRs |
Vetëm intervali i relesë së postës |
| Emri i instalimit (i përhershëm) | keys.installationName |
harrow-port-authority |
| Kujdestarët (në efekt të përhershëm) | keys.custody.recipients |
Tre: Aoife Brennan, Tomás Reilly, laptopi në kasafortë (age1se1) |
| Nyjet grafike | (kontrolli paraprak e lexon atë) | Asnjë për pilotimin e lidhur; model i hostuar me çelësin e vetë Harrow |
| Administratori i parë | nexusctl claim-code --administrator |
aoife.brennan@harrow.example |
Dy rreshta në atë fletë nuk mund të zhbëhen: emri i instalimit dhe kujdestarët, në kuptimin që humbja e të gjithëve sjell humbjen e depos së çelësave. Merrni miratimin me shkrim për këto të dyja nga dikush me autoritetin për të thënë po. Gjithçka tjetër është një ndryshim vlerash.
Me fletën e punës të përfunduar, shkoni te kapitulli 2.4, Marrja dhe verifikimi i një versioni, dhe shkarkoni versionin.
