porter target - Porter

porter target contains commands for managing deployment targets.

Prerequisites

List all deployment targets in the current cluster. Usage:

porter target list [flags]

Options:

Flag	Description
`--preview`	Include preview environment targets

porter target list

porter target list --preview

Deployment targets allow you to deploy the same application to different environments (production, staging, preview) within the same cluster.

Create a new deployment target in the current cluster. Usage:

porter target create --name [name]

Options:

Flag	Description
`--name`	Name of the deployment target to create (required)

Create Target

porter target create --name staging

On success, the command prints the new target’s ID:

Created target with name staging and id cc1b12a3-1481-4b98-910f-12bf8c13f5d4

Delete a deployment target from the current cluster. Works for both standard and preview environment targets. Usage:

porter target delete --name [name] [flags]

Options:

Flag	Description
`--name`	Name of the deployment target to delete (required)
`-f`, `--force`	Skip the confirmation prompt

porter target delete --name staging

porter target delete --name staging --force

The default deployment target for a cluster can’t be deleted. Attempting to delete it returns an error.

Specify a target when deploying with porter apply:

porter apply -f porter.yaml --target staging

Preview environment targets are automatically created when you set up preview environments. See Preview Environments for more details.