ezgh fleets run (--node n... | --tag key=value...) (--command c | --script s) [--as account] [--wait] [flags]Run a command (with /bin/sh -c) or a saved script’s version on nodes: those named with --node (ID, slug or name; repeat), or every node in the project with all the --tag key=value pairs when the run starts. It runs as --as on each node (default ezgh-user); IAM decides which accounts you may use.
--max-concurrency (a number or a percentage of the targets, default 50) limits how many nodes run it at once, and --max-errors (default 0) how many may fail before no more start. --timeout (default 1h) ends each invocation; an offline node has --delivery-timeout (default 1h) to come online. Output isn’t kept: each node reports its status and exit code.
Without --wait it prints the run as created; ezgh fleets runs get follows it. With --wait it waits until the run ends, prints every node’s result, and exits 1 unless every invocation succeeded.
Part of ezgh fleets.
Flags
| Flag | Type | Default | Description |
|---|---|---|---|
--as |
string | ezgh-user |
the account to run as on each node |
--command |
string | the command, run with /bin/sh -c | |
--delivery-timeout |
string | how long an offline node has to come online: 30s to 48h (default 1h) | |
--max-concurrency |
string | nodes running it at once: a number or a percentage (default 50) | |
--max-errors |
string | failures after which no more nodes start it: a number or a percentage (default 0) | |
--node |
string, repeatable | a node to run on: ID, slug or name (repeat) | |
--param |
string, repeatable | a script parameter, name=value (repeat) | |
--script |
string | a saved script to run: ID, slug or name | |
--tag |
string, repeatable | run on every node with this tag, key=value (repeat: all must match) | |
--timeout |
string | how long each invocation may run: 1s to 48h (default 1h) | |
--version |
int | the script’s version (default: its latest) | |
--wait |
boolean | wait until the run ends, print every node’s result, and exit 1 unless all succeeded |
This command also takes the global flags.