Verzió 1.0.0-alpha.1legújabb
2.9. fejezet
A telepítő lemezképfájl
Indítson el egy üres szervert vagy virtuális gépet a Nexus telepítő lemezképfájljáról, amely hálózat nélkül telepíti az operációs rendszert, a k3s-t, a cert-managert és a Nexust, használat előtt minden fájlt ellenőrizve.
Ezt az oldalt AI fordította az eredeti angol szövegből. Ha bármi nem egyértelmű, az angol nyelvű oldal az irányadó. Oldal olvasása angolul

Harrow keleti rakpartján a kikötőmesteri hivatalnak egyetlen szervere van, nincs internetkapcsolata, és nincs a helyszínen senki, aki Kubernetes rendszert üzemeltetne. Tomás Reilly-nak ennek ellenére szüksége volt rajta a Nexus-ra. Kiírta a lemezképet egy USB (Universal Serial Bus) meghajtóra, mellé tett egy második, kisebb meghajtót négy sornyi beállítással, és elindította a szervert. Egy órával később a képernyőn megjelent a konzol címe és a hosts fájlhoz hozzáadandó három sor. Egyetlen Kubernetes parancsot sem gépelt be.
Ez a telepítő lemezkép feladata. Egy minimális operációs rendszert ír a szerver lemezére, majd az első indításkor minden magával hozott fájlt ellenőriz az Adverant kiadási kulcsával, hálózat nélkül telepíti a k3s-t, importálja az összes képfájlt, telepíti a cert-manager-t és a Nexus-t, végül ellenőrzi, hogy minden pod fut-e. Bármilyen hiba esetén az adott lépés azonnal megáll egy megnevezett okkal. Nincs csökkentett módú működés, és sehol sincs alapértelmezett jelszó.
A két lemezképfájl
Minden kiadás kétféle lemezképként érhető el, két processzorarchitektúrához: amd64 és arm64.
| Fájl | Mit tartalmaz | Ki töltheti le |
|---|---|---|
nexus-alpha-installer-1.0.0-alpha.1-<arch>.iso |
Csak a telepítő: az operációs rendszer, a k3s v1.33.6+k3s1, a cert-manager v1.21.3 és az első indítási telepítő. Bármelyik kiadással működik, és nem tartalmaz Nexus képfájlokat. | Bárki, innen: downloads.adverant.ai |
nexus-alpha-<edition>-1.0.0-alpha.1-<arch>.iso |
Ugyanez a telepítő, kiegészítve az adott kiadás offline csomagjával egy második, NEXUS-BUNDLE címkéjű partíción. Egyetlen adathordozó mindent telepít. |
Community: bárki. Enterprise: kizárólag a saját Adverant-fiókjából |
Ahol <arch> értéke amd64 vagy arm64, és <edition> értéke community vagy enterprise.
A telepítő mindig csak egy NEXUS-BUNDLE címkéjű fájlrendszert keres. A mindent egyben tartalmazó (all-in-one) lemezkép esetén ez maga a lemezképen lévő partíció. A csak telepítőt tartalmazó lemezkép esetén a csomagot egy második, ilyen címkével ellátott lemezen vagy USB-meghajtón kell biztosítania, ami akkor praktikus, ha több telephelyet telepít egyetlen telepítő meghajtóról, és csak a csomagot cseréli. A csomagot a 2.10. fejezet, Zárt hálózati (air-gapped) telepítés ismerteti.
Az Enterprise lemezképek és az Enterprise csomagok soha nem névtelenek. Ezeket a saját Adverant-fiókjából töltheti le a https://account.adverant.ai címen, a Downloads (Letöltések) oldalon, a licence mellett. A Community lemezképek és csomagok nyilvánosak.
Miből épül fel a lemezkép
Az operációs rendszer a Debian 13-on alapul, és nem hivatalos Debian lemezkép. Kizárólag a Debian alaprendszert tartalmazza, semmi mást: nincsenek extra csomagok, nincs asztali környezet és nincs tükrözés (mirror). A k3s saját konténer-futtatókörnyezetet és hálózatkezelést hoz magával. A rendszerindítási lánc (shim, GRUB, a kernel és a kezdeti ramdisk) bájtról bájtra megegyezik a Debian által szállítottal, így a bekapcsolt Secure Boot funkcióval rendelkező gépek bármely más Debian telepítőhöz hasonlóan elindítják.
Ugyanazon kiadás két összeállítása (buildje) bájtról bájtra azonos lemezképet eredményez, és a kiadást addig nem teszik közzé, amíg ez nem teljesül. A lemezképen található összes bináris fájl Debian forráscsomagját a lemezkép mellett teszik közzé nexus-alpha-installer-1.0.0-alpha.1-debian-source.tar néven, ugyanabban az ellenőrzőösszeg-listában.
A letöltés ellenőrzése kiírás előtt
A downloads.adverant.ai címen található lemezkép-könyvtár tartalmazza a lemezképeket, egy minden közzétett fájlt lefedő SHA256SUMS fájlt, valamint a SHA256SUMS.sigstore.json fájlt, amely a lista felett az Adverant kiadási kulcsával készített aláírás. Szerezze be külön a kiadási nyilvános kulcsot, mentse el release.pub néven, és ellenőrizze az ujjlenyomatát a 2.4. fejezet, Kiadás beszerzése és ellenőrzése című részben leírtak szerint.
- Ellenőrizze az ellenőrzőösszeg-lista aláírását. A Nexus kiadásokhoz nincs átláthatósági napló (transparency log), ezért a napló-lekérdezést kihagyó kapcsoló használata kötelező.
cosign verify-blob --key release.pub --insecure-ignore-tlog=true \
--bundle SHA256SUMS.sigstore.json SHA256SUMSVerified OK
- Ellenőrizze a letöltött lemezképet a lista alapján:
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 gépen használja a shasum -a 256 -c - parancsot a sha256sum -c - helyett.
- Írja ki a lemezképet egy USB-meghajtóra az általában használt eszközzel, vagy csatolja a virtuális géphez optikai lemezként.
A k3s ellenőrzőösszegeket tesz közzé a kiadási fájljaihoz, aláírást azonban nem, ezért a lemezképen belüli k3s fájlokat a k3s által közzétett, a fájlokkal azonos forrásból származó ellenőrzőösszegek alapján ellenőrzik. Minden, amit az Adverant épített, alá van írva.
Darabolt csomagok
A külön meghajtón hordozott csomag több gigabájt méretű. Egyes fájlrendszerek, köztük a FAT (File Allocation Table), nem képesek 4 GiB vagy annál nagyobb fájlokat tárolni, ezért a csomagfájlokat 2047 MiB méretű darabokban teszik közzé, amelyek bármilyen meghajtóra ráférnek. Használat előtt illessze össze a darabokat sorrendben, és ellenőrizze az egyesített fájlt a hozzá tartozó .sha256 alapján.
A szükséges hardver
Az első indítás ellenőrzi a gépet, mielőtt bármihez hozzányúlna, és megtagadja a folytatást, ha a gép túl kicsi.
| Ellenőrzés | Az alapszint | Mikor ellenőrzik |
|---|---|---|
| Architektúra | A lemezkép sajátja: amd64 lemezkép amd64-en, arm64 lemezkép arm64-en | Első indítás |
| Memória | 16 GiB | Első indítás |
| Céllemez | Pontosan egy, legalább 64 GB-os üres lemez, vagy a seed által megnevezett lemez | Az operációs rendszer kiírása előtt |
Szabad hely a / alatt |
50 GB az operációs rendszer telepítése után | Első indítás |
| Óra | Nem régebbi a lemezkép készítésének dátumánál | Első indítás |
Ezek minimumértékek, nem ajánlások. A chart alapértelmezéseivel csak a Nexus kötetei 142 GiB-ot tesznek ki, így egy 64 GB-os lemez átmegy a telepítőn, de napokon belül megtelik. Használja azt, amivel egyetlen csomópontnak rendelkeznie kell: 8 vCPU (virtual central processing units), 32 GiB memória és egy 250 GB-os SSD (solid-state drive). Kiértékeléshez elegendő négy vCPU, 16 GiB memória és 200 GB tárhely.
Az óra ellenőrzésére azért van szükség, mert a szervernek a telepítéskor nincs hálózati kapcsolata, így időszinkronizáló szolgáltatása sem. A tanúsítványokat és az aláírásokat az óra alapján ellenőrzik. Ha a gép hardveres órája a lemezkép készítési dátuma mögött jár, az első indítás leáll, és kéri a beállítását. Állítsa be a firmware-beállításokban, majd indítsa újra a gépet.
Fizikai szerverek és virtuális gépek
A lemezkép UEFI (Unified Extensible Firmware Interface) firmware-en indul el, fizikai szervereken és virtuális gépeken egyaránt. A rendszerbetöltőt a cserélhető adathordozók útvonalára és a szokásos útvonalra is telepíti, így a mentett rendszerindítási bejegyzésekkel nem rendelkező VM (virtual machine) is megtalálja az első újraindítás után. Adjon a VM-nek a fenti táblázatban szereplő memóriát és lemezterületet, egy üres virtuális lemezt, valamint a lemezképet CD-ként.
A telepítő szigorú szabály alapján választja ki a céllemezt, és soha nem „az első lemezt” választja.
- Kihagyja azt az adathordozót, amelyről elindult.
- Kihagyja a cserélhető lemezeket, kivéve, ha a seed megnevez egyet.
- Kihagy minden olyan lemezt, amelyen már van bármilyen típusú partíciós tábla.
- Kihagyja a 64 GB alatti lemezeket, és ezt jelzi a konzolon.
- Csak akkor telepít, ha pontosan egy lemez marad.
Egy két üres lemezzel rendelkező szerveren megáll, és választást kér Öntől. Választani úgy tud, hogy megnevezi a lemezt a seedben a wipe: true használatával – ez az egyetlen módja annak is, hogy olyan lemezre írjon, amelyen már vannak partíciók.
A NEXUS-SEED kötet
A seed egy kis méretű kötet, általában egy USB-meghajtó, NEXUS-SEED címkéjű fájlrendszerrel és a legfelső szintjén egy seed.yaml fájllal. A telepítő csak olvasható módban csatolja fel, beolvassa a beállításokat, és csak a legvégén csatolja fel újra írhatóként, hogy ott hagyja Önnek az operációs rendszer jelszavát.
# seed.yaml on the NEXUS-SEED volume
domain: harrow.example
adminEmail: aoife.brennan@harrow.example
edition: enterprise
timeout: 45m| Kulcs | Mit állít be | Ha hiányzik |
|---|---|---|
domain |
A telepítés tartománya (domain). A telepítő ebből származtatja a három állomásnevet: console.<domain>, api.<domain> és auth.<domain>. |
Bekéri a szerver konzolján |
adminEmail |
Annak a személynek az e-mail-címe, aki az első adminisztrátor lesz | Bekéri a szerver konzolján |
edition |
community vagy enterprise. Ha be van állítva, egyeznie kell a csomag kiadásával. |
A csomagból veszi át |
timeout |
Mennyi ideig tarthat a cert-manager és a Nexus telepítése, időtartamként megadva, például 30m vagy 1h |
30m |
time |
Az aktuális idő UTC-ben, az óraüzenet által kiírt formátumban (2026-11-14T09:00:00Z), olyan gépekhez, amelyek hardveres órája nem állítható be, vagy nem tartja meg a beállítást. Egy offline gép nem tud időszolgáltató szervert lekérdezni. |
A hardveres órát használja |
disk |
A céllemez /dev/<name> formában, kizárólag a wipe: true beállítással együtt használva |
A fenti üreslemez-szabály érvényesül |
wipe |
A true engedélyezi a telepítőnek a disk által megnevezett lemez törlését |
Soha egyetlen lemezt sem töröl |
Enterprise esetén helyezze a licencfájlt ugyanarra a kötetre licence.json néven. Enélkül az első indítás megáll a seed lépésnél, és jelzi, hogy hiányzik a licenc. A Community nem igényel licencet, és Community esetén a teljes seed elhagyható: a telepítő bekéri a tartományt és az e-mail-címet a konzolon, majd folytatja a munkát.
A telepítő minden sort a sor elején álló key: value formátumként olvas be. Soronként egy kulcsot írjon, a legfelső szinten, idézőjelek és behúzás nélkül. Az idézőjelek közé tett értéket az idézőjelekkel együtt olvassa be.
Az első indításkor a telepítő a konzolon bekéri a kulcstár őrzőjét (custodian) is: egy age kulcs nyilvános felét (age1...), amelyet az őrző saját gépén készítettek a age-keygen -o custodian.key paranccsal. A kulcstár ehhez zárja hozzá a helyreállítási kulcsait. Az őrzőket a 2.8. fejezet, Egygépes telepítések ismerteti. Az őrző a privát felet offline és biztonságban tartja: enélkül újraindítás után senki sem tudja feloldani a kulcstárat.
Mi történik a bekapcsolástól a konzol címéig
Első szakasz: az operációs rendszer
A lemezkép egy felügyelet nélküli Debian telepítőbe indul el. Nem állít be hálózatot, nem használ tükrözést (mirror), és az alaprendszeren kívül nem telepít semmilyen csomagot. Az időzónát UTC-re (Coordinated Universal Time) állítja, letiltja a root bejelentkezést, és létrehoz egyetlen felhasználót, nexus néven, zárolt jelszóval. A fenti szabály alapján kiválasztja a céllemezt, és létrehoz egy GPT (globally unique identifier partition table) lemezt egy EFI (Extensible Firmware Interface) rendszerpartícióval és egy ext4 gyökér-fájlrendszerrel, lapozófájl (swap) nélkül.
A végén átmásolja a Nexus telepítőt az új rendszerre, minden átmásolt fájlt ellenőriz a lemezkép ellenőrzőösszeg-listája alapján, és engedélyez egy első indítási szolgáltatást. Ha bármelyik átmásolt fájl nem egyezik, ott megáll. Ezután kiadja az adathordozót, és újraindul.
Második szakasz: az első indítás
Az első indításkor a nexus-install szolgáltatás egyszer lefut. Minden lépés kiíródik a szerver konzoljára és a naplóba (journal), és késznek jelöli magát, így egy újrapróbálkozás az első olyan lépéstől indul, amely még nincs kész. A szolgáltatás egészében legfeljebb négy órán át futhat, mielőtt a systemd leállítaná, ami hagy időt egy lassú lemezre és egy órányi várakozásra a csomagot tartalmazó meghajtó csatlakoztatásához.
- Előellenőrzés (Preflight). Az architektúra, az óra, a memória és a szabad lemezterület, a fenti táblázat szerint.
- Hasznos teher (Payload). A telepítő saját fájljai: az ellenőrzőösszeg-lista aláírása a magával hozott kiadási kulccsal, majd minden fájl ellenőrzése a lista alapján.
- Seed. Beolvassa a
seed.yamlfájlt, és a konzolon bekéri a hiányzó adatokat. - Csomag (Bundle). Megkeresi a
NEXUS-BUNDLEcímkéjű kötetet, és csak olvasható módban csatolja fel. Ha nincs ilyen, kiírja awaiting-for-bundleüzenetet, és legfeljebb egy órát vár arra, hogy Ön csatlakoztassa. Ezután bármilyen importálás előtt lefuttatja a teljes csomagellenőrzést a magával hozott kiadási kulccsal, amely aVERIFY-BUNDLE PASSüzenettel zárul. Az Enterprise csomaghoz szükséges alicence.jsonmegléte a seeden, és a seed kiadásának egyeznie kell a csomag kiadásával. - k3s. Telepíti a k3s v1.33.6+k3s1 verzióját a lemezkép saját fájljaiból kikapcsolt letöltések mellett, és legfeljebb tíz percet vár arra, hogy a csomópont Ready állapotba kerüljön. Ezután eltávolítja a k3s zárt hálózati (air-gap) képfájl-archívumát, hogy a képfájlok ne importálódjanak újra minden indításkor.
- Importálás (Import). Importálja a csomagból az összes ellenőrzött képfájlt, valamint a cert-manager képfájljait a csomópont konténertárolójába. Soha semmit nem tölt le tárolóból (registry).
- cert-manager, majd Nexus. Telepíti a cert-manager v1.21.3 verzióját, majd a csomagból a Nexus chartot, mindkettőt a seed
timeoutidőkorlátján belül. - Átvétel (Acceptance). Ellenőrzi, hogy minden pod Running állapotban van-e, és minden hook Job befejeződött-e.
- Hitelesítő adatok (Credential). Új, véletlenszerű jelszót ad a
nexusoperációsrendszer-felhasználónak, egyszer megjeleníti a konzolon, és kiírja a seed kötetnexus-os-password.txtfájljába, ha a kötet írható.
A 4. lépésben szereplő csomagellenőrzés ugyanaz a parancsfájl, amelyet a 2.10. fejezet, Zárt hálózati (air-gapped) telepítés során kézzel futtat, és ugyanazokat a sorokat írja ki:
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>
A 3. sor megszámolja azokat a képfájlokat, amelyek érvényes aláírással és aláírt SBOM-mal (software bill of materials – az egyes képfájlok tartalmának listájával) rendelkeznek. A darabszámok (<n>) a kiadástól függenek. Ami számít, az az utolsó sor.
A telepítés a chart jelenlegi formájában írja be az értékeket: a global.domain értéket és a három hosts.* nevet a seed tartományából, valamint a keys.custody.recipients értéket a konzolon megadott őrzőtől. A csomag saját chartjából és képfájljaiból telepít, így a lemezre kerülő kiadás pontosan az a kiadás, amelyet ellenőriztek.
Az utolsó sorok a konzolon
Amikor minden lépés sikeresen lefutott, a konzol egyszer megjeleníti az operációs rendszer jelszavát és a megnyitandó címet:
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)
Írja fel a jelszót, vagy vegye ki a seed meghajtóról, majd jelentkezzen be nexus felhasználóként, és változtassa meg a passwd paranccsal. Senki – beleértve az Adverantot is – nem ismer alapértelmezett jelszót ehhez a géphez, mert nem létezik ilyen.
A hosts sorban szereplő cím a szerver saját címe. Mivel a rakparton nincs DNS (Domain Name System), Tomás ezt az egy sort adta hozzá minden olyan laptop hosts fájljához, amelyről használni kívánták a konzolt. DNS-sel rendelkező telephelyen ehelyett adjon hozzá rekordokat a három névhez.
A telepítés után
A telepítés még nincs birtokba véve (unclaimed). Senki sem tud bejelentkezni, amíg valaki birtokba nem veszi egy böngészőben, összehasonlítva a telepítés ujjlenyomatát a szerver által mutatottal. A 2.12. fejezet, Az első futtatás ismerteti a birtokbavételt, az első adminisztrátort és a hozzáférési kulcsot (passkey). Az első adminisztrátornak annak a személynek kell lennie, akinek az e-mail-címe szerepel a seedben.
A csomópont saját kubeconfig fájlja a /etc/rancher/k3s/k3s.yaml helyen található, és csak a root olvashatja. Ha munkaállomásról szeretne dolgozni a fürtön, a nexusctl kubeconfig parancs írja ki azt, ahogyan azt a 2.8. fejezet, Egygépes telepítések ismerteti.
A frissítések ugyanúgy érkeznek, ahogy a telepítés történt: egy kiadás aláírt adathordozón, amelyet a szerverre már telepített kulcs alapján ellenőriznek, és soha nem a lemez által magával hozott kulcs alapján. Ezt az ellenőrzést a 2.10. fejezet, Zárt hálózati (air-gapped) telepítés ismerteti.
Ha ez sikertelen
Minden hiba kiírja a nexus-install: FAILED <step>: <what is missing> üzenetet a konzolra, és ugyanezt beírja a /var/lib/nexus/install.state fájlba. Hárítsa el az okot, és futtassa újra a telepítést az első olyan lépéstől, amely még nincs kész:
sudo nexus-install retry| Üzenet | Mit jelent | Teendők |
|---|---|---|
FAILED preflight: payload is for arm64, this machine is amd64 |
A másik architektúrához tartozó lemezképet indította el. | Használja a gép architektúrájának megfelelő lemezképet. |
FAILED preflight: memory 11 GiB, need >= 16 GiB |
A gép nem éri el a minimumértéket. | Bővítse a memóriát, vagy adjon többet a VM-nek. |
FAILED preflight: free disk 38 GB on /, need >= 50 GB |
A gyökér-fájlrendszer túl kicsi. | Telepítse nagyobb lemezre. |
FAILED preflight: the clock (...) is older than the build (...); set the RTC or give time: in the seed |
A hardveres óra a telepítő készítésének dátuma mögött jár. | Állítsa be az órát a firmware-ben, vagy adja meg a time értéket a seed.yaml fájlban, majd próbálja újra. |
FAILED payload: SHA256SUMS signature does not verify |
A telepítő saját fájljai nem egyeznek azokkal, amelyeket az Adverant aláírt. | Álljon meg. Töltse le újra a lemezképet, és kiírás előtt ellenőrizze. |
FAILED seed: the installation domain and the first administrator e-mail are required |
Sem a seed, sem a konzol nem adta meg őket. | Adja hozzá őket a seed.yaml fájlhoz, vagy válaszoljon a bekérésekre. |
FAILED seed: Enterprise bundle: licence file missing on NEXUS-SEED (licence.json) |
A csomag Enterprise kiadású, és a seeden nincs licenc. | Helyezze a licence.json fájlt a seed kötetre. |
FAILED bundle: no volume labelled NEXUS-BUNDLE within 1 h |
Nem csatlakoztattak csomagot időben. | Csatlakoztassa a csomagot tartalmazó meghajtót, és próbálja újra. |
FAILED bundle: the bundle does not verify with this installer's release key |
A csomagellenőrzés nem a VERIFY-BUNDLE PASS üzenettel zárult. A saját kimenete, az üzenet felett, megnevezi a lépést. |
Álljon meg. Ne használja azt a csomagot. Szerezzen be egy újat. |
FAILED bundle: the seed asks for enterprise, the bundle is community |
A seed és a csomag eltér egymástól. | Javítsa a edition értéket a seedben, vagy hozza a megfelelő csomagot. |
FAILED k3s: node not Ready within 10 min |
A k3s nem indult el. | Ellenőrizze a naplóban (journal) a k3s bejegyzéseit, majd próbálja újra. |
FAILED nexus: helm install nexus |
A chart nem települt az időkorláton belül. | Nézze meg a kubectl -n nexus get pods,jobs kimenetét, növelje a timeout értékét a seedben, ha a gép lassú, majd próbálja újra. |
FAILED acceptance: pods not ready |
Néhány pod nem fut a telepítés után. | Az üzenet legfeljebb ötöt nevez meg. Olvassa el az eseményeiket, javítsa a hibát, majd próbálja újra. |
FAILED acceptance: jobs not complete: <jobs> |
Egy hook Job nem fejeződött be. | Olvassa el a megnevezett Job naplóját a kubectl -n nexus logs job/<name> paranccsal, javítsa ki a jelzett hibát, majd próbálja újra. |
Az operációs rendszer kiírása előtt a lemezválasztás is megállíthatja a telepítést. Ennek üzenete nexus select-disk: REFUSED: formában kezdődik. A leggyakoribb a found 2 empty disks of >= 64 GB; need exactly one, or a NEXUS-SEED seed.yaml naming the disk with wipe: true. Nevezze meg a lemezt a seedben, és indítsa újra a gépet.
A sikertelen csomagellenőrzést kell igazán komolyan venni. Ez azt jelenti, hogy a lemezen lévő fájlok nem azok, amelyeket az Adverant aláírt, vagy egy fájlt hozzáadtak. A telepítő ezen a ponton még semmit sem importált, így a szerver változatlan. Őrizze meg a lemezt a biztonsági csapata számára.

