Skip to main content

Manage

This topic describe how to manage the application using the admin console or the kots CLI. See Update an Application in the Admin Console or Update an Application with the kots CLI below.

Update an Application in the Admin Console​

You can manually update an application in the Version History tab of the admin console. This method works for both online and air gapped installations.

For applications installed in an online environment, you can also configure the admin console to automatically check for and deploy new versions of an application on a custom cadence. For more information, see Configure Automatic Updates below.

To manually update an application:

  1. In the admin console, go to the Version History tab.

  2. Do one of the following, depending on if you are in an online or air gap environment:

    1. (Online) Click Check for updates to manually check for new versions of the application.
    2. (Air gap) Click Upload a new version to upload a new version of the application. When the admin console downloads an update (for online), or when you upload an update (for air gap), a new upstream version displays in the list of available versions.

  3. (Optional) When there are multiple versions of an application, you can compare the changes between them by clicking Diff releases in the right corner. You can review changes between any two arbitrary releases by clicking the icon in the header of the release column. Select the two versions to compare, and click Diff releases to show the relative changes between the two releases.

  4. Click the View preflight checks logo to view or re-run the preflight checks.

  5. To update the application, return to the Version History tab and click Deploy next to the target version. When you update an application, the current cluster is updated to the new version of the application and the Deployed status is set on that version.

Update an Application with the kots CLI​

The kots CLI can be used to install and deploy updates for both online and air gapped instances as well.

Online update​

In order to download updates from the internet, the following command can be used:

kubectl kots upstream upgrade icedq -n <namespace>

Adding the --deploy flag will also automatically deploy the latest version.

Air Gapped update​

In order to install an update from an air gap file, the following command can be used:

kubectl kots upstream upgrade icedq \
  --airgap-bundle icedq-release.airgap \
  --namespace <namespace> \
  --kotsadm-registry <registry host> \
  --registry-username <username> \
  --registry-password <password> \

Adding the --deploy flag will also automatically deploy this version.

Configure Automatic Updates​

For applications installed in an online environment, the admin console automatically checks for new versions once every 4 hours by default. After the admin console checks for updates, it downloads any new versions of the application and displays them on the Version History tab.

You can edit this default cadence to customize how often the admin console checks for and downloads new versions.

You can also configure the admin console to automatically deploy new versions of the application after it downloads them. The admin console only deploys new versions automatically if preflight checks pass. By default, the admin console does not automatically deploy any version of an application.

You cannot configure automatic updates for applications installed in air gapped environments.

To configure automatic updates:

  1. In the admin console, go to the Version History tab and click Configure automatic updates.
    • The Configure automatic updates dialog opens.
  2. Under Automatically check for updates, use the default or select a cadence (Hourly, Daily, Weekly, Never, Custom) from the dropdown list. 3. To turn off automatic updates, select Never. 4. To define a custom cadence, select Custom, then enter a cron expression in the text field.
  3. Under Automatically deploy new versions, select Enable automatic deployment. When this checkbox is enabled, the admin console automatically deploys each new version of the application that it downloads.
Last updated on