Platform update

Platform update configuration

The platform update is configured in the ModuleConfig resource deckhouse.

To view the current configuration of update settings, use the following command:

d8 k get mc deckhouse -oyaml

Example output:

...
spec:
  settings:
    releaseChannel: Stable
    update:
      windows:
        - days:
            - Mon
          from: "19:00"
          to: "20:00"
...

Update mode configuration

The platform supports three update modes:

• Automatic + no update windows set. The cluster updates immediately after a new version is available on the corresponding update channel.
• Automatic + update windows set. The cluster updates during the next available update window after a new version is available on the update channel.
• Manual mode. Updates require manual actions.

Example configuration snippet for enabling automatic platform updates:

update:
  mode: Auto

Example configuration snippet for enabling automatic platform updates with update windows:

update:
  mode: Auto
  windows:
    - from: "8:00"
      to: "15:00"
      days:
        - Tue
        - Sat

Example configuration snippet for enabling manual platform update mode:

update:
  mode: Manual

Release channels

The platform uses five release channels designed for various environments. Platform components can be updated either automatically or with manual confirmation as updates are released in the respective channels.

Information about versions available in release channels can be found at https://releases.deckhouse.io/.

To switch to a different release channel, set the .spec.settings.releaseChannel parameter in the deckhouse module configuration.

Example configuration for the deckhouse module with the release channel set to Stable:

apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
  name: deckhouse
spec:
  version: 1
  settings:
    releaseChannel: Stable

• When switching the update channel to a more stable one (e.g., from Alpha to EarlyAccess), Deckhouse performs the following actions:
  • Downloads release data (in this example, from the EarlyAccess channel) and compares it with existing DeckhouseRelease resources in the cluster:
    • Later releases that have not yet been applied (status Pending) are deleted.
    • If later releases are already applied (status Deployed), the release change does not occur. In this case, the platform remains on the current release until a newer release appears in the EarlyAccess update channel.
• When switching the update channel to a less stable one (e.g., from EarlyAccess to Alpha):
  • Deckhouse downloads release data (in this example, from the Alpha channel) and compares it with existing DeckhouseRelease resources in the cluster.
  • The platform then updates according to the configured update parameters.

To view the list of platform releases, use the following commands:

d8 k get deckhouserelease
d8 k get modulereleases

To disable the platform update mechanism, remove the .spec.settings.releaseChannel parameter from the deckhouse module configuration. In this case, the platform does not check for updates, and patch-release updates are not performed.

Immediate Update Application

To apply an update immediately, set the annotation release.deckhouse.io/apply-now: "true" on the corresponding DeckhouseRelease resource.

Example command to set the annotation for bypassing update windows for version v1.56.2:

d8 k annotate deckhousereleases v1.56.2 release.deckhouse.io/apply-now="true"

Example of a resource with the annotation to bypass update windows:

apiVersion: deckhouse.io/v1alpha1
kind: DeckhouseRelease
metadata:
  annotations:
    release.deckhouse.io/apply-now: "true"