majordomus run
Spusťte schopnost jako provedení a sledujte ji: její kroky, postup a výstup, jak se dějí
majordomus run
Použití
majordomus run [OPTIONS] <CAPABILITY>Argumenty
| argument | hodnota | výchozí | popis |
|---|---|---|---|
| --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)
|
| --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) |
| <CAPABILITY> | <CAPABILITY> | povinné | Schopnost ke spuštění, podle jejího kanonického id (`health.report`, `objects.verify`) |
| --input | <JSON> | — | Jeho vstup jako jeden objekt JSON; validuje jej vstupní schéma schopnosti |
| --follow | flag | — | Vypisovat události na stderr, jak přicházejí; ve výchozím stavu zapnuto, když je stderr terminál |
| --quiet | flag | — | Nevypisovat nic kromě konečného výstupu |
| --format | text | json | text | Tvar výstupu
|
Příklady
-
Sledovat, jak se provádění děje
`run` spustí schopnost jako provedení a sleduje je do konce: každý krok, každý řádek, který zaloguje, a každý posun jeho průběhu, tak jak je handler hlásí. `executions.demonstrate` existuje, aby to bylo vidět bez čekání na skutečnou práci — nic nečte ani nezapisuje a jeho jediným účinkem jsou události, které vyrábí. Totéž provedení, spuštěné z Cockpitu, streamuje stejné události do prohlížeče.
$ majordomus run executions.demonstrate --input '{"steps":2,"delay_ms":0}' --format jsonCo tvrdí: skončí s kódem 0; vypíše jeden dokument JSON nesoucí /state, /id, /output/steps, /steps/0/name.
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 run --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.