Skip to main content
Version: latest

Update a Cluster

Palette allows you to update active clusters. You can update any layer of a cluster, including all infrastructure layers and add-on layers. Depending on the nature of the update, a cluster update could trigger different cluster repave operations.

info

Palette requires explicit cluster-level approval to initiate repave operations, offering you more control over the repave schedule and methodology. Refer to Repave Behaviors and Configurations for more information.

Limitations

  • You cannot update a cluster while its status is still Provisioning.

  • You cannot change the Container Network Interface (CNI) of an Edge cluster. You must delete and re-create the cluster instead. For more information about creating an Edge cluster, refer to Create Cluster Definition.

Prerequisites

  • An active Kubernetes cluster in Palette.

Update a Cluster

This is the recommended best practice for updating a cluster in Palette.

  1. Log in to Palette.

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

  3. Create a new version of the profile you want to update. For more information, refer to Version a Cluster Profile.

  4. Navigate to the left Main Menu and select Cluster.

  5. Select the cluster you want to update, and navigate to the Profile tab of the cluster.

  6. Next to the name of the profile, click on the version number and select the new version you just published.

  7. Click Review & Save. Palette prompts you to preview the change summary.

  8. Click Review changes in Editor. Palette displays the changes, with the current configuration on the left and the incoming changes on the right. Review the changes and click Apply Changes.

    info

    Make sure to preserve any existing cluster profile overrides.

    Palette Editor that displays changes coming from the profile version update.

Validation

You can follow these steps to validate all cluster update approaches.

  1. Log in to Palette.

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

  3. Select the cluster you updated, and navigate to the Profile tab of the cluster.

  4. Confirm that the cluster is now using an updated profile.