Skip to content

Conversation

@paigecalvert
Copy link
Contributor

@paigecalvert paigecalvert commented Sep 2, 2025

@paigecalvert paigecalvert requested a review from a team as a code owner September 2, 2025 23:18
@netlify
Copy link

netlify bot commented Sep 2, 2025

Deploy Preview for replicated-docs ready!

Name Link
🔨 Latest commit 5bd71f2
🔍 Latest deploy log https://app.netlify.com/projects/replicated-docs/deploys/68b8791f995b22000721caa2
😎 Deploy Preview https://deploy-preview-3507--replicated-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@netlify
Copy link

netlify bot commented Sep 2, 2025

Deploy Preview for replicated-docs-upgrade ready!

Name Link
🔨 Latest commit 5bd71f2
🔍 Latest deploy log https://app.netlify.com/projects/replicated-docs-upgrade/deploys/68b8791f622bee00084153d4
😎 Deploy Preview https://deploy-preview-3507--replicated-docs-upgrade.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@replicated-ci replicated-ci added type::docs Improvements or additions to documentation type::feature labels Sep 2, 2025
* After users deploy a required version, they can no longer redeploy (roll back to) versions earlier than the required version, even if `allowRollback` is true in the Application custom resource manifest. For more information, see [`allowRollback`](/reference/custom-resource-application#allowrollback) in the Application custom resource topic.
* If you change the channel an existing customer is assigned to, the Admin Console always fetches the latest release on the new channel, regardless of any required releases on the channel. For more information, see [Channel Assignment](licenses-about#channel-assignment) in _About Customers_.
* Required releases are supported for KOTS installations only and are not supported for releases installed with Helm. The **Prevent this release from being skipped during upgrades** option has no affect if the user installs with Helm.
* Required releases are not supported for Helm CLI installations. The **Prevent this release from being skipped during upgrades** option has no affect when the user installs with Helm.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Was drafting this new limitation to clarify how the requirement status doesn't get updated after an upstream update check in 1.125.2 and earlier:

  • For installations using KOTS 1.125.2 or earlier, if you disable the Prevent this release from being skipped during upgrades option for a promoted release, the release will still be marked as required in the Admin Console.

Wasn't sure if there is some sort of workaround in this case (ie, the status doesn't change in the Admin Console but you can skip the previously required version if you upgrade from the CLI or something), or if you'd just need to upgrade to KOTS 1.126.0.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

you'd have to upgrade to KOTS. once KOTS knows about a version, it never processes it again. so it'll say, oh i know about netbox 1.2.3, and i know it's required, so you have to deploy it. and netbox can change that upstream, but kots will never change. (until now of course.)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Gotcha. I'll add one more sentence to make sure that's clear

@paigecalvert paigecalvert changed the title Required releases update Marking a release as no longer required in KOTS 1.126.0 and later Sep 3, 2025
@paigecalvert paigecalvert requested a review from ajp-io September 3, 2025 15:12
@paigecalvert paigecalvert merged commit 29d2995 into main Sep 3, 2025
5 checks passed
@paigecalvert paigecalvert deleted the required-releases-update branch September 3, 2025 19:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

type::docs Improvements or additions to documentation type::feature

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants