Skip to content

Latest commit

 

History

History
87 lines (49 loc) · 3.33 KB

updating-embedded.mdx

File metadata and controls

87 lines (49 loc) · 3.33 KB

import UpdateAirGapAdm from "../partials/embedded-cluster/_update-air-gap-admin-console.mdx" import UpdateAirGapCli from "../partials/embedded-cluster/_update-air-gap-cli.mdx" import UpdateAirGapOverview from "../partials/embedded-cluster/_update-air-gap-overview.mdx" import DoNotDowngrade from "../partials/embedded-cluster/_warning-do-not-downgrade.mdx" import Overview from "../partials/embedded-cluster/_update-overview.mdx"

Performing Updates in Embedded Clusters

This topic describes how to perform updates for Replicated Embedded Cluster installations.

:::note If you are instead looking for information about Replicated kURL, see Performing Updates in kURL Clusters. :::

Overview

The following diagram demonstrates how updates are performed with Embedded Cluster in online (internet-connected) environments:

Embedded Cluster updates Kubernetes and an app in a customer environment

View a larger version of this image

As shown in the diagram above, users check for available updates from the KOTS Admin Console. When deploying the new version, both the application and the cluster infrastructure are updated as needed.

Update in Online Clusters

To perform an update with Embedded Cluster:

  1. In the Admin Console, go to the Version history tab.

    All versions available for upgrade are listed in the Available Updates section:

    Version history page

    View a larger version of this image

  2. Click Deploy next to the target version.

  3. On the Config screen of the upgrade wizard, make any necessary changes to the configuration for the application. Click Next.

    Config screen in the upgrade wizard

    View a larger version of this image

    :::note Any changes made on the Config screen of the upgrade wizard are not set until the new version is deployed. :::

  4. On the Preflight screen, view the results of the preflight checks.

    Preflight screen in the upgrade wizard

    View a larger version of this image

  5. On the Confirm screen, click Deploy.

    Confirmation screen in the upgrade wizard

    View a larger version of this image

    During updates, the Admin Console is unavailable. A modal is displayed with a message that the update is in progress.

    :::note KOTS can experience downtime during an update, such as in single-node installations. If downtime occurs, refreshing the page results in a connection error. Users can refresh the page again after the update is complete to access the Admin Console. :::

Update in Air Gap Clusters

Upload the New Version From the Command Line

To update by uploading the air gap bundle for the new version from the command line:

Upload the New Version From the Admin Console

To update by uploading the air gap bundle for the new version from the Admin Console: