majordomus web report cockpit-snapshot

Samotný Cockpit, jednou přečtený v tomto commitu a zapsaný jako statické stránky, které publikace nese na /cockpit (ADR 0147)

Použití

majordomus web report cockpit-snapshot [OPTIONS]

Argumenty

argument	hodnota	výchozí	popis
--limit	<LIMIT>	240	Nejvyšší počet stránek k zápisu: nejprve každá statická routa, pak stránky, na které odkazuje snapshot UI, a pak to, na co odkazují ty
--budget-seconds	<BUDGET_SECONDS>	180	Nejvíce sekund, které se utratí za stránky, na něž statické trasy odkazují; samotné trasy se zapíší, ať stojí cokoli
--repo	<PATH>	—	Zde začne hledání kořene repozitáře (výchozí: aktuální adresář) (přijímá každý podpříkaz)
--discovery	vcs \| filesystem	vcs	Jak se vyhledávají deklarativní soubory (přijímá každý podpříkaz) `vcs` — Sledované soubory přes index správy verzí (kontrakt vrstvy); vrstva, z níž není nic sledováno, se čte z pracovního stromu `filesystem` — Průchod pracovním stromem se stejnou sémantikou glob; zahrnuje nesledované soubory
--strict	flag	—	Odmítne pokračovat, pokud kterýkoli soubor vrstvy nese diagnostiku typu chyba (přijímá každý podpříkaz)
--share	<DIR>	—	Adresář share distribuce nástroje (kinds.yaml, schemas/); výchozí: $MAJORDOMUS_SHARE, poté vlastní share/ repozitáře, poté ten vedle spustitelného souboru (přijímá každý podpříkaz)
--format	text \| json	text	Tvar výstupu (přijímá každý podpříkaz) `text` — Řádky pro člověka `json` — Jeden dokument JSON, deterministický
--only	<ONLY>	—	Jen tyto povrchy, podle objeveného id (opakujte nebo oddělte čárkami) (přijímá každý podpříkaz)
--exclude	<EXCLUDE>	—	Všechny povrchy kromě těchto, podle objeveného id (přijímá každý podpříkaz)

Příklady

Přečíst Cockpit jednou a zapsat ho jako stránky, které publikace nese na /cockpit

Zeptá se Cockpitu v procesu na každou statickou trasu kromě jediné stránky o tomto stroji, pak na stránky, na které odkazuje snímek UI, pak, vždy po jedné stránce z každé rodiny, dokud se nedosáhne `--limit` stránek nebo `--budget-seconds`, na stránky, na které ty odkazují, a každou zapíše jako soubor pod target/web/cockpit-snapshot. Odkazy mezi nimi jsou relativní; odkaz do UI vede na snímek UI, když ten stránku drží; formulář, dotaz nebo stránka za mezí vedou na stránku snímku o živém Cockpitu; žádná stránka nenese skript, protože skripty Cockpitu mluví s procesem; a každá stránka je opatřena commitem, časem a spustitelným souborem, který ji přečetl.
```
$ majordomus web report cockpit-snapshot --limit 12
```
Co tvrdí: skončí s kódem 0; vypíše web report, cockpit-snapshot.
Testuje apps/majordomus-cli/tests/cli_examples.rs, který spouští příkaz nad sestaveným programem a ověřuje, co stránka uvádí.

Odkud to pochází

Deklarováno jednou v apps/majordomus-cli/src/cli.rs: clap pro strukturu, typovaná metadata v Rustu vedle něj pro příklady. Tato stránka, majordomus web report cockpit-snapshot --help, docs/generated/cli.md a docs/generated/cli.json jsou projekce této jediné deklarace.

Celá příkazová řádka na jedné stránce: stránka příkazové řádky registru. Životní cyklus úlohy (init, start, finish, doctor, ...) patří nástroji shell, jinému programu: Příkazy a jeho specifikace.