Autoprovision vrátane netboot média
Autoprovision je obmena inštalátora pre stroje, ktoré mesh bootuje zo siete, a súčasne synchronizácia upravenej konfigurácie, takže má každý box lokálneho meshe rovnakú. Tri kusy:
losos-ctl provision— obmenalosos-ctl installs jedným krokom navrchu: stroj vezme konfiguráciu meshe zo zrkadla, takže box nainštalovaný provisionom beží s tým, čo mesh beží, nie so východzími predvoľbami.nixosConfigurations.netboot— netbootová obmena inštalačného média: kernel, initrd a squashfs store pre klienta PXE/iPXE, ktorého autorun končí vlosos-ctl provision.losos.autoprovision.enable— synchronizácia na boxi: lososd udržujemodules/overrides.nixtohto boxu v kroku s tým istým zrkadlom, takže zmena aplikovaná na jednom boxi dosiahne aj ostatné.
Zrkadlo
Jedna vetva jednej git adresy, dosiahnuteľná bez pýtania zo všetkých boxov meshe (obyčajné http(s), bare repozitár na ceste k súboru, alebo ssh adresa, ktorú daemon otvorí bez otázok po kľúči). Všetko na ňom je zdieľané v meshe a nič na ňom nie je tajné: LUKS kľúče a tokeny neopustia box, ktorému patria.
refs/heads/provision
├── modules/overrides.nix upravená konfigurácia meshe
└── boxes/
├── box-9f13c4ad/install-target.nix hardvér samotného stroja
├── box-9f13c4ad/overrides.nix konfigurácia, s ktorou bol nainštalovaný
└── mattbox/…
Stroj netbootovaný na provision sa volá box-<first 8 hex of the machine id>, pokiaľ operátor nežiada meno (losos-autoprovision --name lease-3).
V LosOS Gite meshe boxu je to ďalší súkromný klon repozitára: vytvorte ho
tam pre zrkadlo, alebo ukazačte na ľubovoľný git vzdialený repozitár, ktorý
mesh dosiahne.
Provisioning netbootovaného stroja
Nabootujte stroj s boot.ipxe z netboot image, alebo spustite príkaz
ručne na ľubovoľnom inštalačnom médiu:
nix build .#nixosConfigurations.netboot.config.system.build.netbootImage
# serve the result over http, point iPXE at boot.ipxe, and
# replace SERVER in it with the netboot server
Čo jeden provision urobí, v poradí:
- Prečíta zrkadlo (
git ls-remote, potom plytký fetch vetvyprovision) a vezme jehomodules/overrides.nix. Zrkadlo bez vetvy, vetva bez konfigurácie, alebo konfigurácia, ktorá neprejde tým istým tvarovým testom, čím Apply na boxi, sa zastaví tu, pred diskami. - Ponuka firmwaru nezmenená zo sticku: vyráta 30 sekúnd a ukáže, čo urobí.
- Obyčajný inštalačný plán s jedným krokom navyše:
modules/overrides.nixz meshe sa položí do klonu flake vedľa generovanéhomodules/install-target.nix, takže inštalácia stavia nastavenia meshe. - Keď je strom na disku, box sa zapíše do zrkadla ako
boxes/<name>/na nový commit cez hlavičku vetvy (iba fast-forward, takže dva stroje provisionované naraz sa vyvrátia ako prepísanie). Zrkadlo, ktoré zápis nevezme, je varovanie, nikdy neúspešná inštalácia.
Vlajky, ktoré inštalácia berie, berie provision tiež: voľby otvárania
diskov (--tpm/--no-tpm, --tang/--tang-edge, --bios/--uefi,
zoznam diskov) a --no-install. Testové cesty, ktorými prebuilt disko
skript alebo --emit-target formuje, odmieta, pretože tie stromy boxu
nestavia.
Prostredie buildu (alebo losos.autoprovision.tang) môže vlastné voľby
meshe predpísať do média, takže pri boxe nikto nič nepíše:
LOSOS_TANG=URL#THUMBPRINT[,more] (alebo možnosť
losos.autoprovision.tang) spôsobí, že autorun inštaluje s --tang — kľúč
disku je zapečatený na TPM2 a na tom Clevis Tang serveri (tang-show-keys
na serveri vytlačí thumbprint). Box provisionovaný takto sa nepodarí
otvoriť z jeho disku samej, od prvého bootu; --tpm, --tang-edge a
každa iná rukou napísaná voľka stále prevažuje nad predpísanou.
Ako boxy zostávajú v kroku
Zapnutie (modules/autoprovision.nix):
losos = {
autoprovision = {
enable = true;
mirror = "https://git.home.example/mesh-config.git";
# box = "mattbox"; # defaults to losos.hostName
};
};
Rekonziliátor konfigurácie lososd — to isté vlákno, ktoré vedie repozitár konfigurácie na vlastnom LosOS Gite boxu — pozrie tiež každú pol minútu do zrkadla a rozhodne z dvoch skutočností: text boxu a text hlavičky zrkadla proti tomu, čo si napravec z oboch naposledy zapísal. Keď sa obe pohnú → víťazí najnovší pisateľ (commit čas hlavičky zrkadla proti chvíli, keď tento box naposledy pushoval). Pohla sa len jedna strana → tá strana je pravda; box pushne alebo vezme.
Vezma prejde bránami, ktorými prechádza každý Apply — tvarový test,
options dokument a edge brána — a keď sa jej niečo odmietne, ostatné
ostáva odmietnuté s dôvodom na mesh riadku v History panely (GET /api/config,
pole mesh). Žiadny box nikdy nepushuje silou. Keď zrkadlo nemá ešte vetvu,
prvý box, ktorý sa ňou pozrie, pushne vlastnú konfiguráciu a zaseje ju. A
keď provisionovaný box nainštaluje konfiguráciu, ktorá sa potom posunie,
ďalšia sync ju pushne späť a celý mesh comes prestavia s ňou; to je presne
bod celého systému.
losos-ctl config — History panel — nesie odpoveď zrkadla vedľa odpovede
LosOS Git sync a zavedenej vetvy (mesh.sync.state).
Spolužitie
Všetci traja stráže /etc/nixos bežia na jednom vlákne daemona a berú
jeden state lock, takže neumožnia si písať v rovnakom čase:
- LosOS Git — vlastná konfigurácia boxu, súkromná
(
losos.configRepo.enable), pokrýva každý súbor, ktorý drží. - zavedená vetva — nové verzie LosOS (Install in depth).
- zrkadlo —
modules/overrides.nixmeshe len; fakty stroja sa nikdy nevracajú zo zápisuboxes/.
Publikovať do zrkadla meshe, verejného pre cudzích, je presne tak
úmyselné ako požičať úložisko: losos.autoprovision.enable je v predvolenom
vypnuté, a vziať konfiguráciu meshe znamená pustiť si to, čo mesh
commituje.