Cluster Updates

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. For more information, refer to Repave Behaviors and Configurations.

Limitations

warning

Once you upgrade your cluster to a new Kubernetes version, you will not be able to downgrade. We recommend that, before upgrading, you review the information provided in the Kubernetes Upgrades section.

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

Enablement

Use a new cluster profile version

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 Save. Depending on the changes you made to the profile, doing so might trigger a cluster repave warning. Click Continue to confirm updating the cluster.

Update cluster profile

You can make updates to a profile that is in use by one or more active clusters. Changing a deployed cluster profile will trigger an update to all clusters using the cluster profile. For more information, refer to Update a Cluster Profile.

warning

We do not recommend updating a currently deployed cluster profile version to push out changes. Instead, we recommend you create a new profile version, and then upgrade active clusters to the new version. Check out the Version a Cluster Profile for guidance on creating a new cluster profile version.

Override cluster profile configurations

You can modify the configuration of a deployed cluster without changing the cluster profile itself to update a cluster.

warning

We do not recommend updating a currently deployed cluster's profile configurations without updating the profile itself. Instead, we recommend creating a new profile version, and then upgrade active clusters to the new version. Check out the Version a Cluster Profile for guidance on creating a new cluster profile version.

1. Log in to Palette.

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

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

4. In the profile tab, make changes to the different layers as appropriate. The changes you make here are specific to this cluster only and do not propagate to the cluster profile or other clusters using the same profile.

5. Click Save to confirm your changes. Acknowledge the cluster repave warning if necessary.

Validation

Use a new cluster profile version

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.

Update cluster profile

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.

Override cluster profile configurations

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.