mirror of
https://github.com/basnijholt/compose-farm.git
synced 2026-02-03 14:13:26 +00:00
fix: add COLUMNS and _TYPER_FORCE_DISABLE_TERMINAL for consistent output (#167)
This commit is contained in:
4
.github/workflows/update-readme.yml
vendored
4
.github/workflows/update-readme.yml
vendored
@@ -26,7 +26,9 @@ jobs:
|
|||||||
env:
|
env:
|
||||||
TERM: dumb
|
TERM: dumb
|
||||||
NO_COLOR: 1
|
NO_COLOR: 1
|
||||||
TERMINAL_WIDTH: 90
|
COLUMNS: 90 # POSIX terminal width for Rich
|
||||||
|
TERMINAL_WIDTH: 90 # Typer MAX_WIDTH for help panels
|
||||||
|
_TYPER_FORCE_DISABLE_TERMINAL: 1 # Prevent Typer forcing terminal mode in CI
|
||||||
run: |
|
run: |
|
||||||
uvx --with . markdown-code-runner README.md
|
uvx --with . markdown-code-runner README.md
|
||||||
sed -i 's/[[:space:]]*$//' README.md
|
sed -i 's/[[:space:]]*$//' README.md
|
||||||
|
|||||||
431
README.md
431
README.md
@@ -478,46 +478,41 @@ Full `--help` output for each command. See the [Usage](#usage) table above for a
|
|||||||
|
|
||||||
Compose Farm - run docker compose commands across multiple hosts
|
Compose Farm - run docker compose commands across multiple hosts
|
||||||
|
|
||||||
╭─ Options ────────────────────────────────────────────────────────────────────╮
|
╭─ Options ──────────────────────────────────────────────────────────────────────────────╮
|
||||||
│ --version -v Show version and exit │
|
│ --version -v Show version and exit │
|
||||||
│ --install-completion Install completion for the current shell. │
|
│ --install-completion Install completion for the current shell. │
|
||||||
│ --show-completion Show completion for the current shell, to │
|
│ --show-completion Show completion for the current shell, to copy it or │
|
||||||
│ copy it or customize the installation. │
|
│ customize the installation. │
|
||||||
│ --help -h Show this message and exit. │
|
│ --help -h Show this message and exit. │
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
╭─ Configuration ──────────────────────────────────────────────────────────────╮
|
╭─ Configuration ────────────────────────────────────────────────────────────────────────╮
|
||||||
│ traefik-file Generate a Traefik file-provider fragment from compose │
|
│ traefik-file Generate a Traefik file-provider fragment from compose Traefik labels. │
|
||||||
│ Traefik labels. │
|
│ refresh Update local state from running stacks. │
|
||||||
│ refresh Update local state from running stacks. │
|
│ check Validate configuration, traefik labels, mounts, and networks. │
|
||||||
│ check Validate configuration, traefik labels, mounts, and networks. │
|
│ init-network Create Docker network on hosts with consistent settings. │
|
||||||
│ init-network Create Docker network on hosts with consistent settings. │
|
│ config Manage compose-farm configuration files. │
|
||||||
│ config Manage compose-farm configuration files. │
|
│ ssh Manage SSH keys for passwordless authentication. │
|
||||||
│ ssh Manage SSH keys for passwordless authentication. │
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
╭─ Lifecycle ────────────────────────────────────────────────────────────────────────────╮
|
||||||
╭─ Lifecycle ──────────────────────────────────────────────────────────────────╮
|
│ up Start stacks (docker compose up -d). Auto-migrates if host changed. │
|
||||||
│ up Start stacks (docker compose up -d). Auto-migrates if host │
|
│ down Stop stacks (docker compose down). │
|
||||||
│ changed. │
|
│ stop Stop services without removing containers (docker compose stop). │
|
||||||
│ down Stop stacks (docker compose down). │
|
│ pull Pull latest images (docker compose pull). │
|
||||||
│ stop Stop services without removing containers (docker compose │
|
│ restart Restart running containers (docker compose restart). │
|
||||||
│ stop). │
|
│ update Update stacks (pull + build + up). Shorthand for 'up --pull --build'. │
|
||||||
│ pull Pull latest images (docker compose pull). │
|
│ apply Make reality match config (start, migrate, stop strays/orphans as │
|
||||||
│ restart Restart running containers (docker compose restart). │
|
│ needed). │
|
||||||
│ update Update stacks (pull + build + up). Shorthand for 'up --pull │
|
│ compose Run any docker compose command on a stack. │
|
||||||
│ --build'. │
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
│ apply Make reality match config (start, migrate, stop │
|
╭─ Monitoring ───────────────────────────────────────────────────────────────────────────╮
|
||||||
│ strays/orphans as needed). │
|
│ logs Show stack logs. With --service, shows logs for just that service. │
|
||||||
│ compose Run any docker compose command on a stack. │
|
│ ps Show status of stacks. │
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
│ stats Show overview statistics for hosts and stacks. │
|
||||||
╭─ Monitoring ─────────────────────────────────────────────────────────────────╮
|
│ list List all stacks and their assigned hosts. │
|
||||||
│ logs Show stack logs. With --service, shows logs for just that │
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
│ service. │
|
╭─ Server ───────────────────────────────────────────────────────────────────────────────╮
|
||||||
│ ps Show status of stacks. │
|
│ web Start the web UI server. │
|
||||||
│ stats Show overview statistics for hosts and stacks. │
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
│ list List all stacks and their assigned hosts. │
|
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
|
||||||
╭─ Server ─────────────────────────────────────────────────────────────────────╮
|
|
||||||
│ web Start the web UI server. │
|
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -546,18 +541,18 @@ Full `--help` output for each command. See the [Usage](#usage) table above for a
|
|||||||
|
|
||||||
Start stacks (docker compose up -d). Auto-migrates if host changed.
|
Start stacks (docker compose up -d). Auto-migrates if host changed.
|
||||||
|
|
||||||
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
|
╭─ Arguments ────────────────────────────────────────────────────────────────────────────╮
|
||||||
│ stacks [STACKS]... Stacks to operate on │
|
│ stacks [STACKS]... Stacks to operate on │
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
╭─ Options ────────────────────────────────────────────────────────────────────╮
|
╭─ Options ──────────────────────────────────────────────────────────────────────────────╮
|
||||||
│ --all -a Run on all stacks │
|
│ --all -a Run on all stacks │
|
||||||
│ --host -H TEXT Filter to stacks on this host │
|
│ --host -H TEXT Filter to stacks on this host │
|
||||||
│ --service -s TEXT Target a specific service within the stack │
|
│ --service -s TEXT Target a specific service within the stack │
|
||||||
│ --pull Pull images before starting (--pull always) │
|
│ --pull Pull images before starting (--pull always) │
|
||||||
│ --build Build images before starting │
|
│ --build Build images before starting │
|
||||||
│ --config -c PATH Path to config file │
|
│ --config -c PATH Path to config file │
|
||||||
│ --help -h Show this message and exit. │
|
│ --help -h Show this message and exit. │
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -584,17 +579,16 @@ Full `--help` output for each command. See the [Usage](#usage) table above for a
|
|||||||
|
|
||||||
Stop stacks (docker compose down).
|
Stop stacks (docker compose down).
|
||||||
|
|
||||||
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
|
╭─ Arguments ────────────────────────────────────────────────────────────────────────────╮
|
||||||
│ stacks [STACKS]... Stacks to operate on │
|
│ stacks [STACKS]... Stacks to operate on │
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
╭─ Options ────────────────────────────────────────────────────────────────────╮
|
╭─ Options ──────────────────────────────────────────────────────────────────────────────╮
|
||||||
│ --all -a Run on all stacks │
|
│ --all -a Run on all stacks │
|
||||||
│ --orphaned Stop orphaned stacks (in state but removed from │
|
│ --orphaned Stop orphaned stacks (in state but removed from config) │
|
||||||
│ config) │
|
│ --host -H TEXT Filter to stacks on this host │
|
||||||
│ --host -H TEXT Filter to stacks on this host │
|
│ --config -c PATH Path to config file │
|
||||||
│ --config -c PATH Path to config file │
|
│ --help -h Show this message and exit. │
|
||||||
│ --help -h Show this message and exit. │
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -621,15 +615,15 @@ Full `--help` output for each command. See the [Usage](#usage) table above for a
|
|||||||
|
|
||||||
Stop services without removing containers (docker compose stop).
|
Stop services without removing containers (docker compose stop).
|
||||||
|
|
||||||
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
|
╭─ Arguments ────────────────────────────────────────────────────────────────────────────╮
|
||||||
│ stacks [STACKS]... Stacks to operate on │
|
│ stacks [STACKS]... Stacks to operate on │
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
╭─ Options ────────────────────────────────────────────────────────────────────╮
|
╭─ Options ──────────────────────────────────────────────────────────────────────────────╮
|
||||||
│ --all -a Run on all stacks │
|
│ --all -a Run on all stacks │
|
||||||
│ --service -s TEXT Target a specific service within the stack │
|
│ --service -s TEXT Target a specific service within the stack │
|
||||||
│ --config -c PATH Path to config file │
|
│ --config -c PATH Path to config file │
|
||||||
│ --help -h Show this message and exit. │
|
│ --help -h Show this message and exit. │
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -656,15 +650,15 @@ Full `--help` output for each command. See the [Usage](#usage) table above for a
|
|||||||
|
|
||||||
Pull latest images (docker compose pull).
|
Pull latest images (docker compose pull).
|
||||||
|
|
||||||
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
|
╭─ Arguments ────────────────────────────────────────────────────────────────────────────╮
|
||||||
│ stacks [STACKS]... Stacks to operate on │
|
│ stacks [STACKS]... Stacks to operate on │
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
╭─ Options ────────────────────────────────────────────────────────────────────╮
|
╭─ Options ──────────────────────────────────────────────────────────────────────────────╮
|
||||||
│ --all -a Run on all stacks │
|
│ --all -a Run on all stacks │
|
||||||
│ --service -s TEXT Target a specific service within the stack │
|
│ --service -s TEXT Target a specific service within the stack │
|
||||||
│ --config -c PATH Path to config file │
|
│ --config -c PATH Path to config file │
|
||||||
│ --help -h Show this message and exit. │
|
│ --help -h Show this message and exit. │
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -691,15 +685,15 @@ Full `--help` output for each command. See the [Usage](#usage) table above for a
|
|||||||
|
|
||||||
Restart running containers (docker compose restart).
|
Restart running containers (docker compose restart).
|
||||||
|
|
||||||
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
|
╭─ Arguments ────────────────────────────────────────────────────────────────────────────╮
|
||||||
│ stacks [STACKS]... Stacks to operate on │
|
│ stacks [STACKS]... Stacks to operate on │
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
╭─ Options ────────────────────────────────────────────────────────────────────╮
|
╭─ Options ──────────────────────────────────────────────────────────────────────────────╮
|
||||||
│ --all -a Run on all stacks │
|
│ --all -a Run on all stacks │
|
||||||
│ --service -s TEXT Target a specific service within the stack │
|
│ --service -s TEXT Target a specific service within the stack │
|
||||||
│ --config -c PATH Path to config file │
|
│ --config -c PATH Path to config file │
|
||||||
│ --help -h Show this message and exit. │
|
│ --help -h Show this message and exit. │
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -726,15 +720,15 @@ Full `--help` output for each command. See the [Usage](#usage) table above for a
|
|||||||
|
|
||||||
Update stacks (pull + build + up). Shorthand for 'up --pull --build'.
|
Update stacks (pull + build + up). Shorthand for 'up --pull --build'.
|
||||||
|
|
||||||
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
|
╭─ Arguments ────────────────────────────────────────────────────────────────────────────╮
|
||||||
│ stacks [STACKS]... Stacks to operate on │
|
│ stacks [STACKS]... Stacks to operate on │
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
╭─ Options ────────────────────────────────────────────────────────────────────╮
|
╭─ Options ──────────────────────────────────────────────────────────────────────────────╮
|
||||||
│ --all -a Run on all stacks │
|
│ --all -a Run on all stacks │
|
||||||
│ --service -s TEXT Target a specific service within the stack │
|
│ --service -s TEXT Target a specific service within the stack │
|
||||||
│ --config -c PATH Path to config file │
|
│ --config -c PATH Path to config file │
|
||||||
│ --help -h Show this message and exit. │
|
│ --help -h Show this message and exit. │
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -774,15 +768,14 @@ Full `--help` output for each command. See the [Usage](#usage) table above for a
|
|||||||
Use --no-strays to skip stopping stray stacks.
|
Use --no-strays to skip stopping stray stacks.
|
||||||
Use --full to also run 'up' on all stacks (picks up compose/env changes).
|
Use --full to also run 'up' on all stacks (picks up compose/env changes).
|
||||||
|
|
||||||
╭─ Options ────────────────────────────────────────────────────────────────────╮
|
╭─ Options ──────────────────────────────────────────────────────────────────────────────╮
|
||||||
│ --dry-run -n Show what would change without executing │
|
│ --dry-run -n Show what would change without executing │
|
||||||
│ --no-orphans Only migrate, don't stop orphaned stacks │
|
│ --no-orphans Only migrate, don't stop orphaned stacks │
|
||||||
│ --no-strays Don't stop stray stacks (running on wrong host) │
|
│ --no-strays Don't stop stray stacks (running on wrong host) │
|
||||||
│ --full -f Also run up on all stacks to apply config │
|
│ --full -f Also run up on all stacks to apply config changes │
|
||||||
│ changes │
|
│ --config -c PATH Path to config file │
|
||||||
│ --config -c PATH Path to config file │
|
│ --help -h Show this message and exit. │
|
||||||
│ --help -h Show this message and exit. │
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -819,17 +812,16 @@ Full `--help` output for each command. See the [Usage](#usage) table above for a
|
|||||||
cf compose mystack exec web bash - interactive shell
|
cf compose mystack exec web bash - interactive shell
|
||||||
cf compose mystack config - view parsed config
|
cf compose mystack config - view parsed config
|
||||||
|
|
||||||
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
|
╭─ Arguments ────────────────────────────────────────────────────────────────────────────╮
|
||||||
│ * stack TEXT Stack to operate on (use '.' for current dir) │
|
│ * stack TEXT Stack to operate on (use '.' for current dir) [required] │
|
||||||
│ [required] │
|
│ * command TEXT Docker compose command [required] │
|
||||||
│ * command TEXT Docker compose command [required] │
|
│ args [ARGS]... Additional arguments │
|
||||||
│ args [ARGS]... Additional arguments │
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
╭─ Options ──────────────────────────────────────────────────────────────────────────────╮
|
||||||
╭─ Options ────────────────────────────────────────────────────────────────────╮
|
│ --host -H TEXT Filter to stacks on this host │
|
||||||
│ --host -H TEXT Filter to stacks on this host │
|
│ --config -c PATH Path to config file │
|
||||||
│ --config -c PATH Path to config file │
|
│ --help -h Show this message and exit. │
|
||||||
│ --help -h Show this message and exit. │
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -858,16 +850,16 @@ Full `--help` output for each command. See the [Usage](#usage) table above for a
|
|||||||
|
|
||||||
Generate a Traefik file-provider fragment from compose Traefik labels.
|
Generate a Traefik file-provider fragment from compose Traefik labels.
|
||||||
|
|
||||||
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
|
╭─ Arguments ────────────────────────────────────────────────────────────────────────────╮
|
||||||
│ stacks [STACKS]... Stacks to operate on │
|
│ stacks [STACKS]... Stacks to operate on │
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
╭─ Options ────────────────────────────────────────────────────────────────────╮
|
╭─ Options ──────────────────────────────────────────────────────────────────────────────╮
|
||||||
│ --all -a Run on all stacks │
|
│ --all -a Run on all stacks │
|
||||||
│ --output -o PATH Write Traefik file-provider YAML to this path │
|
│ --output -o PATH Write Traefik file-provider YAML to this path (stdout if │
|
||||||
│ (stdout if omitted) │
|
│ omitted) │
|
||||||
│ --config -c PATH Path to config file │
|
│ --config -c PATH Path to config file │
|
||||||
│ --help -h Show this message and exit. │
|
│ --help -h Show this message and exit. │
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -903,16 +895,16 @@ Full `--help` output for each command. See the [Usage](#usage) table above for a
|
|||||||
|
|
||||||
Use 'cf apply' to make reality match your config (stop orphans, migrate).
|
Use 'cf apply' to make reality match your config (stop orphans, migrate).
|
||||||
|
|
||||||
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
|
╭─ Arguments ────────────────────────────────────────────────────────────────────────────╮
|
||||||
│ stacks [STACKS]... Stacks to operate on │
|
│ stacks [STACKS]... Stacks to operate on │
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
╭─ Options ────────────────────────────────────────────────────────────────────╮
|
╭─ Options ──────────────────────────────────────────────────────────────────────────────╮
|
||||||
│ --all -a Run on all stacks │
|
│ --all -a Run on all stacks │
|
||||||
│ --config -c PATH Path to config file │
|
│ --config -c PATH Path to config file │
|
||||||
│ --log-path -l PATH Path to Dockerfarm TOML log │
|
│ --log-path -l PATH Path to Dockerfarm TOML log │
|
||||||
│ --dry-run -n Show what would change without writing │
|
│ --dry-run -n Show what would change without writing │
|
||||||
│ --help -h Show this message and exit. │
|
│ --help -h Show this message and exit. │
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -945,14 +937,14 @@ Full `--help` output for each command. See the [Usage](#usage) table above for a
|
|||||||
|
|
||||||
Use --local to skip SSH-based checks for faster validation.
|
Use --local to skip SSH-based checks for faster validation.
|
||||||
|
|
||||||
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
|
╭─ Arguments ────────────────────────────────────────────────────────────────────────────╮
|
||||||
│ stacks [STACKS]... Stacks to operate on │
|
│ stacks [STACKS]... Stacks to operate on │
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
╭─ Options ────────────────────────────────────────────────────────────────────╮
|
╭─ Options ──────────────────────────────────────────────────────────────────────────────╮
|
||||||
│ --local Skip SSH-based checks (faster) │
|
│ --local Skip SSH-based checks (faster) │
|
||||||
│ --config -c PATH Path to config file │
|
│ --config -c PATH Path to config file │
|
||||||
│ --help -h Show this message and exit. │
|
│ --help -h Show this message and exit. │
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -984,16 +976,16 @@ Full `--help` output for each command. See the [Usage](#usage) table above for a
|
|||||||
communication. Uses the same subnet/gateway on all hosts to ensure
|
communication. Uses the same subnet/gateway on all hosts to ensure
|
||||||
consistent networking.
|
consistent networking.
|
||||||
|
|
||||||
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
|
╭─ Arguments ────────────────────────────────────────────────────────────────────────────╮
|
||||||
│ hosts [HOSTS]... Hosts to create network on (default: all) │
|
│ hosts [HOSTS]... Hosts to create network on (default: all) │
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
╭─ Options ────────────────────────────────────────────────────────────────────╮
|
╭─ Options ──────────────────────────────────────────────────────────────────────────────╮
|
||||||
│ --network -n TEXT Network name [default: mynetwork] │
|
│ --network -n TEXT Network name [default: mynetwork] │
|
||||||
│ --subnet -s TEXT Network subnet [default: 172.20.0.0/16] │
|
│ --subnet -s TEXT Network subnet [default: 172.20.0.0/16] │
|
||||||
│ --gateway -g TEXT Network gateway [default: 172.20.0.1] │
|
│ --gateway -g TEXT Network gateway [default: 172.20.0.1] │
|
||||||
│ --config -c PATH Path to config file │
|
│ --config -c PATH Path to config file │
|
||||||
│ --help -h Show this message and exit. │
|
│ --help -h Show this message and exit. │
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -1021,19 +1013,18 @@ Full `--help` output for each command. See the [Usage](#usage) table above for a
|
|||||||
|
|
||||||
Manage compose-farm configuration files.
|
Manage compose-farm configuration files.
|
||||||
|
|
||||||
╭─ Options ────────────────────────────────────────────────────────────────────╮
|
╭─ Options ──────────────────────────────────────────────────────────────────────────────╮
|
||||||
│ --help -h Show this message and exit. │
|
│ --help -h Show this message and exit. │
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
╭─ Commands ───────────────────────────────────────────────────────────────────╮
|
╭─ Commands ─────────────────────────────────────────────────────────────────────────────╮
|
||||||
│ init Create a new config file with documented example. │
|
│ init Create a new config file with documented example. │
|
||||||
│ edit Open the config file in your default editor. │
|
│ edit Open the config file in your default editor. │
|
||||||
│ show Display the config file location and contents. │
|
│ show Display the config file location and contents. │
|
||||||
│ path Print the config file path (useful for scripting). │
|
│ path Print the config file path (useful for scripting). │
|
||||||
│ validate Validate the config file syntax and schema. │
|
│ validate Validate the config file syntax and schema. │
|
||||||
│ symlink Create a symlink from the default config location to a config │
|
│ symlink Create a symlink from the default config location to a config file. │
|
||||||
│ file. │
|
│ init-env Generate a .env file for Docker deployment. │
|
||||||
│ init-env Generate a .env file for Docker deployment. │
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -1061,14 +1052,14 @@ Full `--help` output for each command. See the [Usage](#usage) table above for a
|
|||||||
|
|
||||||
Manage SSH keys for passwordless authentication.
|
Manage SSH keys for passwordless authentication.
|
||||||
|
|
||||||
╭─ Options ────────────────────────────────────────────────────────────────────╮
|
╭─ Options ──────────────────────────────────────────────────────────────────────────────╮
|
||||||
│ --help -h Show this message and exit. │
|
│ --help -h Show this message and exit. │
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
╭─ Commands ───────────────────────────────────────────────────────────────────╮
|
╭─ Commands ─────────────────────────────────────────────────────────────────────────────╮
|
||||||
│ keygen Generate SSH key (does not distribute to hosts). │
|
│ keygen Generate SSH key (does not distribute to hosts). │
|
||||||
│ setup Generate SSH key and distribute to all configured hosts. │
|
│ setup Generate SSH key and distribute to all configured hosts. │
|
||||||
│ status Show SSH key status and host connectivity. │
|
│ status Show SSH key status and host connectivity. │
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -1097,19 +1088,18 @@ Full `--help` output for each command. See the [Usage](#usage) table above for a
|
|||||||
|
|
||||||
Show stack logs. With --service, shows logs for just that service.
|
Show stack logs. With --service, shows logs for just that service.
|
||||||
|
|
||||||
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
|
╭─ Arguments ────────────────────────────────────────────────────────────────────────────╮
|
||||||
│ stacks [STACKS]... Stacks to operate on │
|
│ stacks [STACKS]... Stacks to operate on │
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
╭─ Options ────────────────────────────────────────────────────────────────────╮
|
╭─ Options ──────────────────────────────────────────────────────────────────────────────╮
|
||||||
│ --all -a Run on all stacks │
|
│ --all -a Run on all stacks │
|
||||||
│ --host -H TEXT Filter to stacks on this host │
|
│ --host -H TEXT Filter to stacks on this host │
|
||||||
│ --service -s TEXT Target a specific service within the stack │
|
│ --service -s TEXT Target a specific service within the stack │
|
||||||
│ --follow -f Follow logs │
|
│ --follow -f Follow logs │
|
||||||
│ --tail -n INTEGER Number of lines (default: 20 for --all, 100 │
|
│ --tail -n INTEGER Number of lines (default: 20 for --all, 100 otherwise) │
|
||||||
│ otherwise) │
|
│ --config -c PATH Path to config file │
|
||||||
│ --config -c PATH Path to config file │
|
│ --help -h Show this message and exit. │
|
||||||
│ --help -h Show this message and exit. │
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -1142,16 +1132,16 @@ Full `--help` output for each command. See the [Usage](#usage) table above for a
|
|||||||
With --host: shows stacks on that host.
|
With --host: shows stacks on that host.
|
||||||
With --service: filters to a specific service within the stack.
|
With --service: filters to a specific service within the stack.
|
||||||
|
|
||||||
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
|
╭─ Arguments ────────────────────────────────────────────────────────────────────────────╮
|
||||||
│ stacks [STACKS]... Stacks to operate on │
|
│ stacks [STACKS]... Stacks to operate on │
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
╭─ Options ────────────────────────────────────────────────────────────────────╮
|
╭─ Options ──────────────────────────────────────────────────────────────────────────────╮
|
||||||
│ --all -a Run on all stacks │
|
│ --all -a Run on all stacks │
|
||||||
│ --host -H TEXT Filter to stacks on this host │
|
│ --host -H TEXT Filter to stacks on this host │
|
||||||
│ --service -s TEXT Target a specific service within the stack │
|
│ --service -s TEXT Target a specific service within the stack │
|
||||||
│ --config -c PATH Path to config file │
|
│ --config -c PATH Path to config file │
|
||||||
│ --help -h Show this message and exit. │
|
│ --help -h Show this message and exit. │
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -1183,14 +1173,13 @@ Full `--help` output for each command. See the [Usage](#usage) table above for a
|
|||||||
With --live: Also queries Docker on each host for container counts.
|
With --live: Also queries Docker on each host for container counts.
|
||||||
With --containers: Shows per-container resource stats (requires Glances).
|
With --containers: Shows per-container resource stats (requires Glances).
|
||||||
|
|
||||||
╭─ Options ────────────────────────────────────────────────────────────────────╮
|
╭─ Options ──────────────────────────────────────────────────────────────────────────────╮
|
||||||
│ --live -l Query Docker for live container stats │
|
│ --live -l Query Docker for live container stats │
|
||||||
│ --containers -C Show per-container resource stats (requires │
|
│ --containers -C Show per-container resource stats (requires Glances) │
|
||||||
│ Glances) │
|
│ --host -H TEXT Filter to stacks on this host │
|
||||||
│ --host -H TEXT Filter to stacks on this host │
|
│ --config -c PATH Path to config file │
|
||||||
│ --config -c PATH Path to config file │
|
│ --help -h Show this message and exit. │
|
||||||
│ --help -h Show this message and exit. │
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -1217,12 +1206,12 @@ Full `--help` output for each command. See the [Usage](#usage) table above for a
|
|||||||
|
|
||||||
List all stacks and their assigned hosts.
|
List all stacks and their assigned hosts.
|
||||||
|
|
||||||
╭─ Options ────────────────────────────────────────────────────────────────────╮
|
╭─ Options ──────────────────────────────────────────────────────────────────────────────╮
|
||||||
│ --host -H TEXT Filter to stacks on this host │
|
│ --host -H TEXT Filter to stacks on this host │
|
||||||
│ --simple -s Plain output (one stack per line, for scripting) │
|
│ --simple -s Plain output (one stack per line, for scripting) │
|
||||||
│ --config -c PATH Path to config file │
|
│ --config -c PATH Path to config file │
|
||||||
│ --help -h Show this message and exit. │
|
│ --help -h Show this message and exit. │
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -1251,12 +1240,12 @@ Full `--help` output for each command. See the [Usage](#usage) table above for a
|
|||||||
|
|
||||||
Start the web UI server.
|
Start the web UI server.
|
||||||
|
|
||||||
╭─ Options ────────────────────────────────────────────────────────────────────╮
|
╭─ Options ──────────────────────────────────────────────────────────────────────────────╮
|
||||||
│ --host -H TEXT Host to bind to [default: 0.0.0.0] │
|
│ --host -H TEXT Host to bind to [default: 0.0.0.0] │
|
||||||
│ --port -p INTEGER Port to listen on [default: 8000] │
|
│ --port -p INTEGER Port to listen on [default: 8000] │
|
||||||
│ --reload -r Enable auto-reload for development │
|
│ --reload -r Enable auto-reload for development │
|
||||||
│ --help -h Show this message and exit. │
|
│ --help -h Show this message and exit. │
|
||||||
╰──────────────────────────────────────────────────────────────────────────────╯
|
╰────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user