fix(operations): replace the component removal recipe that undoes itself

[Aleksei Sviridkin (lexfrei)]

kubectl delete hr -n <namespace> <component> is documented as the way to remove an installed component. It removes nothing. The Package that produced the release owns the HelmRelease (package_reconciler.go:290) and the operator watches them with Owns(&helmv2.HelmRelease{}), so the delete fires the reconcile that puts it back. The command reports success, nothing logs an error, and the component keeps running.

Deleting the Package is what cascades into the uninstall. The disabledPackages entry has to land first, or the next platform upgrade renders the Package again and the removal undoes itself one level up. That ordering is stated rather than checked, because no command discriminates it. A condition wait on the platform HelmRelease returns instantly against the Ready left standing by the previous reconcile, which hack/e2e-install-cozystack.bats refuses for that same reason; re-reading the Package after deleting it returns NotFound unconditionally, since only the platform chart renders Packages and nothing sets driftDetection. I tried both and dropped both. A check that cannot fail is worse than prose, so the page says what the order buys and admits the failure is silent.

Making removal stick arms a data loss the broken recipe was hiding, so the page now states it. packages/system/metallb/charts/metallb/charts/crds/templates/crds.yaml renders its CRDs as ordinary subchart templates with no resource-policy annotation and that chart has no top-level crds/ directory, so helm uninstall deletes them and the apiserver cascades every IPAddressPool, L2Advertisement and BGPPeer along with them. The annotation is the whole condition rather than template placement: cert-manager-crds sets crds.keep and its CRDs survive the same uninstall, which a helm-unittest suite in that package already pins. The page names no CRD count, since metallb ships eight through v1.4 and nine from v1.5.

v1.0 is left out on purpose. That line never got the helm.sh/resource-policy: keep annotation, so disabledPackages alone still prunes the Package there and the page needs the opposite correction. v0 predates Package objects.

v1.1 also had bare metallb / hetzner-robotlb in its disabledPackages example, which match nothing against the fully-qualified names the chart feeds the helper. The recipe sends readers to that list now, so the example has to work.

One known gap: keep reached v1.1 and v1.2 mid-line, in v1.1.5 and v1.2.1, so on earlier patches of those two minors disabledPackages prunes the Package on its own. Same end state, and the docs are scoped per minor, so those pages describe their line at its final patch.

hugo --gc --minify builds clean. hack/check-i18n.sh exits 1 on four stale translations under content/{de,hi,ru,zh-cn}/_index.md, already on main and untouched here, so i18n-lint goes red for something this PR did not cause.

Not taken: cozypkg del resolves dependents and deletes in reverse topological order, which raw kubectl delete does not, but whether that subcommand exists varies across the seven version trees and I did not want a second version-dependent fact in one paragraph.

[netlify]

✅ Deploy Preview for cozystack ready!

Name	Link
🔨 Latest commit	f2f6925
🔍 Latest deploy log	https://app.netlify.com/projects/cozystack/deploys/6a9e02f9513c3e0008ac321c
😎 Deploy Preview	https://deploy-preview-684--cozystack.netlify.app
📱 Preview on mobile	Toggle 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]

Important

• 🔍 Trigger review

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

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Team

Run ID: dc4083c8-1f0e-4319-8635-5f5ca929d80c

---

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

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}