Skip to content

Update Blueprint

Post cluster provision, users can update the blueprint anytime in two (2) approaches:

Approach 1: Blueprint Sync Status

  • Login to the controller and click Clusters under Infrastructure
  • Select the required cluster and click the Blueprint Sync success status icon

Below is an example of a cluster with minimal Blueprint

BP Sync Status Icon

  • Click Update Blueprint available at the top right corner of the screen
  • Select the required Blueprint (example: default) and Version (if applicable) from the drop-down
  • Click Save and Publish

Select BP

When a user attempts to update a blueprint during an ongoing blueprint sync, the following error occurs:

Blueprint is being synced, please retry after current sync has completed. A force update may leave your cluster in an unpredictable state

Enabling the Force Sync option triggers the blueprint sync forcefully on the cluster, even if a previous sync is in progress, and overrides the changes.

Blueprint Sync process begins and shows the status as In Progress

BP Update In Progress

Once the update is complete, the status changes to Success. Users can view the list of Blueprint Sync Add-Ons and Events

BP Update Success

Approach 2: Update Blueprint Option

  • Login to the controller and click Clusters under Infrastructure
  • Select the required cluster and click on the gear icon
  • Click Update Blueprint

Below is an example of a cluster with default Blueprint

BP Update Option

  • Select the required Blueprint (example: minimal) and **Version (if applicable) from the drop-down
  • Click Save and Publish

Select BP and Version

Blueprint Sync process begins and once updated, the status shows Success

Success BP Update

"No Change" in Blueprint Sync

When updating a blueprint, synchronization occurs only if there are changes to the add-ons in that specific blueprint version. Only the relevant components are updated, and for all other components that haven’t changed, it is considered a no operation and hence the system displays "No Change."

Failed BP Update

However, if an add-on failed in the previous sync, it will be retried in the next blueprint sync, even if it has not changed. Users also have the option to perform a Force Sync, which re-applies all add-ons regardless of whether they have been modified.

Failed Blueprint Sync

Blueprint Sync can fail if the user had misconfigured the cluster configuration (e.g. invalid Blueprint, versions or Add-Ons) or encountered storage limits for resources. When this occurs, red indication appears to show the sync failure. Hover over the red indication or Failed status icon to view the reason for sync failure

Failed BP Update

Users are allowed to edit the configuration and retry updating the Blueprint