Versioon 1.0.0-alpha.1uusim
Peatükk 2.9
Paigaldaja kettatõmmis
Alglaadige tühi server või virtuaalmasin Nexuse paigaldaja tõmmiselt ning see paigaldab operatsioonisüsteemi, k3s-i, cert-manager-i ja Nexuse ilma võrguühenduseta, kontrollides iga faili enne kasutamist.
Selle lehe tõlkis AI ingliskeelsest originaalist. Kui miski jääb ebaselgeks, võtke aluseks ingliskeelne leht. Lugege seda lehte inglise keeles

Harrow' idakail asuvas sadamakapteni kontoris on üks server, puudub internet ja kohapeal pole kedagi, kes haldaks Kubernetest. Tomás Reilly vajas sellesse siiski Nexust. Ta kirjutas tõmmise USB-mälupulgale (Universal Serial Bus), pani selle kõrvale teise, väikese mälupulga nelja seadistusreaga ja käivitas serveri. Tund aega hiljem kuvas ekraan konsooli aadressi ja kolm rida, mis tuli lisada faili hosts. Ta ei sisestanud ühtegi Kubernetese käsku.
See on paigaldaja kettatõmmise ülesanne. See kirjutab serveri kettale minimaalse operatsioonisüsteemi, seejärel kontrollib esmakäivitamisel iga kaasasolevat faili Adveranti väljalaskevõtme vastu, paigaldab ilma võrguta k3s-i, impordib kõik tõmmised, paigaldab cert-manageri ja Nexuse ning kontrollib, kas iga pod töötab. Iga samm peatub nimetatud põhjusega kohe, kui miski on valesti. Puudub piiratud funktsionaalsusega varuvariant ja kusagil pole vaikeparooli.
Kaks tõmmist
Iga väljalase tuleb kahte tüüpi tõmmisena kahele protsessoriarhitektuurile: amd64 ja arm64.
| Fail | Mida see sisaldab | Kes saab selle alla laadida |
|---|---|---|
nexus-alpha-installer-1.0.0-alpha.1-<arch>.iso |
Ainult paigaldaja: operatsioonisüsteem, k3s v1.33.6+k3s1, cert-manager v1.21.3 ja esmakäivituse paigaldaja. See töötab mõlema väljaandega ega sisalda Nexuse tõmmiseid. | Igaüks, aadressilt downloads.adverant.ai |
nexus-alpha-<edition>-1.0.0-alpha.1-<arch>.iso |
Sama paigaldaja, millele on teise partitsioonina sildiga NEXUS-BUNDLE lisatud selle väljaande võrguühenduseta komplekt. Üks andmekandja paigaldab kõik. |
Community: igaüks. Enterprise: ainult teie Adveranti kontolt |
<arch> on amd64 või arm64 ning <edition> on community või enterprise.
Paigaldaja otsib alati ainult failisüsteemi sildiga NEXUS-BUNDLE. Kõik-ühes-tõmmise puhul on see partitsioon tõmmisel endal. Ainult paigaldajaga tõmmise puhul toote komplekti teisel sama sildiga kettal või mälupulgal, mis on mugav, kui paigaldate ühelt paigaldaja mälupulgalt mitu asukohta ja vahetate ainult komplekti. Komplekti kirjeldab peatükk 2.10, „Õhuvahega paigaldus”.
Enterprise'i tõmmised ja Enterprise'i komplektid ei ole kunagi anonüümsed. Laadite need alla oma Adveranti kontolt aadressil https://account.adverant.ai, lehelt Allalaadimised, oma litsentsi kõrvalt. Community tõmmised ja komplektid on avalikud.
Millest tõmmis on koostatud
Operatsioonisüsteem põhineb Debian 13-l ega ole ametlik Debiani tõmmis. See sisaldab Debiani baassüsteemi ja mitte midagi muud: ei mingeid lisapakette, töölauda ega peegelserverit. k3s toob kaasa oma konteinerite käituskeskkonna ja võrgustiku. Alglaadimisahel (shim, GRUB, tuum ja esialgne RAM-ketas) on bait-baidilt sama, mida tarnib Debian, seega käivitab sisselülitatud Secure Bootiga masin selle nagu iga Debiani paigaldaja.
Sama väljalaske kaks kompileerimist annavad bait-baidilt identsed tõmmised ning väljalaset ei avaldata enne, kui see nii on. Tõmmisel oleva iga binaarfaili Debiani lähtekoodipaketid avaldatakse selle kõrval nimega nexus-alpha-installer-1.0.0-alpha.1-debian-source.tar samas kontrollsummade loendis.
Kontrollige allalaaditud faili enne kirjutamist
Tõmmiste kataloog aadressil downloads.adverant.ai sisaldab tõmmiseid, faili SHA256SUMS, mis katab iga avaldatud faili, ja faili SHA256SUMS.sigstore.json, mis on Adveranti väljalaskevõtmega tehtud allkiri selle loendi üle. Hankige väljalaske avalik võti eraldi, salvestage see nimega release.pub ja kontrollige selle sõrmejälge, nagu kirjeldab peatükk 2.4, „Väljalaske hankimine ja kontrollimine”.
- Kontrollige kontrollsummade loendi allkirja. Nexuse väljalasete jaoks puudub läbipaistvuslogi, seega on logiotsingut vahele jättev lipp nõutav.
cosign verify-blob --key release.pub --insecure-ignore-tlog=true \
--bundle SHA256SUMS.sigstore.json SHA256SUMSVerified OK
- Kontrollige allalaaditud tõmmist loendi vastu:
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
Macis kasutage sha256sum -c - asemel käsku shasum -a 256 -c -.
- Kirjutage tõmmis USB-mälupulgale tööriistaga, mida tavaliselt kasutate, või ühendage see virtuaalmasinaga optilise kettana.
k3s avaldab oma väljalaskefailide jaoks kontrollsummad, kuid mitte allkirja, seega kontrollitakse tõmmise sees olevaid k3s-i faile k3s-i avaldatud kontrollsummade vastu, mis pärinevad failidega samast allikast. Kõik Adveranti loodu on allkirjastatud.
Komplektid osadena
Komplekt, mida kannate eraldi mälupulgal, on mitu gigabaiti suur. Mõned failisüsteemid, nende seas FAT (File Allocation Table), ei suuda hoida 4 GiB või suuremat faili, seega avaldatakse komplektifailid 2047 MiB suuruste osadena, mis mahuvad igale mälupulgale. Ühendage osad õiges järjekorras tagasi kokku ja kontrollige ühendatud faili enne kasutamist selle .sha256 vastu.
Vajalik riistvara
Esmakäivitus kontrollib masinat enne millegi puutumist ja keeldub jätkamast, kui masin on liiga väike.
| Kontroll | Alustase | Millal kontrollitakse |
|---|---|---|
| Arhitektuur | Tõmmise enda oma: amd64 tõmmis amd64-l, arm64 arm64-l | Esmakäivitus |
| Mälu | 16 GiB | Esmakäivitus |
| Sihtketas | Täpselt üks tühi ketas mahuga vähemalt 64 GB või ketas, mille nimetab algseadistus (seed) | Enne operatsioonisüsteemi kirjutamist |
Vaba ruum asukohas / |
50 GB pärast operatsioonisüsteemi paigaldamist | Esmakäivitus |
| Kell | Mitte vanem kui tõmmise loomise kuupäev | Esmakäivitus |
Need on alampiirid, mitte soovitus. Charti vaikeväärtustega annavad ainuüksi Nexuse andmemahud kokku 142 GiB, seega läbib 64 GB ketas paigaldaja kontrolli ja täitub päevadega. Kasutage seda, mis ühel sõlmel peaks olema: 8 vCPU-d (virtuaalset keskprotsessorit), 32 GiB mälu ja 250 GB SSD (pooljuhtketas). Katsetamiseks piisab neljast vCPU-st, 16 GiB-st ja 200 GB-st.
Kella kontroll on vajalik, kuna serveril pole paigaldamise ajal võrku ja seega ka ajateenust. Sertifikaate ja allkirju kontrollitakse kella suhtes. Kui masina riistvaraline kell on tõmmise loomise kuupäevast taga, peatub esmakäivitus ja palub teil see õigeks seada. Seadke see püsivara seadistuses õigeks ja käivitage uuesti.
Füüsilised serverid ja virtuaalmasinad
Tõmmis käivitub UEFI (Unified Extensible Firmware Interface) püsivaral nii füüsilistes serverites kui ka virtuaalmasinates. See paigaldab alglaaduri nii irdandmekandja asukohta kui ka tavalisse asukohta, nii et salvestatud alglaadimiskirjeteta VM (virtuaalmasin) leiab selle pärast esimest taaskäivitust siiski üles. Andke VM-ile ülaltoodud tabelis näidatud mälu ja kettamaht, üks tühi virtuaalketas ja tõmmis CD-na.
Paigaldaja valib sihtketta range reegli järgi ega vali kunagi „esimest ketast”.
- See jätab vahele andmekandja, millelt see käivitati.
- See jätab vahele irdkettad, välja arvatud juhul, kui algseadistus (seed) mõnda neist nimetab.
- See jätab vahele iga ketta, millel on juba emb-kumb partitsioonitabel.
- See jätab vahele alla 64 GB kettad ja teatab sellest konsoolil.
- See paigaldab ainult siis, kui alles jääb täpselt üks ketas.
Kahe tühja kettaga serveris see peatub ja palub teil valida. Valite ketta nimetamisega algseadistuses võtmega wipe: true, mis on ainus viis, kuidas see üldse kirjutab kettale, millel on juba partitsioonid.
Andmekandja NEXUS-SEED
Algseadistus (seed) on väike andmemaht, tavaliselt USB-mälupulk, millel on failisüsteem sildiga NEXUS-SEED ja selle ülemisel tasemel fail seed.yaml. Paigaldaja haagib selle kirjutuskaitstult, loeb seadistused ja haagib selle uuesti kirjutatavana alles päris lõpus, et jätta teile operatsioonisüsteemi parool.
# seed.yaml on the NEXUS-SEED volume
domain: harrow.example
adminEmail: aoife.brennan@harrow.example
edition: enterprise
timeout: 45m| Võti | Mida see määrab | Kui see puudub |
|---|---|---|
domain |
Paigalduse domeen. Paigaldaja tuletab sellest kolm hosti: console.<domain>, api.<domain> ja auth.<domain>. |
Küsitakse serveri konsoolil |
adminEmail |
Selle isiku e-posti aadress, kellest saab esimene administraator | Küsitakse serveri konsoolil |
edition |
community või enterprise. Kui see on määratud, peab see ühtima komplekti väljaandega. |
Võetakse komplektist |
timeout |
Kui kaua võivad cert-manageri ja Nexuse paigaldus aega võtta, kestusena nagu 30m või 1h |
30m |
time |
Praegune kellaaeg UTC-s kujul, mille prindib kellateade (2026-11-14T09:00:00Z), masina jaoks, mille riistvaralist kella ei saa seadistada või mis ei hoia oma seadistust. Võrguühenduseta masinal pole ajaserverit, millelt küsida. |
Kasutatakse riistvaralist kella |
disk |
Sihtketas kujul /dev/<name>, kasutatakse ainult koos võtmega wipe: true |
Ülaltoodud tühja ketta reegel |
wipe |
true lubab paigaldajal kustutada ketta, mida disk nimetab |
Ühtegi ketast ei kustutata kunagi |
Enterprise'i puhul pange litsentsifail samale andmemahule nimega licence.json. Ilma selleta peatub esmakäivitus algseadistuse sammul ja ütleb, et litsents puudub. Community ei vaja litsentsi ja Community puhul on kogu algseadistus valikuline: paigaldaja küsib domeeni ja e-posti aadressi konsoolil ning jätkab.
Paigaldaja loeb iga rida kui key: value rea alguses. Kirjutage üks võti rea kohta, ülemisel tasemel, ilma jutumärkide ja taandeta. Jutumärkides väärtust loetakse koos jutumärkidega.
Esmakäivitusel küsib paigaldaja konsoolil ka võtmehoidla haldurit (custodian): age-võtme avalikku poolt age1..., mis on loodud halduri enda masinas käsuga age-keygen -o custodian.key. Võtmehoidla pitseerib oma taastevõtmed sellega. Haldureid selgitab peatükk 2.8, „Ühe masina paigaldused”. Haldur hoiab privaatset poolt võrguühenduseta ja turvaliselt: ilma selleta ei saa keegi võtmehoidlat pärast taaskäivitust avada.
Mis toimub sisselülitamisest kuni konsooli aadressini
Esimene etapp: operatsioonisüsteem
Tõmmis käivitub järelevalveta Debiani paigaldajasse. See ei seadista võrku, ei kasuta peegelserverit ega paigalda ühtegi paketti peale baassüsteemi. See seab ajavööndiks UTC (maailmaaeg), keelab juurkasutaja (root) sisselogimise ja loob ühe kasutaja, nexus, kelle parool on lukustatud. See valib sihtketta ülaltoodud reegli järgi ja kirjutab GPT-ketta (globally unique identifier partition table) koos EFI (Extensible Firmware Interface) süsteemipartitsiooni ja ühe ext4-juurfailisüsteemiga, ilma saalealata (swap).
Lõpus kopeerib see Nexuse paigaldaja uude süsteemi, kontrollib iga kopeeritud faili tõmmise kontrollsummade loendi vastu ja lubab esmakäivituse teenuse. Kui mõni kopeeritud fail ei klapi, peatub see seal. Seejärel väljutab see andmekandja ja taaskäivitub.
Teine etapp: esmakäivitus
Esmakäivitusel käivitub teenus nexus-install üks kord. Iga samm prinditakse serveri konsoolile ja logisse (journal) ning märgib end tehtuks, nii et uuesti proovimine algab esimesest sammust, mis pole tehtud. Teenus tervikuna võib töötada kuni neli tundi, enne kui systemd selle peatab, mis jätab aega aeglasele kettale ja tunnisele ootamisele komplekti mälupulga järele.
- Eelkontroll (Preflight). Arhitektuur, kell, mälu ja vaba kettaruum, nagu ülaltoodud tabelis.
- Last (Payload). Paigaldaja enda failid: allkiri selle kontrollsummade loendil kaasasoleva väljalaskevõtmega, seejärel iga fail selle loendi vastu.
- Algseadistus (Seed). Loeb faili
seed.yamlja küsib konsoolil kõike, mis on puudu. - Komplekt (Bundle). Leiab andmemahu sildiga
NEXUS-BUNDLEja haagib selle kirjutuskaitstult. Kui seda pole, ütleb seewaiting-for-bundleja ootab kuni tund aega, et te selle ühendaksite. Seejärel käivitab see enne millegi importimist kaasasoleva väljalaskevõtmega täieliku komplekti kontrolli, mis lõpeb teategaVERIFY-BUNDLE PASS. Enterprise'i komplekt vajab algseadistusel faililicence.jsonning algseadistuse väljaanne peab ühtima komplekti omaga. - k3s. Paigaldab tõmmise enda failidest k3s v1.33.6+k3s1 väljalülitatud allalaadimistega ja ootab kuni kümme minutit, et sõlm saavutaks oleku Ready. Seejärel eemaldab see k3s-i õhuvahega tõmmiste arhiivi, et tõmmiseid ei imporditaks igal käivitamisel uuesti.
- Import. Impordib iga kontrollitud tõmmise komplektist ja cert-manageri tõmmised sõlme konteinerihoidlasse. Midagi ei tõmmata kunagi registrist.
- cert-manager, seejärel Nexus. Paigaldab cert-manager v1.21.3, seejärel komplektist Nexuse charti, mõlemad algseadistuse
timeoutpiires. - Vastuvõtukontroll (Acceptance). Kontrollib, kas iga pod on olekus Running ja iga haagi Job on lõpetatud.
- Mandaat (Credential). Annab operatsioonisüsteemi kasutajale
nexusuue juhusliku parooli, näitab seda üks kord konsoolil ja kirjutab selle algseadistuse andmemahul failinexus-os-password.txt, kui andmemahule saab kirjutada.
Komplekti kontroll 4. sammus on sama skript, mille käivitate käsitsi peatükis 2.10, „Õhuvahega paigaldus”, ja see prindib samad read:
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>
3. rida loendab tõmmiseid, millel on kehtiv allkiri ja allkirjastatud SBOM (tarkvara koostisosade loend), mis näitab, mida iga tõmmis sisaldab. Arvud (<n>) sõltuvad väljaandest. Oluline on viimane rida.
Paigaldus kirjutab väärtused charti praegusel kujul: global.domain ja kolm hosts.* nime algseadistuse domeenist ning keys.custody.recipients haldurist, mille andsite konsoolil. See paigaldab komplekti enda chartist ja tõmmistest, nii et kettal olev väljalase on täpselt see väljalase, mida kontrolliti.
Viimased read konsoolil
Kui iga samm on läbitud, näitab konsool üks kord operatsioonisüsteemi parooli ja avatavat aadressi:
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)
Kirjutage parool üles või võtke see algseadistuse mälupulgalt, seejärel logige sisse kasutajana nexus ja muutke see käsuga passwd. Mitte keegi, sealhulgas Adverant, ei tea selle masina vaikeparooli, sest seda pole olemas.
Aadress real hosts on serveri enda oma. Kuna kail puudus DNS (domeeninimede süsteem), lisas Tomás selle ühe rea iga sülearvuti faili hosts, mis pidi konsooli kasutama. DNS-iga asukohas lisage selle asemel kirjed kolmele nimele.
Pärast paigaldamist
Paigaldus on omastamata. Keegi ei saa sisse logida enne, kui keegi selle brauseris omastab, võrreldes paigalduse sõrmejälge sellega, mida näitab server. Peatükk 2.12, „Esimene käivitus”, käsitleb omastamist, esimest administraatorit ja pääsuvõtit (passkey). Esimene administraator peaks olema isik, kelle e-posti aadress on algseadistuses.
Sõlme enda kubeconfig asub aadressil /etc/rancher/k3s/k3s.yaml ja on loetav ainult juurkasutajale (root). Klastriga tööjaamast töötamiseks prindib selle nexusctl kubeconfig, nagu kirjeldab peatükk 2.8, „Ühe masina paigaldused”.
Uuendused saabuvad samamoodi nagu paigaldus: väljalase allkirjastatud andmekandjal, mida kontrollitakse serverisse juba paigaldatud võtme vastu ja mitte kunagi võtme vastu, mille ketas ise kaasa toob. Seda kontrolli kirjeldab peatükk 2.10, „Õhuvahega paigaldus”.
Kui see ebaõnnestub
Iga tõrge prindib konsoolile nexus-install: FAILED <step>: <what is missing> ja kirjutab sama faili /var/lib/nexus/install.state. Parandage põhjus ja käivitage paigaldus uuesti esimesest sammust, mis pole tehtud:
sudo nexus-install retry| Teade | Mida see tähendab | Mida teha |
|---|---|---|
FAILED preflight: payload is for arm64, this machine is amd64 |
Käivitasite teise arhitektuuri tõmmise. | Kasutage selle masina arhitektuurile mõeldud tõmmist. |
FAILED preflight: memory 11 GiB, need >= 16 GiB |
Masinal on alampiirist vähem mälu. | Lisage mälu või andke VM-ile rohkem. |
FAILED preflight: free disk 38 GB on /, need >= 50 GB |
Juurfailisüsteem on liiga väike. | Paigaldage suuremale kettale. |
FAILED preflight: the clock (...) is older than the build (...); set the RTC or give time: in the seed |
Riistvaraline kell on paigaldaja loomise kuupäevast taga. | Seadke kell püsivaras õigeks või andke time failis seed.yaml ja proovige uuesti. |
FAILED payload: SHA256SUMS signature does not verify |
Paigaldaja enda failid ei ole need, mille Adverant allkirjastas. | Peatuge. Laadige tõmmis uuesti alla ja kontrollige seda enne kirjutamist. |
FAILED seed: the installation domain and the first administrator e-mail are required |
Neid ei andnud ei algseadistus ega konsool. | Lisage need faili seed.yaml või vastake viipadele. |
FAILED seed: Enterprise bundle: licence file missing on NEXUS-SEED (licence.json) |
Komplekt on Enterprise ja algseadistusel pole litsentsi. | Pange licence.json algseadistuse andmemahule. |
FAILED bundle: no volume labelled NEXUS-BUNDLE within 1 h |
Ühtegi komplekti ei ühendatud õigeaegselt. | Ühendage komplekti mälupulk ja proovige uuesti. |
FAILED bundle: the bundle does not verify with this installer's release key |
Komplekti kontroll ei lõppenud teatega VERIFY-BUNDLE PASS. Selle enda väljund teate kohal nimetab sammu. |
Peatuge. Ärge kasutage seda komplekti. Hankige uus. |
FAILED bundle: the seed asks for enterprise, the bundle is community |
Algseadistus ja komplekt ei lähe kokku. | Parandage edition algseadistuses või tooge õige komplekt. |
FAILED k3s: node not Ready within 10 min |
k3s ei käivitunud. | Kontrollige logist (journal) k3s-i ja proovige seejärel uuesti. |
FAILED nexus: helm install nexus |
Charti ei paigaldatud ajalõpu jooksul. | Vaadake käsu kubectl -n nexus get pods,jobs väljundit, suurendage algseadistuses väärtust timeout, kui masin on aeglane, ja proovige uuesti. |
FAILED acceptance: pods not ready |
Mõned podid pärast paigaldust ei tööta. | Teade nimetab kuni viis. Lugege nende sündmusi, parandage ja proovige uuesti. |
FAILED acceptance: jobs not complete: <jobs> |
Haagi Job ei ole lõpetanud. | Lugege nimetatud Jobi logi käsuga kubectl -n nexus logs job/<name>, parandage raporteeritud viga ja proovige uuesti. |
Enne operatsioonisüsteemi kirjutamist võib paigalduse peatada ka kettavalik. Selle teade algab tekstiga nexus select-disk: REFUSED:. Levinud teade on found 2 empty disks of >= 64 GB; need exactly one, or a NEXUS-SEED seed.yaml naming the disk with wipe: true. Nimetage ketas algseadistuses ja käivitage uuesti.
Ebaõnnestunud komplekti kontrolli tuleb võtta tõsiselt. See tähendab, et kettal olevad failid ei ole need failid, mille Adverant allkirjastas, või on mõni fail lisatud. Paigaldaja ei ole selleks hetkeks midagi importinud, seega on server muutmata. Hoidke ketas oma turvameeskonna jaoks alles.

