majordomus serve ensure
Zajistí, aby tento checkout obsluhoval připravený server: spustí ho, když žádný není nebo je lease zastaralý, počká na ten, který startuje, a ohlásí, kde stojí
majordomus serve ensure
Použití
majordomus serve ensure [OPTIONS]Argumenty
| argument | hodnota | výchozí | popis |
|---|---|---|---|
| --port | <PORT> | — | Port, o který spuštěný server žádá jako o první; bez něj ten, který tento checkout odvodí (8741 pro primární checkout); obsazený se nahradí volným |
| --idle | <SECONDS> | — | Spuštěný server se zastaví, když tolik sekund není připojen žádný peer; bez toho deklarované `server.idle_seconds` politiky, 900, když žádné není deklarováno |
| --wait | <SECONDS> | 20 | Jak dlouho čekat, až bude server připraven, než se ohlásí, v jakém je stavu |
| --format | text | json | text | Tvar výstupu
|
| --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) |
Příklady
-
Zajistit, aby tento checkout obsluhoval server, a nechat ho skončit při nečinnosti
Spustí server jako samostatný proces, když žádný neodpovídá, počká, až je připraven, a vypíše jeden řádek: stav, adresu, pid. Spuštěno znovu, najde server připravený a nespustí nic. `--idle` je doba, po kterou spuštěný server přežije svého posledního peera; tady jedna sekunda, aby příklad po sobě nic nenechal.
$ majordomus serve ensure --idle 1 --wait 30Co tvrdí: skončí s kódem 0; vypíše ready.
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 serve ensure --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.