Import a Cluster

When importing a cluster into Palette, you can select the mode you want Palette to use when managing the cluster. You can choose between read-only mode or full permission. Refer to the Imported Clusters reference page to learn more about each mode.

Select the mode you want to use when importing a cluster into Palette.

• Full Permissions

• Read-Only Mode

Full Permissions

Prerequisites

• Kubernetes version >= 1.19.X

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

• Ensure kubectl is installed and available in your local workstation.

• Access to your cluster environment through kubectl.

Import a Cluster

1. Log in to Palette.

2. Navigate to the left Main Menu and select Clusters.

3. Click on Add New Cluster and select Import Cluster in the pop-up box.

4. Fill out the required information and make your selections:

   • Cluster Name - The name of the cluster you want to import.
   • Cloud Type - Select the infrastructure environment your cluster resides in. Select Generic if the environment list doesn't contain your specific environment, but be aware of the limitations with generic clusters.
   • Proxy - Optional and only available for generic clusters. Specify a network proxy address or DNS value.
   • No Proxy - Optional and only available for generic clusters. Specify a no proxy address or DNS value.
   • Host Path - Used to specify the Certificate Authority (CA) file path for the cluster. This is the location on the physical host machine where the CA file is stored.
   • Container Mount Path - Used to specify the container mount path where the CA file is mounted in the container.

5. Select Full-permission mode and click on Create & Open Cluster Instance to start the import.

6. You will be redirected to the cluster details page. A set of instructions with commands is displayed on the right side of the screen. You will need to issue the following commands to complete the import process.

   
   

   

   
   

7. We recommend you install the metrics server so that Palette can expose and provide you with information about the cluster. Installing the metrics server is not required but is needed for Palette to expose cluster metrics. To enable the metrics server, open a terminal session and issue the commands below against the Kubernetes cluster you want to import.

   
   

   helm repo add bitnami https://charts.bitnami.com/bitnami && \
   helm install my-release bitnami/metrics-server

8. To install the Palette agent, issue the command displayed in the cluster details page Install the agent section against the Kubernetes cluster you want to import. The command is customized for your cluster as it contains the assigned cluster ID. Below is an example output of the install command.

   
   

   kubectl apply --filename https://api.spectrocloud.com/v1/spectroclusters/6491d4a94c39ad82d3cc30ae/import/manifest

   Output

   namespace/cluster-6491d4a94c39ad82d3cc30ae created
   serviceaccount/cluster-management-agent created
   clusterrole.rbac.authorization.k8s.io/read-only-mode created
   clusterrolebinding.rbac.authorization.k8s.io/read-only-mode created
   configmap/log-parser-config created
   configmap/upgrade-info-8kfc2m8mt8 created
   configmap/version-info-kbk5hk992f created
   secret/spectro-image-pull-secret created
   priorityclass.scheduling.k8s.io/spectro-cluster-critical created
   deployment.apps/cluster-management-agent-lite created
   configmap/cluster-info created
   configmap/hubble-info created
   secret/hubble-secrets created

9. When the Palette agent completes initializing, the cluster import procedures at right will disappear, and your cluster will transition to Running status within a few minutes.

   
   

   

   
   

You now have imported a cluster into Palette with full permissions.

Validate

1. Log in to Palette.

2. Navigate to the left Main Menu and select Clusters.

3. Select your imported cluster from the cluster list.

4. Review the Cluster Status row from the cluster details view. A successful cluster import will have the cluster status Running.

Read-only Mode

Prerequisites

• Kubernetes version >= 1.19.X

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

• Ensure kubectl is installed and available in your local workstation.

• Access to your cluster environment through kubectl.

• The cluster does not require a network proxy to communicate with Palette. Network proxy configurations are not supported in read-only mode. Use full permissions mode if you need to configure a network proxy.

Import a Cluster

1. Log in to Palette.

2. Navigate to the left Main Menu and select Clusters.

3. Click on Add New Cluster and select Import Cluster in the pop-up box.

4. Fill out the required information and make the proper selections:

   • Cluster Name - The name of the cluster you want to import.
   • Cloud Type - Select the infrastructure environment your cluster resides in. Select Generic if the environment list doesn't contain your specific environment but be aware of the limitations with generic clusters.
     • Host Path - Used to specify the Certificate Authority (CA) file path for the cluster. This is the location on the physical host machine where the CA file is stored.
   • Container Mount Path - Used to specify the container mount path where the CA file is mounted in the container.

5. Select Read-only mode and click on Create & Open Cluster Instance to start the import action.

6. You will be redirected to the cluster details page. A set of instructions with commands is displayed on the right-hand side of the screen. You will need to issue the following commands to complete the import process.

   

7. We recommend you install the metrics server so that Palette can expose and provide you with information about the cluster. Installing the metrics server is not required but is needed for Palette to expose cluster metrics. Open a terminal session and issue the commands below against the Kubernetes cluster you want to import if you want to enable the metrics server.

   helm repo add bitnami https://charts.bitnami.com/bitnami && \
   helm install my-release bitnami/metrics-server

8. To install the Palette agent, issue the command displayed in the cluster details page Install the read-only agent section against the Kubernetes cluster you want to import. The command is customized for your cluster as it contains the assigned cluster ID. Below is an example output of the install command.

   kubectl apply --filename https://api.spectrocloud.com/v1/spectroclusters/6491d4a94c39ad82d3cc30ae/import/manifest

   Output

   namespace/cluster-6491d4a94c39ad82d3cc30ae created
   serviceaccount/cluster-management-agent created
   clusterrole.rbac.authorization.k8s.io/read-only-mode created
   clusterrolebinding.rbac.authorization.k8s.io/read-only-mode created
   configmap/log-parser-config created
   configmap/upgrade-info-8kfc2m8mt8 created
   configmap/version-info-kbk5hk992f created
   secret/spectro-image-pull-secret created
   priorityclass.scheduling.k8s.io/spectro-cluster-critical created
   deployment.apps/cluster-management-agent-lite created
   configmap/cluster-info created
   configmap/hubble-info created
   secret/hubble-secrets created

9. Once the Palette agent completes the initialization, the side view drawer on the right will disappear, and your cluster will transition to a status of Running after a few moments.

   

You now have imported a cluster into Palette in read-only mode. Keep in mind that a cluster imported in read-only mode has limited capabilities. You can migrate to full permissions anytime by clicking Migrate To Full Permissions.

Validate

1. Log in to Palette.

2. Navigate to the left Main Menu and select Clusters.

3. Select your imported cluster from the cluster list.

4. Review the Cluster Status row from the cluster details view. A successful cluster import displays cluster status as Running.

Next Steps

Depending on what mode you selected for the migration, your next step is to either Attach an Add-on Profile or you can Migrate to Full Permissions.