Using Admin Console
The simplest way to update a KOTS application is through the “Version History” tab on the Admin Console.
This method works for both online and airgapped installs.
Checking for Updates
The Admin Console automatically checks for updates once every 4 hours.
To manually check for a more recent version, click the “Check for updates” button at the top of the admin console.
In airgapped instances this button will be replaced with an
Upload a new version button.
Airgapped instances cannot check for updates automatically.
When an update has been downloaded (for online) or uploaded (for airgap), a new upstream version will show in the list of released versions.
Comparing Changes Between Releases
When there are a multiple versions of KOTS application, you can compare the changes between them by clicking the “Diff versions” in the right corner.
Changes can be reviewed between any arbitrary release 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.
Click the “Preflight results” link to run the preflight checks defined by the application vendor.
Based on the outcome of each preflight check, you can decide whether or not to perform the upgrade by clicking the “Continue” button.
Preflight failures and warnings do not preclude the upgrade to a new version.
The installer may elect to ignore these failures and proceed with the upgrade.
An update is performed by clicking “Continue” on the preflight checks page, or by clicking the “Deploy” button on the “Version History” tab.
At this point, the current cluster will be updated to the new version of the KOTS application and the “Deployed” status will be set on that version.
KOTS CLI can be used to install and deploy updates for both online and airgapped instances as well.
In order to download updates from the internet, the following command can be used:
kubectl kots upstream upgrade <app slug> -n <admin console namespace>
--deploy flag will also automatically deploy the latest version.
In order to install an update from an airgap file, the following command can be used:
kubectl kots upstream upgrade <app slug> \
--airgap-bundle new-app-release.airgap \
--kotsadm-namespace <registry namespace> \
--kotsadm-registry <registry host> \
--registry-username <username> \
--registry-password <password> \
-n <admin console namespace>
--deploy flag will also automatically deploy this version.