Import

The import command imports a cluster into Palette in full permission mode based on local kubeconfig files. Refer to the Imported Clusters reference page to learn more about imported clusters.

Prerequisites

• Kubernetes version 1.19.X or later on the cluster you are importing.

• Ensure your environment has network access to Palette SaaS or your self-hosted Palette instance.

• The kubectl CLI installed on your local machine.

• Access to your cluster environment through kubectl.

• Ensure you have admin or cluster-admin permissions on the cluster you are importing.

• You must log in to Palette using the login command before importing clusters.

• 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.

Short Flag	Long Flag	Description	Type
-k	---encryption-passphrase	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. Can be set through the environment variable PALETTE_ENCRYPTION_PASSWORD. Refer to the Encryption section for more information on encryption.	string
-	--kubeconfig	Path to the kubeconfig for the cluster you would like to import (optional)	string
-	--kubeconfig-dir	Path to directory containing kubeconfigs for one or more clusters (optional)	string
-	--uuid	If true, a partial UUID is appended to each cluster name (optional)	boolean

info

If neither flag is provided, the KUBECONFIG environment variable and ~/.kube/config will be checked and used respectively.

Examples

One Cluster with UUID

Import a cluster based on current KUBECONFIG found within ~/.kube/config and append a partial UUID.

palette import --uuid

One Cluster with Specified Kubeconfig

Import cluster with specified KUBECONFIG.

palette import --kubeconfig my-cluster.kubeconfig

Imported cluster my-cluster-b4430654

Multiple Clusters

Import clusters from a directory containing multiple KUBECONFIG files.

configs
├── my-cluster-1.kubeconfig
├── my-cluster-2.kubeconfig
└── my-cluster-3.kubeconfig

palette import --kubeconfig-dir configs --uuid

Imported cluster my-cluster-1-e7c1ea5e
Imported cluster my-cluster-2-98669d7c
Imported cluster my-cluster-3d7cc792f