Skip to content

docs(upgrade): carry the Kubernetes app's breaking changes to the v1.7 upgrade page - #803

Open
myasnikovdaniil wants to merge 1 commit into
mainfrom
docs/kubernetes-upgrade-notes
Open

myasnikovdaniil wants to merge 1 commit into
mainfrom
docs/kubernetes-upgrade-notes

Conversation

@myasnikovdaniil

Copy link
Copy Markdown
Contributor

The Kubernetes app README is dropping its Breaking Changes section. The v1.7 upgrade page is where someone coming from v1.6 reads what changes for tenant clusters, so I moved over the parts that apply to that upgrade and that the page didn't have yet. Both the next/ page and the released v1.7/ copy get the same text.

What's added under "Tenant Kubernetes clusters":

  • What migration 56 copies into each adopted pool (the cluster's version and talos values, the health-check settings, maxNodeProvisionTime), and the maxUnhealthy: "50%" default a new pool gets.
  • WorkloadsReady on a Kubernetes resource now covers only the control plane, so waiting on the cluster no longer waits for its workers.
  • Delete a cluster's KubernetesNodes pools before the Kubernetes resource.
  • A new "Worker images and registry mirrors" subsection: each pool sets its own talos.imageFactoryURL, talos.installerRepository, talos.registryMirrors and osImage, and a pool's osImage.factory.imageFactoryURL wins over its talos.imageFactoryURL. The Kubernetes resource ignores those talos keys. The platform registries value never reached Talos workers, and v1.7.1 removes it along with the patch-containerd Secret.
  • Under Kamaji: admissionControllers only takes the plugin names the KamajiControlPlane CRD lists. extraArgs entries now reach the apiserver as written, so spelling kube feature gates both bare and kube:-prefixed, or giving two kube --emulated-version entries, stops it from starting. The "Before you upgrade" checklist mentions this too.

Not carried over: the ephemeralStorage → diskSize rename (v1.4), and the migration 46 spec.version bump and LINSTOR StorageClass propagation. Both of those shipped in v1.6.0, so a cluster on v1.6 is already past them.

I checked that the site builds with hugo in both the production and development environments and that the new anchor and in-page link resolve.

The Kubernetes app README is losing its Breaking Changes section, and
the v1.7 upgrade page is where an operator coming from v1.6 reads what
the upgrade changes for tenant clusters. Most of that section is
already there; this adds what is not.

Worker pools: what migration 56 carries into each adopted pool (the
cluster's talos values, the effective health-check settings,
maxNodeProvisionTime), the 50% remediation default a new pool takes,
that WorkloadsReady on the Kubernetes resource now covers the control
plane only, and that pools are deleted before the cluster.

A new subsection says where a pool's Talos image, installer and
registry mirrors are set, that the Kubernetes resource does not read
those talos keys, and that the platform registries value never reached
Talos workers and goes away with its patch-containerd Secret in
v1.7.1.

Kamaji: the admission plugin enum, and repeated feature-gate spellings
or kube emulated versions now reaching the apiserver and stopping it.

The entries from v1.4 (ephemeralStorage rename) and v1.6 (migration
46, LINSTOR StorageClass propagation) are not carried over: a cluster
on v1.6 is already past them.

The page exists in next/ and in the released v1.7/ copy; both get the
same text.

Assisted-by: LLM
Signed-off-by: Myasnikov Daniil <myasnikovdaniil2001@gmail.com>
@netlify

netlify Bot commented Nov 12, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for cozystack ready!

Name Link
🔨 Latest commit 6d9e382
🔍 Latest deploy log https://app.netlify.com/projects/cozystack/deploys/6af5c35e80687b9e709585cd
😎 Deploy Preview https://deploy-preview-803--cozystack.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.

@coderabbitai

coderabbitai Bot commented Nov 12, 2026

Copy link
Copy Markdown
Contributor

Important

  • Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

Run configuration

  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: defaults
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: a9a8b094-a927-4a77-b599-c1ef54b44ed8
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant