Waypoint Deploy

Warning

This content is part of the legacy version of Waypoint that is no longer actively maintained. For additional information on the new vision of Waypoint, check out this blog post and the HCP Waypoint documentation.

Command: waypoint deploy

Deploy a pushed artifact

Usage

Usage: waypoint deployment deploy [options]

Alias: waypoint deploy

Deploy an application. This will deploy the most recent successful pushed artifact by default. You can view a list of recent artifacts using the "artifact list" command.

By default, "waypoint deploy" automatically performs a release. This behavior can be disabled by using the "-release=false" flag.

Global Options

-plain - Plain output: no colors, no animation. The default is false.
-app=<string> (-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.
-project=<string> (-p) - Project to target.
-workspace=<string> (-w) - Workspace to operate in.

Operation Options

-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.

Command Options

-release - Release this deployment immediately. The default is true.
-prune - Prune old unreleased deployments. The default is true.
-prune-retain=<int> - The number of unreleased deployments to keep. If this isn't set or is set to any negative number, then this will default to 1 on the server. If you want to prune all unreleased deployments, set this to 0. The default is -1.