Waypoint Commands (CLI)
Waypoint is controlled via a very easy to use command-line interface (CLI). Waypoint is only a single command-line application: `waypoint`. This application then takes a subcommand such as `artifact` or `deployment`.
Waypoint is controlled via a very easy to use command-line interface (CLI). Waypoint
is only a single command-line application:
waypoint. This application then takes a
subcommand such as
deployment. The complete list of subcommands is in
the navigation to the left.
The waypoint CLI is a well-behaved command line application. In erroneous cases, a non-zero exit status will be returned. It also responds to -h and --help as you'd most likely expect.
To view a list of the available commands at any time, just run waypoint with no arguments:
Usage: waypoint [-version] [-help] [-autocomplete-(un)install] <command> [args]
build Build a new versioned artifact from source
deploy Deploy a pushed artifact
release Release a deployment
up Perform the build, deploy, and release steps
artifact Artifact and build management
auth-method Auth method management
config Application configuration management
context Server access configurations
deployment Deployment creation and management
destroy Delete all the resources created
docs Show documentation for components
exec Execute a command in the context of a running application instance
fmt Rewrite waypoint.hcl configuration to a canonical format
hostname Application URLs
init Initialize and validate a project
install Install the Waypoint server to Kubernetes, Nomad, or Docker
logs Show log output from the current application deployment
project Project management
runner Runner management
server Server management
ui Open the web UI
user User information and management
version Prints the version of this Waypoint CLI
To get help for any specific command, pass the -h flag to the relevant subcommand. For example, to see help about the up subcommand:
$ waypoint up -h
Usage: waypoint up [options]
Perform the build, deploy, and release steps.
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. This is aliased as "-a".
Plain output: no colors, no animation. The default is false.
Project to target. This is aliased as "-p".
Workspace to operate in. This is aliased as "-w".
Labels to set for this operation. Can be specified multiple times.
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.
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.
Variable value to set for this operation. Can be specified multiple
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.
Prune old unreleased deployments. The default is true.
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.
waypoint -autocomplete-install will add the waypoint autocomplete capability
so you can do
waypoint <tab> on commands. Running
will remove it. Please note that this will modify your shell init script, so you will
need to reload your shell.