vh execution¶
vh execution¶
Execution-related commands.
vh execution [OPTIONS] COMMAND [ARGS]...
delete¶
Delete one or more executions, optionally purging their outputs as well.
vh execution delete [OPTIONS] [COUNTERS]...
Options
-
--purge-outputs,--no-purge-outputs¶ purge outputs of the executions too
Arguments
-
COUNTERS¶ Optional argument(s)
list¶
Show a list of executions for the project.
vh execution list [OPTIONS]
Options
-
--status<status>¶ Filter by status (default: all)
Options: complete|crashed|created|error|incomplete|queued|started|stopped|stopping
-
-n,--count,--limit<count>¶ How many executions to show
logs¶
Show or stream execution event log.
vh execution logs [OPTIONS] COUNTER
Options
-
--status,--no-status¶ Show status messages
-
--stderr,--no-stderr¶ Show stderr messages
-
--stdout,--no-stdout¶ Show stdout messages
-
--stream,--no-stream¶ Watch and wait for new messages?
-
--all,--no-all¶ Get all messages? This may take a while.
Arguments
-
COUNTER¶ Required argument
open¶
Open an execution in a web browser.
vh execution open [OPTIONS] COUNTER
Arguments
-
COUNTER¶ Required argument
outputs¶
List and download execution outputs.
vh execution outputs [OPTIONS] COUNTER
Options
-
-d,--download<download_directory>¶ Download files to this directory (by default, don’t download). You can use `{counter}` as a placeholder that will be replaced by the execution’s counter number.
-
-f,--filter-download<filter_download>¶ Download only files matching this glob.
-
--force¶ Download all files even if they already exist.
-
-s,--sync¶ Keep watching for new output files to download.
Arguments
-
COUNTER¶ Required argument
run¶
Start an execution of a step.
vh execution run [OPTIONS] STEP-NAME STEP-
OPTIONS...
Options
-
-c,--commit<commit>¶ The commit to use. Defaults to the current HEAD.
-
-e,--environment<environment>¶ The environment UUID or slug to use (see `vh env`)
-
-i,--image<image>¶ Override the Docker image specified in the step.
-
-t,--title<title>¶ Title of the execution.
-
-w,--watch¶ Start `exec watch`ing the execution after it starts.
-
-v,--var<environment_variables>¶ Add environment variable (NAME=VALUE). May be repeated.
-
-s,--sync<sync>¶ Download execution outputs to DIRECTORY.
-
-a,--adhoc¶ Upload the current state of the working directory, then run it as an ad-hoc execution.
-
--validate-adhoc,--no-validate-adhoc¶ Enable or disable validation of adhoc packaged code, on by default
Arguments
-
STEP-NAME¶ Optional argument
-
STEP-OPTIONS...¶ Optional argument(s)
stop¶
Stop one or more in-progress executions.
vh execution stop [OPTIONS] [COUNTERS]...
Options
-
--all¶ Stop all in-progress executions.
Arguments
-
COUNTERS¶ Optional argument(s)