Verze 1.0.0-alpha.1nejnovější
Kapitola 2.9
Obraz instalačního disku
Spusťte fyzický server nebo virtuální stroj z instalačního obrazu systému Nexus a ten bez připojení k síti nainstaluje operační systém, k3s, cert-manager a Nexus, přičemž každý soubor před použitím zkontroluje.
Tato stránka byla přeložena pomocí AI z anglického originálu. Pokud je cokoliv nejasné, směrodatná je anglická stránka. Přečíst tuto stránku v angličtině

Kancelář přístavního kapitána na východním nábřeží v Harrow má jeden server, žádný internet a na místě nikoho, kdo by provozoval Kubernetes. Tomás Reilly na něm přesto potřeboval mít Nexus. Zapsal obraz na USB (Universal Serial Bus) flash disk, vedle něj zasunul druhý, malý flash disk se čtyřmi řádky nastavení a server spustil. O hodinu později se na obrazovce objevila adresa konzole a tři řádky k přidání do souboru hosts. Nezadával jediný příkaz Kubernetes.
To je úkolem instalačního obrazu disku. Zapíše na disk serveru minimální operační systém, poté při prvním spuštění zkontroluje každý soubor, který nese, vůči vydavatelskému klíči Adverant, nainstaluje k3s bez sítě, naimportuje každý obraz, nainstaluje cert-manager a Nexus a zkontroluje, že každý pod běží. Každý krok se zastaví s uvedením konkrétního důvodu v okamžiku, kdy je něco špatně. Neexistuje zde žádný omezený režim a nikde není žádné výchozí heslo.
Dva obrazy
Každé vydání přichází jako dva druhy obrazů pro dvě architektury procesorů, amd64 a arm64.
| Soubor | Co obsahuje | Kdo si jej může stáhnout |
|---|---|---|
nexus-alpha-installer-1.0.0-alpha.1-<arch>.iso |
Pouze instalátor: operační systém, k3s v1.33.6+k3s1, cert-manager v1.21.3 a instalátor pro první spuštění. Funguje pro obě edice a neobsahuje žádné obrazy systému Nexus. | Kdokoli, z downloads.adverant.ai |
nexus-alpha-<edition>-1.0.0-alpha.1-<arch>.iso |
Stejný instalátor s offline balíčkem dané edice přidaným jako druhý oddíl označený NEXUS-BUNDLE. Jedno médium nainstaluje vše. |
Community: kdokoli. Enterprise: pouze ze svého účtu Adverant |
<arch> je amd64 nebo arm64 a <edition> je community nebo enterprise.
Instalátor vždy hledá pouze souborový systém označený NEXUS-BUNDLE. V obraze „vše v jednom“ je to oddíl na samotném obraze. U obrazu obsahujícího pouze instalátor přinesete balíček na druhém disku nebo flash disku s tímto označením, což se hodí, když instalujete několik lokalit z jednoho instalačního flash disku a měníte pouze balíček. Balíček popisuje kapitola 2.10, Instalace v izolovaném prostředí (air-gapped).
Obrazy Enterprise a balíčky Enterprise nejsou nikdy anonymní. Stahujete je ze svého účtu Adverant na https://account.adverant.ai, na stránce Ke stažení, vedle své licence. Obrazy a balíčky Community jsou veřejné.
Z čeho je obraz sestaven
Operační systém je založen na systému Debian 13 a nejedná se o oficiální obraz systému Debian. Obsahuje základní systém Debian a nic víc: žádné další balíčky, žádné desktopové prostředí a žádné zrcadlo. k3s si přináší vlastní běhové prostředí kontejnerů a síťování. Zaváděcí řetězec (shim, GRUB, jádro a počáteční ramdisk) je bajt po bajtu totožný s tím, který dodává Debian, takže počítač se zapnutým Secure Boot jej spustí jako jakýkoli instalátor systému Debian.
Dvě sestavení téhož vydání dávají identické obrazy, bajt po bajtu, a dokud tomu tak není, vydání není zveřejněno. Zdrojové balíčky systému Debian pro každou binární součást na obraze jsou zveřejněny vedle něj jako nexus-alpha-installer-1.0.0-alpha.1-debian-source.tar, ve stejném seznamu kontrolních součtů.
Kontrola staženého souboru před zápisem
Adresář s obrazy na downloads.adverant.ai obsahuje obrazy, soubor SHA256SUMS pokrývající každý zveřejněný soubor a SHA256SUMS.sigstore.json, podpis tohoto seznamu vytvořený vydavatelským klíčem Adverant. Veřejný vydavatelský klíč si obstarejte samostatně, uložte jej jako release.pub a zkontrolujte jeho otisk tak, jak popisuje kapitola 2.4, Získání a ověření vydání.
- Ověřte podpis na seznamu kontrolních součtů. Pro vydání systému Nexus neexistuje záznam transparentnosti (transparency log), proto je vyžadován příznak, který vyhledávání v záznamu přeskočí.
cosign verify-blob --key release.pub --insecure-ignore-tlog=true \
--bundle SHA256SUMS.sigstore.json SHA256SUMSVerified OK
- Zkontrolujte stažený obraz vůči seznamu:
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
Na počítači Mac použijte shasum -a 256 -c - namísto sha256sum -c -.
- Zapište obraz na USB flash disk pomocí nástroje, který běžně používáte, nebo jej připojte k virtuálnímu stroji jako optický disk.
k3s zveřejňuje pro své soubory vydání kontrolní součty a žádný podpis, takže soubory k3s uvnitř obrazu jsou kontrolovány vůči kontrolním součtům, které k3s zveřejňuje, ze stejného zdroje jako samotné soubory. Vše, co sestavil Adverant, je podepsáno.
Balíčky po částech
Balíček, který přenášíte na samostatném flash disku, má několik gigabajtů. Některé souborové systémy, mezi nimi i FAT (File Allocation Table), nedokážou pojmout soubor o velikosti 4 GiB nebo více, proto jsou soubory balíčků zveřejňovány po částech o velikosti 2047 MiB, které se vejdou na jakýkoli flash disk. Před použitím spojte části ve správném pořadí zpět dohromady a spojený soubor zkontrolujte vůči jeho .sha256.
Potřebný hardware
První spuštění zkontroluje stroj dříve, než se čehokoli dotkne, a odmítne pokračovat, pokud je stroj příliš malý.
| Kontrola | Základní minimum | Kdy se kontroluje |
|---|---|---|
| Architektura | Vlastní architektura obrazu: obraz amd64 na amd64, arm64 na arm64 | První spuštění |
| Paměť | 16 GiB | První spuštění |
| Cílový disk | Přesně jeden prázdný disk o velikosti alespoň 64 GB, nebo disk určený v souboru seed | Před zápisem operačního systému |
Volné místo na / |
50 GB po nahrání operačního systému | První spuštění |
| Hodiny | Ne starší než datum sestavení obrazu | První spuštění |
Toto jsou minimální hranice, nikoli doporučení. Při výchozích hodnotách chartu dávají samotné svazky systému Nexus dohromady 142 GiB, takže 64 GB disk projde instalátorem a zaplní se během několika dnů. Použijte to, co by měl mít samostatný uzel: 8 vCPU (virtual central processing units), 32 GiB paměti a 250 GB SSD (solid-state drive). Pro zkušební provoz postačí čtyři vCPU, 16 GiB a 200 GB.
Kontrola hodin je zde proto, že server nemá při instalaci síť, a tedy ani časovou službu. Certifikáty a podpisy se kontrolují vůči hodinám. Pokud jsou hardwarové hodiny stroje opožděné za datem sestavení obrazu, první spuštění se zastaví a požádá vás o jejich nastavení. Nastavte je v nastavení firmwaru a spusťte stroj znovu.
Fyzické servery a virtuální stroje
Obraz se spouští na firmwaru UEFI (Unified Extensible Firmware Interface), na fyzických serverech i na virtuálních strojích stejně. Zaváděcí program instaluje jak do cesty pro výměnná média, tak do té obvyklé, takže VM (virtual machine) bez uložených zaváděcích záznamů jej po prvním restartu přesto najde. Přidělte VM paměť a disk podle tabulky výše, jeden prázdný virtuální disk a obraz jako CD.
Instalátor vybírá cílový disk podle přísného pravidla a nikdy nevybere „první disk“.
- Přeskočí médium, ze kterého byl spuštěn.
- Přeskočí výměnné disky, ledaže by některý určoval seed.
- Přeskočí jakýkoli disk, který již má tabulku oddílů jakéhokoli druhu.
- Přeskočí disky menší než 64 GB a oznámí to na konzoli.
- Instaluje pouze tehdy, když zbude přesně jeden disk.
Na serveru se dvěma prázdnými disky se zastaví a požádá vás o výběr. Vyberete tak, že disk určíte v souboru seed pomocí wipe: true, což je jediný způsob, jak kdy zapíše na disk, který již obsahuje oddíly.
Svazek NEXUS-SEED
Seed je malý svazek, obvykle USB flash disk, se souborovým systémem označeným NEXUS-SEED a souborem seed.yaml v jeho nejvyšší úrovni. Instalátor jej připojí pouze pro čtení, načte nastavení a jako zapisovatelný jej znovu připojí až úplně na konci, aby vám na něm zanechal heslo k operačnímu systému.
# seed.yaml on the NEXUS-SEED volume
domain: harrow.example
adminEmail: aoife.brennan@harrow.example
edition: enterprise
timeout: 45m| Klíč | Co nastavuje | Když chybí |
|---|---|---|
domain |
Doména instalace. Instalátor z ní odvodí tři hostitele: console.<domain>, api.<domain> a auth.<domain>. |
Dotaz na konzoli serveru |
adminEmail |
E-mail osoby, která bude prvním administrátorem | Dotaz na konzoli serveru |
edition |
community nebo enterprise. Pokud je nastaveno, musí odpovídat edici balíčku. |
Převzato z balíčku |
timeout |
Jak dlouho může trvat instalace cert-manager a Nexus, jako doba trvání, například 30m nebo 1h |
30m |
time |
Aktuální čas v UTC, ve tvaru, jaký vypisuje zpráva o hodinách (2026-11-14T09:00:00Z), pro stroj, jehož hardwarové hodiny nelze nastavit nebo nastavení neudrží. Stroj v režimu offline nemá žádný časový server, kterého by se mohl dotázat. |
Použijí se hardwarové hodiny |
disk |
Cílový disk, jako /dev/<name>, použito pouze společně s wipe: true |
Pravidlo prázdného disku uvedené výše |
wipe |
true umožní instalátoru vymazat disk, který určuje disk |
Žádný disk se nikdy nevymaže |
Pro edici Enterprise umístěte licenční soubor na stejný svazek jako licence.json. Bez něj se první spuštění zastaví u kroku seed a oznámí, že licence chybí. Edice Community žádnou licenci nepotřebuje a pro Community je celý seed volitelný: instalátor se na doménu a e-mail zeptá na konzoli a pokračuje dál.
Instalátor čte každý řádek jako key: value na začátku řádku. Pište jeden klíč na řádek, v nejvyšší úrovni, bez uvozovek a bez odsazení. Hodnota v uvozovkách se načte i s uvozovkami.
Při prvním spuštění se instalátor na konzoli rovněž zeptá na správce (custodian) úložiště klíčů: veřejnou polovinu klíče age, age1..., vytvořenou na vlastním počítači správce pomocí age-keygen -o custodian.key. Úložiště klíčů k ní zapečetí své obnovovací klíče. Správce vysvětluje kapitola 2.8, Instalace na jeden stroj. Správce uchovává soukromou polovinu offline a v bezpečí: bez ní nemůže nikdo úložiště klíčů po restartu odpečetit.
Co se děje od zapnutí po adresu konzole
Fáze jedna: operační systém
Obraz se spustí do bezobslužného instalátoru systému Debian. Nekonfiguruje síť, nepoužívá zrcadlo ani neinstaluje žádný balíček nad rámec základního systému. Nastaví časové pásmo na UTC (Coordinated Universal Time), zakáže přihlášení uživatele root a vytvoří jednoho uživatele, nexus, jehož heslo je uzamčeno. Vybere cílový disk podle pravidla výše a zapíše disk GPT (globally unique identifier partition table) se systémovým oddílem EFI (Extensible Firmware Interface) a jedním kořenovým souborovým systémem ext4, bez odkládacího prostoru (swap).
Na konci zkopíruje instalátor Nexus do nového systému, zkontroluje každý zkopírovaný soubor vůči seznamu kontrolních součtů obrazu a povolí službu pro první spuštění. Pokud některý zkopírovaný soubor neodpovídá, na tomto místě se zastaví. Poté vysune médium a restartuje se.
Fáze dvě: první spuštění
Při prvním spuštění se jednou provede služba nexus-install. Každý krok se vypisuje na konzoli serveru a do žurnálu a zaznamená se jako dokončený, takže opakovaný pokus začíná od prvního kroku, který dokončen není. Služba jako celek může běžet až čtyři hodiny, než ji systemd zastaví, což ponechává prostor pro pomalý disk a hodinové čekání na flash disk s balíčkem.
- Předběžná kontrola (Preflight). Architektura, hodiny, paměť a volné místo na disku, jak je uvedeno v tabulce výše.
- Obsah (Payload). Vlastní soubory instalátoru: podpis na jeho seznamu kontrolních součtů pomocí vydavatelského klíče, který nese, a poté každý soubor vůči tomuto seznamu.
- Seed. Načte
seed.yamla na cokoli chybějícího se zeptá na konzoli. - Balíček (Bundle). Najde svazek označený
NEXUS-BUNDLEa připojí jej pouze pro čtení. Pokud žádný takový není, vypíšewaiting-for-bundlea čeká až hodinu, než jej připojíte. Poté provede úplnou kontrolu balíčku, končícíVERIFY-BUNDLE PASS, pomocí vydavatelského klíče, který nese, dříve než se cokoli naimportuje. Balíček Enterprise vyžadujelicence.jsonna svazku seed a edice v souboru seed musí odpovídat edici balíčku. - k3s. Nainstaluje k3s v1.33.6+k3s1 z vlastních souborů obrazu s vypnutým stahováním a čeká až deset minut, než uzel přejde do stavu Ready. Poté odstraní archiv obrazů k3s pro izolované prostředí (air-gap), aby se obrazy neimportovaly znovu při každém spuštění.
- Import. Naimportuje každý ověřený obraz z balíčku a obrazy cert-manager do úložiště kontejnerů uzlu. Z registru se nikdy nic nestahuje.
- cert-manager, poté Nexus. Nainstaluje cert-manager v1.21.3, poté chart Nexus z balíčku, obojí v rámci
timeoutze souboru seed. - Přijetí (Acceptance). Zkontroluje, že každý pod je ve stavu Running a každá úloha (Job) typu hook byla dokončena.
- Přihlašovací údaj (Credential). Přidělí uživateli operačního systému
nexusnové náhodné heslo, jednou jej zobrazí na konzoli a zapíše jej donexus-os-password.txtna svazku seed, pokud lze na tento svazek zapisovat.
Kontrola balíčku v kroku 4 je tentýž skript, který spouštíte ručně v kapitole 2.10, Instalace v izolovaném prostředí (air-gapped), a vypisuje stejné řádky:
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>
Řádek 3 počítá obrazy, které nesou platný podpis a podepsaný SBOM (software bill of materials), tedy seznam toho, co jednotlivé obrazy obsahují. Počty (<n>) závisí na edici. Rozhodující je poslední řádek.
Instalace zapíše hodnoty v aktuální podobě chartu: global.domain a tři názvy hosts.* z domény v souboru seed a keys.custody.recipients od správce, kterého jste zadali na konzoli. Instaluje z vlastního chartu a obrazů balíčku, takže vydání na disku je přesně to vydání, které bylo zkontrolováno.
Poslední řádky na konzoli
Když každý krok úspěšně projde, konzole jednou zobrazí heslo k operačnímu systému a adresu, kterou máte otevřít:
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)
Heslo si zapište nebo si jej vezměte z flash disku seed, poté se přihlaste jako nexus a změňte jej pomocí passwd. Nikdo, včetně společnosti Adverant, nezná výchozí heslo pro tento stroj, protože žádné neexistuje.
Adresa v řádku hosts je vlastní adresou serveru. Jelikož na nábřeží nebylo žádné DNS (Domain Name System), přidal Tomás tento jeden řádek do souboru hosts každého notebooku, který měl konzoli používat. V lokalitě s DNS namísto toho přidejte záznamy pro tyto tři názvy.
Po instalaci
Instalace není převzata. Nikdo se nemůže přihlásit, dokud ji někdo nepřevezme v prohlížeči porovnáním otisku instalace s otiskem, který zobrazuje server. Převzetí, prvního administrátora a přístupový klíč (passkey) popisuje kapitola 2.12, První spuštění. Prvním administrátorem by měla být osoba, jejíž e-mail je uveden v souboru seed.
Vlastní kubeconfig uzlu je v /etc/rancher/k3s/k3s.yaml, čitelný pouze pro uživatele root. Pro práci na clusteru z pracovní stanice jej vypíše nexusctl kubeconfig, jak popisuje kapitola 2.8, Instalace na jeden stroj.
Aktualizace přicházejí stejným způsobem jako instalace: vydání na podepsaném médiu, kontrolované vůči klíči již nainstalovanému na serveru a nikdy vůči klíči, který si disk přináší s sebou. Tuto kontrolu popisuje kapitola 2.10, Instalace v izolovaném prostředí (air-gapped).
Pokud to selže
Každé selhání vypíše nexus-install: FAILED <step>: <what is missing> na konzoli a totéž zapíše do /var/lib/nexus/install.state. Odstraňte příčinu a spusťte instalaci znovu od prvního kroku, který není dokončen:
sudo nexus-install retry| Zpráva | Co to znamená | Co dělat |
|---|---|---|
FAILED preflight: payload is for arm64, this machine is amd64 |
Spustili jste obraz pro druhou architekturu. | Použijte obraz pro architekturu tohoto stroje. |
FAILED preflight: memory 11 GiB, need >= 16 GiB |
Stroj má méně než stanovené minimum. | Přidejte paměť, nebo jí více přidělte VM. |
FAILED preflight: free disk 38 GB on /, need >= 50 GB |
Kořenový souborový systém je příliš malý. | Instalujte na větší disk. |
FAILED preflight: the clock (...) is older than the build (...); set the RTC or give time: in the seed |
Hardwarové hodiny jsou opožděné za datem sestavení instalátoru. | Nastavte hodiny ve firmwaru nebo zadejte time v seed.yaml a zkuste to znovu. |
FAILED payload: SHA256SUMS signature does not verify |
Vlastní soubory instalátoru neodpovídají tomu, co Adverant podepsal. | Zastavte. Stáhněte obraz znovu a před zápisem jej zkontrolujte. |
FAILED seed: the installation domain and the first administrator e-mail are required |
Neposkytl je ani seed, ani konzole. | Přidejte je do seed.yaml nebo odpovězte na výzvy. |
FAILED seed: Enterprise bundle: licence file missing on NEXUS-SEED (licence.json) |
Balíček je edice Enterprise a seed neobsahuje licenci. | Umístěte licence.json na svazek seed. |
FAILED bundle: no volume labelled NEXUS-BUNDLE within 1 h |
Včas nebyl připojen žádný balíček. | Připojte flash disk s balíčkem a zkuste to znovu. |
FAILED bundle: the bundle does not verify with this installer's release key |
Kontrola balíčku neskončila VERIFY-BUNDLE PASS. Její vlastní výstup nad zprávou uvádí příslušný krok. |
Zastavte. Tento balíček nepoužívejte. Obstarejte si nový. |
FAILED bundle: the seed asks for enterprise, the bundle is community |
Seed a balíček si odporují. | Opravte edition v souboru seed nebo přineste správný balíček. |
FAILED k3s: node not Ready within 10 min |
k3s nenaběhl. | Zkontrolujte žurnál pro k3s a poté to zkuste znovu. |
FAILED nexus: helm install nexus |
Chart se nenainstaloval v časovém limitu. | Podívejte se na kubectl -n nexus get pods,jobs, zvyšte timeout v souboru seed, pokud je stroj pomalý, a zkuste to znovu. |
FAILED acceptance: pods not ready |
Některé pody po instalaci neběží. | Zpráva jich jmenuje až pět. Přečtěte si jejich události, opravte příčinu a zkuste to znovu. |
FAILED acceptance: jobs not complete: <jobs> |
Úloha (Job) typu hook nebyla dokončena. | Přečtěte si protokol jmenované úlohy (Job) pomocí kubectl -n nexus logs job/<name>, opravte to, co hlásí, a zkuste to znovu. |
Před zápisem operačního systému může instalaci zastavit také výběr disku. Jeho zpráva začíná nexus select-disk: REFUSED:. Tou běžnou je found 2 empty disks of >= 64 GB; need exactly one, or a NEXUS-SEED seed.yaml naming the disk with wipe: true. Určete disk v souboru seed a spusťte stroj znovu.
Selhání kontroly balíčku je třeba brát vážně. Znamená to, že soubory na disku nejsou soubory, které Adverant podepsal, nebo že byl nějaký soubor přidán. Instalátor v tom okamžiku nic nenaimportoval, takže server zůstává nezměněn. Disk uschovejte pro svůj bezpečnostní tým.

