Skip to main content
Version: latest

Login

The login command authenticates the Palette CLI with Palette. The login command can be used in interactive mode, which prompts you for required values. Or, you can use flags to provide the command with all the required values such as the API key, the organization ID, and the Palette URL.

Prerequisites

  • You must provide an encryption passphrase to secure sensitive data. The passphrase must be between 8 to 32 characters long and contain a capital letter, a lowercase letter, a digit, and a special character. You can provide the passphrase through the PALETTE_ENCRYPTION_PASSWORD environment variable or the -k or --encryption-passphrase flag. Refer to the Encryption section for more information on encryption.

Login

Short FlagLong FlagDescriptionType
---api-keyPalette API key. Omit for interactive login.string
- --cluster-group-namePalette Cluster Group name (optional). Specifies the active cluster group.string
---cluster-group-scopePalette cluster group scope. Required with --cluster-group-name. Allowed values are: project, tenant , and system.string
---console-urlPalette URL (omit for interactive login).string
-h--helpHelp for the login subcommand.-
-k--encryption-passphraseEncryption passphrase to secure sensitive data. The passphrase must be between 8 to 32 characters long and contain a capital letter, a lowercase letter, a digit, and a special character. Can be set through the environment variable PALETTE_ENCRYPTION_PASSWORD. Refer to the Encryption section for more information on encryption.string
---insecureSkip Transport Layer Security (TLS) (bypass x509 verification).-
---orgPalette Organization name. Omit for interactive login.string
---projectPalette Project name (optional). Specifies the active project.string

Examples

palette login --api-key 123456789 --org demo-org --console-url https://console.spectrocloud.com

If you want to target a specific project when using the login command, use the --project flag.

palette login  \
--api-key 123456789 \
--org demo-org \
--console-url https://console.spectrocloud.com \
--project dev-team

Upon successful login, a local configuration file named palette.yaml is created. This file contains the metadata for CLI operations and is created in your $HOME directory under the folder name .palette. The following output is an example of a palette.yaml configuration file. Sensitive values, such as passwords, tokens, and API keys are encrypted at rest.

paletteConfig:
organization: demo-org
scope: tenant
projectName: dev-team
projectUid: 6342eab2faa0813ead9082e0
clusterGroupName: beehive
clusterGroupUid: 635669ba4583891d109fe6c0
tenantUid: 40b8a9a7f724831be814e5734ea744ed
ubuntuConfig:
enablefips: false
token: ""
scarConfig:
scarLoc: ""
scarUsername: ""
scarPassword: ""
mgmt:
apikey: ************************
endpoint: https://console.spectrocloud.com
insecure: false
pairingcode: ""
runLoc: /Users/demo/.palette/
workspaceLoc: /Users/demo/.palette