Synopsis
fcli tool fcli run [-d=<workDir>] [--use-shell=<useShell>] [-v=<versionToRun>] [[-h] [--env-prefix=<prefix>] [--log-file=<logFile>] [--log-level=<logLevel>] [--log-mask=<level>] [--debug]] [<toolArgs>…]
Description
This command allows for running fcli as previously installed through the 'fcli tool fcli install' command. It is recommended to use double dashes to separate fcli options from the options to be passed to the fcli version being invoked, i.e., 'fcli tool fcli run <fcli options> — <target fcli version options>' to explicitly differentiate between those.
Options
- -d, --workdir=<workDir>
-
The working directory from where the tool should be invoked. Default value: current working directory.
- --use-shell=<useShell>
-
Whether to use a shell to run the wrapper script provided by this tool, or to use a direct Java invocation. Using a shell provides the same behavior as manually invoking the wrapper script from the command line, but may cause issues if no (compatible) shell is available on the system or in a Docker container. Using a direct Java invocation may cause slightly different tool behavior, but will also work if no compatible shell is available and allows for consistent lookup of the appropriate JRE to use, independent of how the wrapper script performs such a JRE lookup. Allowed values: no, yes, auto. Default value: auto, which will first try to run the wrapper script, and fall back to direct Java invocation if shell invocation fails.
- -v, --version=<versionToRun>
-
Tool version to run. The specified tool version must have been previously installed using the 'install' command. Default value: the tool version that was last installed.
Generic fcli options (also see documentation link below)
- --debug
-
Enable collection of debug logs.
- --env-prefix=<prefix>
-
Prefix for resolving default option values. Default value: FCLI_DEFAULT.
- -h, --help
-
Use 'fcli [command] -h' to display help for fcli (sub-)commands.
- --log-file=<logFile>
-
Write log output to file. Default: ./fcli.log if logging is enabled.
- --log-level=<logLevel>
-
Set logging level: TRACE, DEBUG, INFO, WARN, ERROR, NONE.
- --log-mask=<level>
-
Log mask level: high, medium, low, none. Default: medium. Masking is done on a best-effort basis; no guarantee that all sensitive data will be masked.