Waypoint Job list
Edit this page on GitHub
waypoint job list
List all jobs in Waypoint
waypoint job list [options]
List known jobs from Waypoint server. Options to filter job list by project, workspace, target runner, pipeline, and pipeline run.
-plain- Plain output: no colors, no animation. The default is false.
-a) - App to target. Certain commands require a single app target for Waypoint configurations with multiple apps. If you have a single app, then this can be ignored.
-p) - Project to target.
-w) - Workspace to operate in.
-label=<key=value>- Labels to set for this operation. Can be specified multiple times.
-local- True to use a local runner to execute the operation, false to use a remote runner. If unset, Waypoint will automatically determine where the operation will occur, defaulting to remote if possible.
-remote-source=<key=value>- Override configurations for how remote runners source data. This is specified to the data source type being used in your configuration. This is used for example to set a specific Git ref to run against.
-var=<key=value>- Variable value to set for this operation. Can be specified multiple times.
-var-file=<string>- HCL or JSON file containing variable values to set for this operation. If any ".auto.wpvars" or ".auto.wpvars.json" files are present, they will be automatically loaded.
-state=<string>- List jobs that only match the requested state. Can be repeated multiple times. One possible value from: Success, Error, Running, Waiting, Queued, Unknown.
-target-runner-id=<string>- List jobs that were only assigned to the target runner by id.
-target-runner-label=<key=value>- List jobs that were only assigned to the target runner by labels. Can be repeated multiple times.
-pipeline-id=<string>- List jobs initiated by the specific pipeline, look up by pipeline ID.
-pipeline-name=<string>- List jobs initiated by the specific pipeline, look up by pipeline owner.
-run=<int>- List jobs initiated by the specific pipeline run, only valid used together with -pipeline.
-desc- Output the list of jobs from newest to oldest. The default is false.
-json- Output the list of jobs as json. Includes all fields for jobs. The default is false.
-verbose- Output more details for a job. The default is false.
-limit=<int>- If set, will limit the number of jobs to list.