Commands

You start the Palette CLI with a single command, palette. The CLI accepts various subcommands such as pde, help, and more. The Palette CLI will return a non-zero exit status during error scenarios. You can use the CLI flags -h and --help to learn more about each subcommand.

The complete list of subcommands is:

• completion - Generate the autocompletion script for the specified shell.

• help - Help with any command.

• pde - Palette Developer Experience.

Global Flags

Palette CLI supports the following global flags.

Short Flag	Long Flag	Description	Type
-c	--config	Config file location.	string
-h	--help	Help with any command.	N/A
-l	--log-level	Log level. Allowed values: panic fatal error warn info debug trace (default info)	string
-w	--workspace	Workspace location for staging runtime configurations and logs (default $HOME/.palette)	string

PDE

The pde subcommand interacts with the Palette Dev Engine (PDE) platform and its resources. You can use the pde command to log in to Palette, manage virtual clusters, and switch the project scope. The pde command exposes the following subcommands.

• cluster-group - Manage Palette Cluster Groups.

• login - Log in to Spectro Cloud Palette.

• project - Manage Palette Projects.

• virtual-cluster - Manage Palette Virtual Clusters.

cluster-group

Use this command to change the target cluster group commands will target. You can also list all available clusters. The cluster-group supports the following subcommands.

• list - List Palette Cluster Groups.

• switch - Switch your active Palette Cluster Group.

login

Use this command to authenticate with Palette. This command requires a Palette API key. The login command has no subcommands but exposes a set of flags to help you log in to the correct Palette environment and scope. The following CLI flags are available for the login command.

Flag	Description	Type	Required
--api-key	The Palette API key.	string	Yes
--cluster-group-name	The Palette Cluster Group name.	string	No
--cluster-group-scope	Palette Cluster Group scope.	string	No
--console-url	The Palette login URL. The default value is https://console.spectrocloud.com	string	No
--project	The Palette Project name. Defaults to Default.	string	No

Example:

palette pde login --api-key yourApiKeyHere --console-url https://console.spectrocloud.com

project

Use this command to change the project scope and list all available projects. You can also deactivate a project with this command. The project command supports the following subcommands.

• deactivate - Deactivate your active Palette project and switch to the tenant admin scope.

• list - List Palette projects.

• switch - Switch your active Palette project.

virtual-cluster

You can use the virtual-cluster command to manage virtual cluster resources. Below is a list of all the supported subcommands you can use. Use the --help flag to learn more about each subcommand.

• create - Create a Palette Virtual Cluster.

• delete - Delete a Palette Virtual Cluster.

• download-kubeconfig - Download the kubeconfig for a Palette Virtual Cluster.

• events - View events for a Palette Virtual Cluster.

• lifecycle - Pause or resume a Palette Virtual Cluster.

• list - List Palette Virtual Clusters.

• resize - Resize a Palette Virtual Cluster.