Útgáfa 1.0.0-alpha.1nýjast
Kafli 2.9
Diskmynd uppsetningarforritsins
Ræstu auðan netþjón eða sýndarvél af uppsetningardiskmynd Nexus og hún setur upp stýrikerfið, k3s, cert-manager og Nexus án nettengingar og sannreynir hverja skrá áður en hún er notuð.
Þ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

Skrifstofa hafnarstjórans á austurbryggju Harrow er með einn netþjón, ekkert netsamband og engan á staðnum sem rekur Kubernetes. Tomás Reilly þurfti engu að síður að fá Nexus upp á honum. Hann skrifaði diskmyndina á USB-lykil (Universal Serial Bus), stakk öðrum litlum lykli við hlið hans með fjórum línum af stillingum og ræsti netþjóninn. Klukkustund síðar sýndi skjárinn vistfang stjórnborðsins og línurnar þrjár sem bæta þurfti við hosts-skrána. Hann sló ekki inn eina einustu Kubernetes-skipun.
Þetta er hlutverk uppsetningardiskmyndarinnar. Hún skrifar lágmarksstýrikerfi á disk netþjónsins, og við fyrstu ræsingu sannreynir hún hverja skrá sem henni fylgir gegn útgáfulykli Adverant, setur upp k3s án nettengingar, flytur inn allar myndir, setur upp cert-manager og Nexus og gengur úr skugga um að hvert pod sé í gangi. Hvert skref stöðvast með tilgreindri ástæðu um leið og eitthvað bregst. Það er engin skert keyrsluleið og ekkert sjálfgefið lykilorð nokkurs staðar.
Diskmyndirnar tvær
Hver útgáfa kemur sem tvenns konar diskmynd, fyrir tvær örgjörvagerðir, amd64 og arm64.
| Skrá | Hvað það geymir | Hver getur sótt hana |
|---|---|---|
nexus-alpha-installer-1.0.0-alpha.1-<arch>.iso |
Aðeins uppsetningarforritið: stýrikerfið, k3s v1.33.6+k3s1, cert-manager v1.21.3 og uppsetningarforritið fyrir fyrstu ræsingu. Það virkar fyrir hvora útgáfuna sem er og inniheldur engar Nexus-myndir. | Hver sem er, af downloads.adverant.ai |
nexus-alpha-<edition>-1.0.0-alpha.1-<arch>.iso |
Sama uppsetningarforrit, en með ótengdum pakka viðkomandi útgáfu bætt við sem annarri disksneið merktri NEXUS-BUNDLE. Einn miðill setur allt upp. |
Community: hver sem er. Enterprise: aðeins af Adverant-reikningnum þínum |
<arch> er amd64 eða arm64 og <edition> er community eða enterprise.
Uppsetningarforritið leitar eingöngu að skráakerfi sem er merkt NEXUS-BUNDLE. Í heildardiskmyndinni er það disksneiðin á diskmyndinni sjálfri. Með diskmyndinni sem inniheldur aðeins uppsetningarforritið kemur þú með pakkann á öðrum diski eða lykli með þeirri merkingu, sem er hentugt þegar sett er upp á nokkrum stöðum af einum uppsetningarlykli og aðeins skipt um pakkann. Kafli 2.10, Uppsetning án nettengingar, lýsir pakkanum.
Enterprise-diskmyndir og Enterprise-pakkar eru aldrei nafnlausir. Þú sækir þá af Adverant-reikningnum þínum á https://account.adverant.ai, á niðurhalssíðunni (Downloads), við hlið leyfisins þíns. Community-diskmyndir og -pakkar eru opinberir.
Úr hverju diskmyndin er byggð
Stýrikerfið er byggt á Debian 13 og er ekki opinber Debian-diskmynd. Það inniheldur grunnkerfi Debian og ekkert annað: enga aukapakka, ekkert skjáborðsumhverfi og engan spegil (mirror). k3s kemur með eigið keyrsluumhverfi gáma og netkerfi. Ræsikeðjan (shim, GRUB, kjarninn og upphafs-ramdiskurinn) er bæti fyrir bæti sú sama og Debian gefur út, þannig að vél með Secure Boot virkt ræsir hana eins og hvert annað Debian-uppsetningarforrit.
Tvær smíðar af sömu útgáfu gefa nákvæmlega eins diskmyndir, bæti fyrir bæti, og útgáfan er ekki birt fyrr en þær gera það. Debian-frumkóðapakkarnir fyrir hverja tvíundarskrá á diskmyndinni eru birtir við hlið hennar sem nexus-alpha-installer-1.0.0-alpha.1-debian-source.tar, í sama gátfjárlista.
Sannreyndu niðurhalið áður en þú skrifar það
Diskmyndamappan á downloads.adverant.ai geymir diskmyndirnar, SHA256SUMS-skrá sem nær yfir allar birtar skrár og SHA256SUMS.sigstore.json, undirskriftina yfir þann lista sem gerð er með útgáfulykli Adverant. Sæktu opinbera útgáfulykilinn í sitthvoru lagi, vistaðu hann sem release.pub og athugaðu fingrafar hans eins og lýst er í kafla 2.4, Að sækja og sannreyna útgáfu.
- Sannreyndu undirskriftina á gátfjárlistanum. Það er engin gagnsæisskrá (transparency log) fyrir Nexus-útgáfur, þannig að flaggið sem sleppir uppflettingu í skránni er nauðsynlegt.
cosign verify-blob --key release.pub --insecure-ignore-tlog=true \
--bundle SHA256SUMS.sigstore.json SHA256SUMSVerified OK
- Athugaðu diskmyndina sem þú sóttir gegn listanum:
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
Á Mac skaltu nota shasum -a 256 -c - í stað sha256sum -c -.
- Skrifaðu diskmyndina á USB-lykil með því tóli sem þú notar venjulega, eða tengdu hana við sýndarvélina sem geisladisk.
k3s birtir gátfjárhæðir fyrir útgáfuskrár sínar en enga undirskrift, þannig að k3s-skrárnar inni í diskmyndinni eru athugaðar gegn þeim gátfjárhæðum sem k3s birtir, frá sama uppruna og skrárnar. Allt sem Adverant smíðaði er undirritað.
Pakkar í hlutum
Pakki sem þú ert með á sérstökum lykli er nokkur gígabæti. Sum skráakerfi, þar á meðal FAT (File Allocation Table), geta ekki geymt skrá sem er 4 GiB eða stærri, þannig að pakkaskrár eru birtar í 2047 MiB hlutum sem passa á hvaða lykil sem er. Settu hlutana aftur saman í réttri röð og athugaðu samsettu skrána gegn .sha256 hennar áður en þú notar hana.
Vélbúnaðurinn sem þarf
Fyrsta ræsing athugar vélina áður en hún snertir nokkuð og neitar að halda áfram ef vélin er of lítil.
| Athugun | Gólfið | Hvenær athugað |
|---|---|---|
| Kerfishönnun | Sama og diskmyndarinnar: amd64-diskmynd á amd64, arm64 á arm64 | Fyrsta ræsing |
| Vinnsluminni | 16 GiB | Fyrsta ræsing |
| Markdiskur | Nákvæmlega einn tómur diskur sem er að minnsta kosti 64 GB, eða diskurinn sem frumstillingin (seed) tilgreinir | Áður en stýrikerfið er skrifað |
Laust pláss á / |
50 GB eftir að stýrikerfið er komið á sinn stað | Fyrsta ræsing |
| Klukka | Ekki eldri en dagsetningin þegar diskmyndin var smíðuð | Fyrsta ræsing |
Þetta eru lágmörk, ekki ráðlegging. Með sjálfgefnum stillingum Helm-kortsins (chart) nema gagnahirslur Nexus einar og sér 142 GiB, þannig að 64 GB diskur stenst uppsetningarforritið en fyllist á nokkrum dögum. Notaðu það sem stakur hnútur ætti að hafa: 8 vCPU (sýndarörgjörva), 32 GiB af vinnsluminni og 250 GB SSD-disk (solid-state drive). Fjórir vCPU, 16 GiB og 200 GB duga fyrir prófun.
Klukkuathugunin er til staðar vegna þess að netþjónninn hefur enga nettengingu, og þar með enga tímaþjónustu, við uppsetningu. Skilríki og undirskriftir eru sannreynd gegn klukkunni. Ef vélbúnaðarklukka vélarinnar er á eftir smíðadagsetningu diskmyndarinnar stöðvast fyrsta ræsing og biður þig um að stilla hana. Stilltu hana í fastbúnaðarstillingunum (firmware setup) og ræstu aftur.
Raunþjónar og sýndarvélar
Diskmyndin ræsist á UEFI-fastbúnaði (Unified Extensible Firmware Interface), jafnt á raunþjónum sem sýndarvélum. Hún setur ræsistjórann upp á slóðinni fyrir útskiptanlega miðla sem og á hinni hefðbundnu, þannig að sýndarvél (VM) án vistaðra ræsifærslna finnur hann samt eftir fyrstu endurræsingu. Gefðu sýndarvél vinnsluminnið og diskplássið í töflunni hér að ofan, einn tóman sýndardisk og diskmyndina sem geisladisk.
Uppsetningarforritið velur markdiskinn eftir strangri reglu og velur aldrei „fyrsta diskinn“.
- Það sleppir miðlinum sem það ræsti af.
- Það sleppir útskiptanlegum diskum, nema frumstillingin (seed) tilgreini einn slíkan.
- Það sleppir öllum diskum sem eru þegar með disksneiðatöflu, af hvorri gerðinni sem er.
- Það sleppir diskum undir 64 GB og tekur það fram á stjórnborðinu.
- Það setur aðeins upp þegar nákvæmlega einn diskur stendur eftir.
Á netþjóni með tvo tóma diska stöðvast það og biður þig um að velja. Þú velur með því að nefna diskinn í frumstillingunni, með wipe: true, sem er eina leiðin til að fá það til að skrifa á disk sem er þegar með disksneiðar.
NEXUS-SEED gagnageymslan
Frumstillingin (seed) er lítil gagnahirsla, venjulega USB-lykill, með skráakerfi merktu NEXUS-SEED og skránni seed.yaml í efsta þrepi. Uppsetningarforritið tengir hana í ritvarinn ham (read-only), les stillingarnar og tengir hana skrifanlega aftur alveg í lokin, til að skilja stýrikerfislykilorðið eftir handa þér.
# seed.yaml on the NEXUS-SEED volume
domain: harrow.example
adminEmail: aoife.brennan@harrow.example
edition: enterprise
timeout: 45m| Lykill | Hvað það stillir | Þegar það vantar |
|---|---|---|
domain |
Lén uppsetningarinnar. Uppsetningarforritið leiðir vélarheitin þrjú af því: console.<domain>, api.<domain> og auth.<domain>. |
Spurt á stjórnborði netþjónsins |
adminEmail |
Netfang þess aðila sem verður fyrsti kerfisstjórinn | Spurt á stjórnborði netþjónsins |
edition |
community eða enterprise. Þegar þetta er stillt verður það að passa við útgáfu pakkans. |
Tekið úr pakkanum |
timeout |
Hversu langan tíma uppsetning á cert-manager og Nexus má taka, sem tímalengd á borð við 30m eða 1h |
30m |
time |
Núverandi tími í UTC, á því sniði sem klukkuskilaboðin birta (2026-11-14T09:00:00Z), fyrir vél þar sem ekki er hægt að stilla vélbúnaðarklukkuna eða hún heldur ekki stillingu sinni. Ótengd vél hefur engan tímaþjón til að spyrja. |
Vélbúnaðarklukkan er notuð |
disk |
Markdiskurinn, sem /dev/<name>, aðeins notað ásamt wipe: true |
Reglan um tóman disk hér að ofan |
wipe |
true leyfir uppsetningarforritinu að eyða út af disknum sem disk tilgreinir |
Engum diski er nokkurn tímann eytt |
Fyrir Enterprise skaltu setja leyfisskrána á sömu gagnahirslu sem licence.json. Án hennar stöðvast fyrsta ræsing við frumstillingarskrefið og segir að leyfið vanti. Community þarf ekkert leyfi og fyrir Community er öll frumstillingin valkvæð: uppsetningarforritið biður um lénið og netfangið á stjórnborðinu og heldur svo áfram.
Uppsetningarforritið les hverja línu sem key: value í upphafi línunnar. Skrifaðu einn lykil í hverja línu, á efsta þrepi, án gæsalappa og án inndráttar. Gildi innan gæsalappa er lesið með gæsalöppunum.
Við fyrstu ræsingu biður uppsetningarforritið einnig á stjórnborðinu um vörsluaðila (custodian) lyklageymslunnar: opinbera hluta age-lykils, age1..., sem búinn er til á eigin vél vörsluaðilans með age-keygen -o custodian.key. Lyklageymslan innsiglar endurheimtunarlykla sína við hann. Kafli 2.8, Uppsetningar á stakri vél, útskýrir vörsluaðila. Vörsluaðilinn geymir einkahlutann ótengdan og á öruggum stað: án hans getur enginn opnað innsigli lyklageymslunnar eftir endurræsingu.
Hvað gerist, frá því að kveikt er á vél og þar til vistfang stjórnborðsins birtist
Fyrsta stig: stýrikerfið
Diskmyndin ræsist í sjálfvirkt Debian-uppsetningarforrit. Það stillir ekki netkerfi, notar ekki spegil né setur upp neina pakka umfram grunnkerfið. Það stillir tímabeltið á UTC (Coordinated Universal Time), gerir innskráningu sem root óvirka og býr til einn notanda, nexus, með læstu lykilorði. Það velur markdiskinn samkvæmt reglunni hér að ofan og skrifar GPT-disk (globally unique identifier partition table) með EFI-kerfissneið (Extensible Firmware Interface) og einu ext4-rótarskráakerfi, án diskminnis (swap).
Að lokum afritar það Nexus-uppsetningarforritið yfir á nýja kerfið, athugar hverja afritaða skrá gegn gátfjárlista diskmyndarinnar og virkjar þjónustu fyrir fyrstu ræsingu. Ef einhver afrituð skrá passar ekki stöðvast það þar. Síðan spýtir það miðlinum út og endurræsir.
Annað stig: fyrsta ræsing
Við fyrstu ræsingu keyrir þjónustan nexus-install einu sinni. Hvert skref prentast á stjórnborð netþjónsins og í atburðaskrána (journal), og skráir sig sem lokið, þannig að ný tilraun byrjar á fyrsta skrefinu sem er ólokið. Þjónustan í heild má keyra í allt að fjórar klukkustundir áður en systemd stöðvar hana, sem gefur svigrúm fyrir hægan disk og klukkustundar bið eftir pakkalyklinum.
- Forathugun (Preflight). Örgjörvagerðin, klukkan, vinnsluminnið og laust diskpláss, eins og í töflunni hér að ofan.
- Farmur (Payload). Eigin skrár uppsetningarforritsins: undirskriftin á gátfjárlista þess með útgáfulyklinum sem því fylgir, og síðan hver skrá gegn þeim lista.
- Frumstilling (Seed). Les
seed.yamlog biður á stjórnborðinu um allt sem vantar. - Pakki (Bundle). Finnur gagnahirsluna sem er merkt
NEXUS-BUNDLEog tengir hana í ritvarinn ham. Ef engin slík finnst segir þaðwaiting-for-bundleog bíður í allt að klukkustund eftir að þú tengir hana. Síðan keyrir það fulla pakkaathugun sem endar áVERIFY-BUNDLE PASS, með útgáfulyklinum sem því fylgir, áður en nokkuð er flutt inn. Enterprise-pakki krefstlicence.jsoná frumstillingunni og útgáfa frumstillingarinnar verður að passa við útgáfu pakkans. - k3s. Setur upp k3s v1.33.6+k3s1 úr eigin skrám diskmyndarinnar með slökkt á niðurhali og bíður í allt að tíu mínútur eftir að hnúturinn verði tilbúinn (Ready). Síðan fjarlægir það safnskrá k3s fyrir ótengdar myndir, svo myndirnar séu ekki fluttar inn aftur við hverja ræsingu.
- Innflutningur (Import). Flytur inn allar sannreyndar myndir úr pakkanum, sem og myndir cert-manager, í gámageymslu hnútsins. Ekkert er nokkurn tímann sótt úr myndasafni (registry).
- cert-manager, síðan Nexus. Setur upp cert-manager v1.21.3, og síðan Nexus-kortið úr pakkanum, hvort tveggja innan
timeoutfrumstillingarinnar. - Samþykkt (Acceptance). Gengur úr skugga um að hvert pod sé í stöðunni Running og að hverju hook Job sé lokið.
- Auðkenni (Credential). Gefur stýrikerfisnotandanum
nexusnýtt slembilykilorð, sýnir það einu sinni á stjórnborðinu og skrifar það ínexus-os-password.txtá frumstillingarhirslunni þegar hægt er að skrifa á hana.
Pakkaathugunin í skrefi 4 er sama skrifta og þú keyrir handvirkt í kafla 2.10, Uppsetning án nettengingar, og hún prentar sömu línur:
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>
Lína 3 telur myndirnar sem bera gilda undirskrift og undirritað SBOM (software bill of materials), listann yfir það sem hver mynd inniheldur. Fjöldinn (<n>) fer eftir útgáfunni. Það sem skiptir máli er síðasta línan.
Uppsetningin skrifar gildi á núverandi sniði kortsins: global.domain og hosts.*-nöfnin þrjú út frá léni frumstillingarinnar, og keys.custody.recipients út frá vörsluaðilanum sem þú gafst upp á stjórnborðinu. Hún setur upp úr eigin korti og myndum pakkans, þannig að útgáfan á disknum er nákvæmlega sú útgáfa sem var sannreynd.
Síðustu línurnar á stjórnborðinu
Þegar öll skref hafa gengið í gegn sýnir stjórnborðið stýrikerfislykilorðið einu sinni og vistfangið sem á að opna:
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)
Skrifaðu lykilorðið niður eða taktu það af frumstillingarlyklinum, skráðu þig svo inn sem nexus og breyttu því með passwd. Enginn, ekki heldur Adverant, þekkir sjálfgefið lykilorð fyrir þessa vél, vegna þess að það er ekkert til.
Vistfangið í hosts-línunni er vistfang netþjónsins sjálfs. Þar sem ekkert DNS (Domain Name System) var á bryggjunni bætti Tomás þessari einu línu við hosts-skrána á hverri fartölvu sem átti að nota stjórnborðið. Á stað með DNS skaltu í staðinn bæta við færslum fyrir nöfnin þrjú.
Eftir uppsetninguna
Uppsetningin er óskráð (unclaimed). Enginn getur skráð sig inn fyrr en einhver gerir tilkall til hennar í vafra og ber fingrafar uppsetningarinnar saman við það sem netþjónninn sýnir. Kafli 2.12, Fyrsta keyrsla, fjallar um tilkallið, fyrsta kerfisstjórann og aðgangslykilinn (passkey). Fyrsti kerfisstjórinn ætti að vera sá aðili sem á netfangið í frumstillingunni.
Eigið kubeconfig hnútsins er á /etc/rancher/k3s/k3s.yaml, aðeins læsilegt fyrir root. Til að vinna á klasanum frá vinnustöð prentar nexusctl kubeconfig það út, eins og lýst er í kafla 2.8, Uppsetningar á stakri vél.
Uppfærslur berast á sama hátt og uppsetningin: útgáfa á undirrituðum miðli, sannreynd gegn lyklinum sem þegar er uppsettur á netþjóninum og aldrei gegn lykli sem diskurinn kemur með sér. Kafli 2.10, Uppsetning án nettengingar, lýsir þeirri athugun.
Ef þetta mistekst
Hver bilun prentar nexus-install: FAILED <step>: <what is missing> á stjórnborðið og skrifar það sama í /var/lib/nexus/install.state. Lagaðu orsökina og keyrðu uppsetninguna aftur frá fyrsta skrefinu sem er ólokið:
sudo nexus-install retry| Skilaboð | Hvað það þýðir | Hvað skal gera |
|---|---|---|
FAILED preflight: payload is for arm64, this machine is amd64 |
Þú ræstir diskmynd fyrir hina örgjörvagerðina. | Notaðu diskmyndina fyrir örgjörvagerð þessarar vélar. |
FAILED preflight: memory 11 GiB, need >= 16 GiB |
Vélin er með minna en lágmarkið. | Bættu við vinnsluminni, eða gefðu sýndarvélinni meira. |
FAILED preflight: free disk 38 GB on /, need >= 50 GB |
Rótarskráakerfið er of lítið. | Settu upp á stærri diski. |
FAILED preflight: the clock (...) is older than the build (...); set the RTC or give time: in the seed |
Vélbúnaðarklukkan er á eftir dagsetningunni þegar uppsetningarforritið var smíðað. | Stilltu klukkuna í fastbúnaðinum, eða gefðu upp time í seed.yaml, og reyndu aftur. |
FAILED payload: SHA256SUMS signature does not verify |
Eigin skrár uppsetningarforritsins eru ekki þær sem Adverant undirritaði. | Stöðvaðu. Sæktu diskmyndina aftur og athugaðu hana áður en hún er skrifuð. |
FAILED seed: the installation domain and the first administrator e-mail are required |
Hvorki frumstillingin né stjórnborðið gáfu þau upp. | Bættu þeim við seed.yaml eða svaraðu beiðnunum. |
FAILED seed: Enterprise bundle: licence file missing on NEXUS-SEED (licence.json) |
Pakkinn er Enterprise og frumstillingin er ekki með neitt leyfi. | Settu licence.json á frumstillingarhirsluna. |
FAILED bundle: no volume labelled NEXUS-BUNDLE within 1 h |
Enginn pakki var tengdur í tæka tíð. | Tengdu pakkalykilinn og reyndu aftur. |
FAILED bundle: the bundle does not verify with this installer's release key |
Pakkaathugunin endaði ekki á VERIFY-BUNDLE PASS. Eigið úttak hennar, fyrir ofan skilaboðin, nefnir skrefið. |
Stöðvaðu. Ekki nota þennan pakka. Fáðu þér nýjan. |
FAILED bundle: the seed asks for enterprise, the bundle is community |
Frumstillingunni og pakkanum ber ekki saman. | Lagaðu edition í frumstillingunni eða komdu með réttan pakka. |
FAILED k3s: node not Ready within 10 min |
k3s fór ekki í gang. | Athugaðu atburðaskrána (journal) fyrir k3s og reyndu svo aftur. |
FAILED nexus: helm install nexus |
Kortið settist ekki upp innan tímamarkanna. | Skoðaðu kubectl -n nexus get pods,jobs, hækkaðu timeout í frumstillingunni ef vélin er hæg, og reyndu aftur. |
FAILED acceptance: pods not ready |
Sum pod eru ekki í gangi eftir uppsetninguna. | Skilaboðin nefna allt að fimm. Lestu atburði (events) þeirra, lagaðu og reyndu aftur. |
FAILED acceptance: jobs not complete: <jobs> |
Hook Job hefur ekki klárast. | Lestu atburðaskrá nefnds Job með kubectl -n nexus logs job/<name>, lagaðu það sem hún greinir frá, og reyndu aftur. |
Áður en stýrikerfið er skrifað getur diskvalið einnig stöðvað uppsetninguna. Skilaboð þess byrja á nexus select-disk: REFUSED:. Algengustu skilaboðin eru found 2 empty disks of >= 64 GB; need exactly one, or a NEXUS-SEED seed.yaml naming the disk with wipe: true. Nefndu diskinn í frumstillingunni og ræstu aftur.
Misheppnuð pakkaathugun er það sem taka ber alvarlega. Hún þýðir að skrárnar á disknum eru ekki skrárnar sem Adverant undirritaði, eða að skrá var bætt við. Uppsetningarforritið hefur ekkert flutt inn á þeim tímapunkti, þannig að netþjónninn er óbreyttur. Geymdu diskinn fyrir öryggisteymið þitt.

