Waypoint Runner token

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 runner token

Request a new token to run a runner

Usage

Usage: waypoint runner token [options]

Generate a new runner token used for runners.

This generates a new token that can be used for "waypoint runner agent". Generating a token in advance enables the "pre-adoption" mode where a runner avoids the manual adoption process and begins accepting work immediately.

While this makes it possible to do things such as automate runners all the way to running, it is generally not recommended since it requires a higher level of security to transfer a token around.

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.

Command Options

-expires-in=<duration> - The duration until the token expires. i.e. '5m'. The default is 720h0m0s.
-id=<string> - Id to restrict this token to. If empty, all runner IDs are valid.
-label=<key=value> - Labels that must match the runner for this token to be valid. These are set in 'k=v' format and this flag can be repeated to set multiple labels. If no labels are set, runners with any labels are valid.