fix: add COLUMNS and _TYPER_FORCE_DISABLE_TERMINAL for consistent output (#167)

This commit is contained in:
Bas Nijholt
2026-01-16 22:07:41 +01:00
committed by GitHub
parent 940bd9585a
commit 74cc2f3245
2 changed files with 213 additions and 222 deletions

View File

@@ -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

201
README.md
View File

@@ -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 │ │ up Start stacks (docker compose up -d). Auto-migrates if host changed.
│ changed. │
│ down Stop stacks (docker compose down). │ │ down Stop stacks (docker compose down). │
│ stop Stop services without removing containers (docker compose │ │ stop Stop services without removing containers (docker compose stop).
│ stop). │
│ pull Pull latest images (docker compose pull). │ │ pull Pull latest images (docker compose pull). │
│ restart Restart running containers (docker compose restart). │ │ restart Restart running containers (docker compose restart). │
│ update Update stacks (pull + build + up). Shorthand for 'up --pull │ │ update Update stacks (pull + build + up). Shorthand for 'up --pull --build'.
--build'. apply Make reality match config (start, migrate, stop strays/orphans as
apply Make reality match config (start, migrate, stop needed).
│ strays/orphans as needed). │
│ compose Run any docker compose command on a stack. │ │ compose Run any docker compose command on a stack. │
╰──────────────────────────────────────────────────────────────────────────────╯ ╰────────────────────────────────────────────────────────────────────────────────────────
╭─ Monitoring ─────────────────────────────────────────────────────────────────╮ ╭─ Monitoring ───────────────────────────────────────────────────────────────────────────
│ logs Show stack logs. With --service, shows logs for just that │ │ logs Show stack logs. With --service, shows logs for just that service.
│ service. │
│ ps Show status of stacks. │ │ ps Show status of stacks. │
│ stats Show overview statistics for hosts and stacks. │ │ stats Show overview statistics for hosts and stacks. │
│ list List all stacks and their assigned hosts. │ │ list List all stacks and their assigned hosts. │
╰──────────────────────────────────────────────────────────────────────────────╯ ╰────────────────────────────────────────────────────────────────────────────────────────
╭─ Server ─────────────────────────────────────────────────────────────────────╮ ╭─ Server ───────────────────────────────────────────────────────────────────────────────
│ web Start the web UI server. │ │ web Start the web UI server. │
╰──────────────────────────────────────────────────────────────────────────────╯ ╰────────────────────────────────────────────────────────────────────────────────────────
``` ```
@@ -546,10 +541,10 @@ 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 │
@@ -557,7 +552,7 @@ Full `--help` output for each command. See the [Usage](#usage) table above for a
│ --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. │
╰──────────────────────────────────────────────────────────────────────────────╯ ╰────────────────────────────────────────────────────────────────────────────────────────
``` ```