Skip to main content

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.


Long FlagDescriptionType
--kubeconfigPath to the kubeconfig for the cluster you would like to import (optional)string
--kubeconfig-dirPath to directory containing kubeconfigs for one or more clusters (optional)string
--uuidIf 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