Skip to content

ezgh fleets run

Run a command or a saved script on nodes.

Updated View as Markdown
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.

Navigation

Type to search…

↑↓ navigate↵ selectEsc close