Command 'juju exec'
juju exec [options] <commands>
Run the commands on the remote targets specified.
--debug (= false)
Equivalent to --show-log --logging-config==DEBUG
-h, --help (= false)
Show help on a command or other topic.
--logging-config (= "")
Specify log levels for modules
--quiet (= false)
Show no informational output
--show-log (= false)
If set, write the log file to stderr
--verbose (= false)
Show more verbose output
-B, --no-browser-login (= false)
Do not use web browser for authentication
-a, --app, --application (= )
One or more application names
--all (= false)
Run the commands on all the machines
--background (= false)
Run the task in the background
--color (= false)
Use ANSI color codes in output
--execution-group (= "")
Commands in the same execution group are run sequentially
--format (= plain)
Specify output format (json|plain|yaml)
-m, --model (= "")
Model to operate in. Accepts
[<controller name>:]<model name>|<model UUID>
--machine (= )
One or more machine ids
--no-color (= false)
Disable ANSI color codes in output
-o, --output (= "")
Specify an output file
--operator (= false)
Run the commands on the operator (k8s-only)
--parallel (= true)
Run the commands in parallel without first acquiring a lock
-u, --unit (= )
One or more unit ids
--utc (= false)
Show times in UTC
--wait (= 0s)
Maximum wait time for a task to complete
Run a shell command on the specified targets. Only admin users of a model are able to use this command.
Targets are specified using either machine ids, application names or unit names. At least one target specifier is needed.
Multiple values can be set for
--unit by using
comma separated values.
Depending on the type of target, the user which the command runs as will be:
unit -> "root" machine -> "ubuntu"
The target and user are independent of whether
--application are used.
--all will run as “ubuntu” on machines and “root” on units.
--application will run as “root” on all units of that application.
Some options are shortened for usabilty purpose in CLI
--applicationcan also be specified as
--unitcan also be specified as
Valid unit identifiers are:
- a standard unit ID, such as mysql/0 or;
- leader syntax of the form /leader, such as
If the target is an application, the command is run on all units for that application. For example, if there was an application “mysql” and that application had two units, “mysql/0” and “mysql/1”, then
is equivalent to
--operator is provided on k8s models, commands are executed on the operator
instead of the workload. On IAAS models,
--operator has no effect.
Commands run for applications or units are executed in a ‘hook context’ for the unit.
Commands run on machines via the
--machine argument are run in parallel
If you want commands to be run sequentially in order of submission,
Such commands will first acquire a global execution lock on the host machine
before running, and release the lock when done.
It’s also possible to group commands so that those in the same group run
sequentially, but in parallel with other groups. This is done using
--all is provided as a simple way to run the command on all the machines
in the model. If you specify
--all you cannot provide additional
juju exec creates tasks, you can query for the status of commands
started with juju run by calling
juju operations --machines <id>,... --actions juju-exec
If you need to pass options to the command being run, you must precede the command and its arguments with “–”, to tell “juju exec” to stop processing those arguments. For example:
juju exec --all -- hostname -f
Last updated 1 year, 1 month ago.