Versioni 1.0.0-alpha.1më i fundit
Kapitulli 2.9
Imazhi i diskut të instaluesit
Nisni një server fizik ose një makinë virtuale nga imazhi i instaluesit të Nexus dhe ai instalon sistemin operativ, k3s, cert-manager dhe Nexus pa rrjet, duke kontrolluar çdo skedar përpara se të përdoret.
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

Zyra e kapitenit të portit në kalatën lindore të Harrow ka një server, asnjë lidhje interneti dhe askënd në terren që përdor Kubernetes. Megjithatë, Tomás Reilly kishte nevojë për Nexus në të. Ai e shkroi imazhin në një memorie USB (Universal Serial Bus), vendosi një memorie të dytë të vogël pranë saj me katër rreshta cilësimesh dhe ndezi serverin. Një orë më vonë, ekrani tregoi adresën e konsolës dhe tre rreshtat për t'u shtuar te skedari hosts. Ai nuk shtypi asnjë komandë të vetme të Kubernetes.
Kjo është puna e imazhit të diskut të instaluesit. Ai shkruan një sistem operativ minimal në diskun e serverit, pastaj në ndezjen e parë kontrollon çdo skedar që mbart kundrejt çelësit të lëshimit të Adverant, instalon k3s pa rrjet, importon çdo imazh, instalon cert-manager dhe Nexus, si dhe kontrollon që çdo pod të jetë duke punuar. Çdo hap ndalon me një arsye të emërtuar në momentin që diçka nuk shkon mirë. Nuk ka rrugë të degraduar dhe asnjë fjalëkalim të paracaktuar askund.
Dy imazhet
Çdo version vjen si dy lloje imazhesh, për dy arkitektura procesorësh, amd64 dhe arm64.
| Skedari | Çfarë mban | Kush mund ta shkarkojë |
|---|---|---|
nexus-alpha-installer-1.0.0-alpha.1-<arch>.iso |
Vetëm instaluesi: sistemi operativ, k3s v1.33.6+k3s1, cert-manager v1.21.3 dhe instaluesi i ndezjes së parë. Funksionon për secilin edicion dhe nuk mban asnjë imazh të Nexus. | Kushdo, nga downloads.adverant.ai |
nexus-alpha-<edition>-1.0.0-alpha.1-<arch>.iso |
I njëjti instalues me paketën offline të atij edicioni të shtuar si një ndarje e dytë e etiketuar NEXUS-BUNDLE. Një medium instalon gjithçka. |
Community: kushdo. Enterprise: vetëm nga llogaria juaj Adverant |
<arch> është amd64 ose arm64, dhe <edition> është community ose enterprise.
Instaluesi kërkon gjithmonë vetëm një sistem skedarësh të etiketuar NEXUS-BUNDLE. Në imazhin gjithëpërfshirës (all-in-one), kjo është ndarja në vetë imazhin. Me imazhin që përmban vetëm instaluesin, ju e sillni paketën në një disk ose memorie të dytë me atë etiketë, gjë që është e përshtatshme kur instaloni disa vendndodhje nga një memorie e vetme instaluesi dhe ndryshoni vetëm paketën. Kapitulli 2.10, Instalimi pa lidhje rrjeti (air-gapped), përshkruan paketën.
Imazhet Enterprise dhe paketat Enterprise nuk janë kurrë anonime. Ju i shkarkoni ato nga llogaria juaj Adverant në https://account.adverant.ai, në faqen e Shkarkimeve (Downloads), pranë licencës suaj. Imazhet dhe paketat Community janë publike.
Nga çfarë është ndërtuar imazhi
Sistemi operativ bazohet në Debian 13 dhe nuk është një imazh zyrtar i Debian. Ai përmban sistemin bazë Debian dhe asgjë tjetër: asnjë paketë shtesë, asnjë desktop dhe asnjë pasqyrë (mirror). k3s sjell mjedisin e vet të ekzekutimit të kontejnerëve dhe rrjetëzimin. Zinxhiri i ndezjes (shim, GRUB, kerneli dhe ramdisk-u fillestar) është bajt për bajt ai që shpërndan Debian, kështu që një makinë me Secure Boot të aktivizuar e nis atë si çdo instalues Debian.
Dy ndërtime të të njëjtit version japin imazhe identike, bajt për bajt, dhe versioni nuk publikohet derisa ta bëjnë këtë. Paketat burimore të Debian për çdo skedar binar në imazh publikohen pranë tij si nexus-alpha-installer-1.0.0-alpha.1-debian-source.tar, në të njëjtën listë të shumave të kontrollit (checksum).
Kontrolloni shkarkimin përpara se ta shkruani
Direktoria e imazheve në downloads.adverant.ai mban imazhet, një skedar SHA256SUMS që mbulon çdo skedar të publikuar, dhe SHA256SUMS.sigstore.json, nënshkrimin mbi atë listë të bërë me çelësin e lëshimit të Adverant. Merreni çelësin publik të lëshimit veçmas, ruajeni si release.pub, dhe kontrolloni gjurmën e tij digjitale siç përshkruan kapitulli 2.4, Marrja dhe verifikimi i një versioni.
- Verifikoni nënshkrimin në listën e shumave të kontrollit. Nuk ka regjistër transparence për versionet e Nexus, kështu që flamuri që anashkalon kërkimin në regjistër është i detyrueshëm.
cosign verify-blob --key release.pub --insecure-ignore-tlog=true \
--bundle SHA256SUMS.sigstore.json SHA256SUMSVerified OK
- Kontrolloni imazhin që keni shkarkuar kundrejt listës:
grep nexus-alpha-community-1.0.0-alpha.1-amd64.iso SHA256SUMS | sha256sum -c -nexus-alpha-community-1.0.0-alpha.1-amd64.iso: OK
Në një Mac, përdorni shasum -a 256 -c - në vend të sha256sum -c -.
- Shkruani imazhin në një memorie USB me mjetin që përdorni zakonisht, ose bashkëngjitjani makinës virtuale si një disk optik.
k3s publikon shumat e kontrollit për skedarët e versioneve të tij dhe asnjë nënshkrim, kështu që skedarët e k3s brenda imazhit kontrollohen kundrejt shumave të kontrollit që publikon k3s, nga e njëjta origjinë si skedarët. Gjithçka që ka ndërtuar Adverant është e nënshkruar.
Paketat në pjesë
Një paketë që e mbani në një memorie të veçantë është disa gigabajt. Disa sisteme skedarësh, ndër to edhe FAT (File Allocation Table), nuk mund të mbajnë një skedar prej 4 GiB ose më shumë, kështu që skedarët e paketës publikohen në pjesë prej 2047 MiB që nxënë në çdo memorie. Bashkoni pjesët përsëri së bashku sipas radhës dhe kontrolloni skedarin e bashkuar kundrejt .sha256 së tij përpara se ta përdorni.
Pajisjet harduerike që i nevojiten
Ndezja e parë kontrollon makinën përpara se të prekë ndonjë gjë, dhe refuzon të vazhdojë kur makina është shumë e vogël.
| Kontrolli | Dyshemeja | Kur kontrollohet |
|---|---|---|
| Arkitektura | E vetë imazhit: një imazh amd64 në amd64, arm64 në arm64 | Ndezja e parë |
| Memoria | 16 GiB | Ndezja e parë |
| Disku i synuar | Saktësisht një disk bosh me të paktën 64 GB, ose disku që emërton skedari fillestar (seed) | Përpara se të shkruhet sistemi operativ |
Hapësira e lirë në / |
50 GB pasi sistemi operativ të jetë vendosur | Ndezja e parë |
| Ora | Jo më e vjetër se data kur është ndërtuar imazhi | Ndezja e parë |
Këto janë kufijtë minimalë, jo një rekomandim. Me vlerat e paracaktuara të grafikut (chart), vetëm vëllimet e Nexus arrijnë në 142 GiB, kështu që një disk 64 GB e kalon instaluesin dhe mbushet brenda pak ditësh. Përdorni atë që duhet të ketë një nyjë e vetme: 8 vCPU (njësi qendrore virtuale të përpunimit), 32 GiB memorie dhe një SSD (solid-state drive) 250 GB. Katër vCPU, 16 GiB dhe 200 GB janë të mjaftueshme për një vlerësim.
Kontrolli i orës është aty sepse serveri nuk ka rrjet, dhe për këtë arsye asnjë shërbim kohe, gjatë instalimit. Certifikatat dhe nënshkrimet kontrollohen kundrejt orës. Nëse ora harduerike e makinës është prapa datës së ndërtimit të imazhit, ndezja e parë ndalon dhe ju kërkon ta caktoni atë. Caktojeni në cilësimet e firmware-it dhe ndizeni përsëri.
Serverët fizikë (bare metal) dhe makinat virtuale
Imazhi ndizet në firmware UEFI (Unified Extensible Firmware Interface), si në serverët fizikë ashtu edhe në makinat virtuale. Ai instalon ngarkuesin e ndezjes (boot loader) në shtegun e mediave të lëvizshme si dhe në atë të zakonshmin, kështu që një VM (makinë virtuale) pa hyrje të ruajtura ndezjeje e gjen përsëri atë pas rinisjes së parë. Jepini një VM-je memorien dhe diskun në tabelën e mësipërme, një disk virtual bosh dhe imazhin si një CD.
Instaluesi zgjedh diskun e synuar sipas një rregulli të rreptë dhe nuk zgjedh kurrë "diskun e parë".
- Ai anashkalon mediumin nga i cili u ndez.
- Ai anashkalon disqet e lëvizshme, përveç nëse skedari fillestar (seed) emërton një të tillë.
- Ai anashkalon çdo disk që ka tashmë një tabelë ndarjeje, të cilido lloj.
- Ai anashkalon disqet nën 64 GB, dhe e thotë këtë në konsolë.
- Ai instalon vetëm kur mbetet saktësisht një disk.
Në një server me dy disqe bosh ai ndalon dhe ju kërkon të zgjidhni. Ju zgjidhni duke emërtuar diskun në skedarin fillestar (seed), me wipe: true, e cila është e vetmja mënyrë që ai të shkruajë ndonjëherë në një disk që ka tashmë ndarje.
Vëllimi NEXUS-SEED
Skedari fillestar (seed) është një vëllim i vogël, zakonisht një memorie USB, me një sistem skedarësh të etiketuar NEXUS-SEED dhe një skedar seed.yaml në nivelin e tij më të lartë. Instaluesi e monton atë vetëm për lexim, lexon cilësimet dhe e rimonton të shkrueshëm vetëm krejt në fund, për t'ju lënë fjalëkalimin e sistemit operativ.
# seed.yaml on the NEXUS-SEED volume
domain: harrow.example
adminEmail: aoife.brennan@harrow.example
edition: enterprise
timeout: 45m| Çelësi | Çfarë cakton | Kur mungon |
|---|---|---|
domain |
Domeni i instalimit. Instaluesi nxjerr tre hostet prej tij: console.<domain>, api.<domain> dhe auth.<domain>. |
Kërkohet në konsolën e serverit |
adminEmail |
Email-i i personit që do të jetë administratori i parë | Kërkohet në konsolën e serverit |
edition |
community ose enterprise. Kur caktohet, duhet të përputhet me edicionin e paketës. |
Merret nga paketa |
timeout |
Sa kohë mund të zgjasë instalimi i cert-manager dhe Nexus, si një kohëzgjatje e tillë si 30m ose 1h |
30m |
time |
Koha aktuale në UTC, në formën që printon mesazhi i orës (2026-11-14T09:00:00Z), për një makinë ora harduerike e së cilës nuk mund të caktohet ose nuk e mban cilësimin e saj. Një makinë offline nuk ka asnjë server kohe për të pyetur. |
Përdoret ora harduerike |
disk |
Disku i synuar, si /dev/<name>, i përdorur vetëm së bashku me wipe: true |
Rregulli i diskut bosh më sipër |
wipe |
true lejon instaluesin të fshijë diskun që emërton disk |
Asnjë disk nuk fshihet kurrë |
Për Enterprise, vendosni skedarin e licencës në të njëjtin vëllim si licence.json. Pa të, ndezja e parë ndalon në hapin e skedarit fillestar (seed) dhe thotë se licenca mungon. Community nuk ka nevojë për licencë, dhe për Community i gjithë skedari fillestar është opsional: instaluesi kërkon domenin dhe email-in në konsolë dhe vazhdon.
Instaluesi lexon çdo rresht si key: value në fillim të rreshtit. Shkruani një çelës për rresht, në nivelin më të lartë, pa thonjëza dhe pa zhvendosje (indentation). Një vlerë në thonjëza lexohet me gjithë thonjëzat e saj.
Në ndezjen e parë instaluesi kërkon gjithashtu në konsolë kujdestarin e depos së çelësave: gjysmën publike të një çelësi age, age1..., të krijuar në makinën e vetë kujdestarit me age-keygen -o custodian.key. Depoja e çelësave vulos çelësat e saj të rikuperimit me të. Kapitulli 2.8, Instalimet në një makinë të vetme, shpjegon kujdestarët. Kujdestari e mban gjysmën private offline dhe të sigurt: pa të, askush nuk mund ta zhbllokojë depon e çelësave pas një rinisjeje.
Çfarë ndodh, nga ndezja deri te adresa e konsolës
Faza e parë: sistemi operativ
Imazhi ndizet në një instalues Debian të pambikëqyrur. Ai nuk konfiguron rrjet, nuk përdor pasqyrë (mirror) dhe nuk instalon asnjë paketë përtej sistemit bazë. Ai cakton zonën kohore në UTC (Coordinated Universal Time), çaktivizon hyrjen si root dhe krijon një përdorues, nexus, fjalëkalimi i të cilit është i bllokuar. Ai zgjedh diskun e synuar sipas rregullit të mësipërm dhe shkruan një disk GPT (globally unique identifier partition table) me një ndarje sistemi EFI (Extensible Firmware Interface) dhe një sistem skedarësh rrënjë ext4, pa swap.
Në fund ai kopjon instaluesin e Nexus në sistemin e ri, kontrollon çdo skedar të kopjuar kundrejt listës së shumave të kontrollit të imazhit dhe aktivizon një shërbim të ndezjes së parë. Nëse ndonjë skedar i kopjuar nuk përputhet, ai ndalon aty. Pastaj nxjerr mediumin dhe riniset.
Faza e dytë: ndezja e parë
Në ndezjen e parë shërbimi nexus-install ekzekutohet një herë. Çdo hap printohet në konsolën e serverit dhe në ditar (journal), dhe regjistrohet si i kryer, kështu që një riprovë fillon nga hapi i parë që nuk është kryer. Shërbimi në tërësi mund të ekzekutohet deri në katër orë përpara se systemd ta ndalojë atë, gjë që lë hapësirë për një disk të ngadaltë dhe një orë pritje për memorien e paketës.
- Kontrolli paraprak (Preflight). Arkitektura, ora, memoria dhe hapësira e lirë në disk, si në tabelën e mësipërme.
- Ngarkesa (Payload). Skedarët e vetë instaluesit: nënshkrimi në listën e tij të shumave të kontrollit me çelësin e lëshimit që mbart, pastaj çdo skedar kundrejt asaj liste.
- Skedari fillestar (Seed). Lexon
seed.yaml, dhe pyet në konsolë për çdo gjë që mungon. - Paketa (Bundle). Gjen vëllimin e etiketuar
NEXUS-BUNDLEdhe e monton atë vetëm për lexim. Nëse nuk ka një të tillë, thotëwaiting-for-bundledhe pret deri në një orë që ju ta bashkëngjitni atë. Pastaj ekzekuton kontrollin e plotë të paketës, duke përfunduar meVERIFY-BUNDLE PASS, me çelësin e lëshimit që mbart, përpara se të importohet ndonjë gjë. Një paketë Enterprise ka nevojë përlicence.jsonnë skedarin fillestar, dhe edicioni i skedarit fillestar duhet të përputhet me atë të paketës. - k3s. Instalon k3s v1.33.6+k3s1 nga skedarët e vetë imazhit me shkarkimet e çaktivizuara, dhe pret deri në dhjetë minuta që nyja të jetë Ready. Pastaj heq arkivin e imazheve air-gap të k3s, në mënyrë që imazhet të mos importohen përsëri në çdo nisje.
- Importimi (Import). Importon çdo imazh të verifikuar nga paketa, dhe imazhet e cert-manager, në depon e kontejnerëve të nyjës. Asgjë nuk tërhiqet kurrë nga një regjistër.
- cert-manager, pastaj Nexus. Instalon cert-manager v1.21.3, pastaj grafikun (chart) e Nexus nga paketa, të dyja brenda
timeouttë skedarit fillestar. - Pranimi (Acceptance). Kontrollon që çdo pod të jetë Running dhe çdo hook Job të ketë përfunduar.
- Kredencialet (Credential). I jep përdoruesit të sistemit operativ
nexusnjë fjalëkalim të ri të rastësishëm, e shfaq atë një herë në konsolë dhe e shkruan tenexus-os-password.txtnë vëllimin e skedarit fillestar kur vëllimi është i shkrueshëm.
Kontrolli i paketës në hapin 4 është i njëjti skript që ekzekutoni manualisht në kapitullin 2.10, Instalimi pa lidhje rrjeti (air-gapped), dhe printon të njëjtat rreshta:
1 SHA256SUMS OK files=<n>
2 SHA256SUMS signature OK
3 images signed + SBOM-attested: <n>
4 helm lint --strict OK nexus-1.0.0-alpha.1.tgz
5 coverage OK rendered=<n> lock=<n>
6 source offer OK images=5 files=<n>
VERIFY-BUNDLE PASS files=<n> images=<n>
Rreshti 3 numëron imazhet që mbajnë një nënshkrim të vlefshëm dhe një SBOM (software bill of materials) të nënshkruar, listën e asaj që përmban çdo imazh. Numërimet (<n>) varen nga edicioni. Ajo që ka rëndësi është rreshti i fundit.
Instalimi shkruan vlerat në formën aktuale të grafikut: global.domain dhe tre emrat hosts.* nga domeni i skedarit fillestar, si dhe keys.custody.recipients nga kujdestari që dhatë në konsolë. Ai instalon nga grafiku dhe imazhet e vetë paketës, kështu që versioni në disk është saktësisht versioni që u kontrollua.
Rreshtat e fundit në konsolë
Kur çdo hap ka kaluar, konsola tregon fjalëkalimin e sistemit operativ një herë dhe adresën për të hapur:
nexus-install: OS login: user nexus, password <shown-once> (shown once; change it with passwd)
nexus-install: DONE: https://console.harrow.example (add to /etc/hosts: 10.20.4.15 console.harrow.example api.harrow.example auth.harrow.example)
Shënojeni fjalëkalimin ose merreni nga memoria e skedarit fillestar, pastaj hyni si nexus dhe ndryshojeni atë me passwd. Askush, përfshirë Adverant, nuk di një fjalëkalim të paracaktuar për këtë makinë, sepse nuk ka një të tillë.
Adresa në rreshtin e hosts është e vetë serverit. Pa DNS (Domain Name System) në kalatë, Tomás shtoi atë rresht të vetëm te skedari hosts i çdo laptopi që do të përdorte konsolën. Në një vendndodhje me DNS, shtoni regjistrime për tre emrat në vend të kësaj.
Pas instalimit
Instalimi është i papërvetësuar. Askush nuk mund të hyjë derisa dikush ta përvetësojë atë në një shfletues, duke krahasuar gjurmën digjitale të instalimit me atë që tregon serveri. Kapitulli 2.12, Ekzekutimi i parë, mbulon përvetësimin, administratorin e parë dhe çelësin e kalimit (passkey). Administratori i parë duhet të jetë personi email-i i të cilit ndodhet në skedarin fillestar.
Skedari kubeconfig i vetë nyjës ndodhet në /etc/rancher/k3s/k3s.yaml, i lexueshëm vetëm nga root. Për të punuar në klaster nga një stacion pune, nexusctl kubeconfig e printon atë, siç përshkruan kapitulli 2.8, Instalimet në një makinë të vetme.
Përditësimet vijnë në të njëjtën mënyrë siç erdhi instalimi: një version në media të nënshkruara, i kontrolluar kundrejt çelësit të instaluar tashmë në server dhe kurrë kundrejt një çelësi që disku sjell me vete. Kapitulli 2.10, Instalimi pa lidhje rrjeti (air-gapped), përshkruan atë kontroll.
Nëse kjo dështon
Çdo dështim printon nexus-install: FAILED <step>: <what is missing> në konsolë dhe shkruan të njëjtën gjë në /var/lib/nexus/install.state. Rregulloni shkakun dhe ekzekutoni instalimin përsëri nga hapi i parë që nuk është kryer:
sudo nexus-install retry| Mesazhi | Çfarë do të thotë | Çfarë duhet të bëni |
|---|---|---|
FAILED preflight: payload is for arm64, this machine is amd64 |
Ju ndezët imazhin e arkitekturës tjetër. | Përdorni imazhin për arkitekturën e kësaj makine. |
FAILED preflight: memory 11 GiB, need >= 16 GiB |
Makina ka më pak se kufiri minimal. | Shtoni memorie, ose jepini VM-së më shumë. |
FAILED preflight: free disk 38 GB on /, need >= 50 GB |
Sistemi i skedarëve rrënjë është shumë i vogël. | Instaloni në një disk më të madh. |
FAILED preflight: the clock (...) is older than the build (...); set the RTC or give time: in the seed |
Ora harduerike është prapa datës kur është ndërtuar instaluesi. | Caktoni orën në firmware, ose jepni time në seed.yaml, dhe riprovoni. |
FAILED payload: SHA256SUMS signature does not verify |
Skedarët e vetë instaluesit nuk janë ato që ka nënshkruar Adverant. | Ndaloni. Shkarkoni imazhin përsëri dhe kontrollojeni përpara se ta shkruani. |
FAILED seed: the installation domain and the first administrator e-mail are required |
As skedari fillestar dhe as konsola nuk i dhanë ato. | Shtojini ato te seed.yaml ose përgjigjjuni kërkesave në ekran. |
FAILED seed: Enterprise bundle: licence file missing on NEXUS-SEED (licence.json) |
Paketa është Enterprise dhe skedari fillestar nuk ka licencë. | Vendosni licence.json në vëllimin e skedarit fillestar. |
FAILED bundle: no volume labelled NEXUS-BUNDLE within 1 h |
Asnjë paketë nuk u bashkëngjit në kohë. | Bashkëngjitni memorien e paketës dhe riprovoni. |
FAILED bundle: the bundle does not verify with this installer's release key |
Kontrolli i paketës nuk përfundoi me VERIFY-BUNDLE PASS. Rezultati i tij, sipër mesazhit, emërton hapin. |
Ndaloni. Mos e përdorni atë paketë. Merrni një të re. |
FAILED bundle: the seed asks for enterprise, the bundle is community |
Skedari fillestar dhe paketa nuk përputhen. | Rregulloni edition në skedarin fillestar ose sillni paketën e duhur. |
FAILED k3s: node not Ready within 10 min |
k3s nuk u ndez. | Kontrolloni ditarin (journal) për k3s, pastaj riprovoni. |
FAILED nexus: helm install nexus |
Grafiku nuk u instalua brenda afatit kohor (timeout). | Shikoni te kubectl -n nexus get pods,jobs, rrisni timeout në skedarin fillestar nëse makina është e ngadaltë, dhe riprovoni. |
FAILED acceptance: pods not ready |
Disa pode nuk po punojnë pas instalimit. | Mesazhi emërton deri në pesë. Lexoni ngjarjet e tyre, rregullojini, riprovoni. |
FAILED acceptance: jobs not complete: <jobs> |
Një hook Job nuk ka përfunduar. | Lexoni ditarin e Job-it të emërtuar me kubectl -n nexus logs job/<name>, rregulloni atë që raporton dhe riprovoni. |
Përpara se të shkruhet sistemi operativ, zgjedhja e diskut mund ta ndalojë gjithashtu instalimin. Mesazhi i saj fillon me nexus select-disk: REFUSED:. Ai më i zakonshmi është found 2 empty disks of >= 64 GB; need exactly one, or a NEXUS-SEED seed.yaml naming the disk with wipe: true. Emërtoni diskun në skedarin fillestar dhe ndizeni përsëri.
Një kontroll i dështuar i paketës është ai që duhet marrë seriozisht. Kjo do të thotë se skedarët në disk nuk janë skedarët që ka nënshkruar Adverant, ose është shtuar një skedar. Instaluesi nuk ka importuar asgjë në atë pikë, kështu që serveri është i pandryshuar. Mbajeni diskun për ekipin tuaj të sigurisë.

