Skip to content

Document ownership annotations (fixes helm/helm#12869)#2040

Open
kovan wants to merge 1 commit intohelm:mainfrom
kovan:doc-ownership-annotations
Open

Document ownership annotations (fixes helm/helm#12869)#2040
kovan wants to merge 1 commit intohelm:mainfrom
kovan:doc-ownership-annotations

Conversation

@kovan
Copy link
Copy Markdown

@kovan kovan commented Mar 13, 2026

Summary

  • Adds a new "Helm Ownership Labels and Annotations" section to the Labels and Annotations best practices page
  • Documents the meta.helm.sh/release-name and meta.helm.sh/release-namespace annotations that Helm automatically sets on all managed resources
  • Explains how ownership checking works and the --take-ownership flag for adopting pre-existing resources
  • All content verified against pkg/action/validate.go in helm/helm

Fixes helm/helm#12869

…namespace

Add a new "Helm Ownership Labels and Annotations" section to the labels
best practices page documenting how Helm uses meta.helm.sh/release-name,
meta.helm.sh/release-namespace, and app.kubernetes.io/managed-by to form
the ownership record for resources.

Also documents the --take-ownership flag for adopting pre-existing
resources into a Helm release.

Applied to both docs/ (next) and versioned_docs/version-3/ (current GA).

Fixes helm/helm#12869

Signed-off-by: kovan <xaum.io@gmail.com>
@kovan kovan force-pushed the doc-ownership-annotations branch from 48de75d to 48ba515 Compare March 14, 2026 12:33
Copy link
Copy Markdown
Contributor

@TerryHowe TerryHowe left a comment

Choose a reason for hiding this comment

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

/lgtm

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Missing docs on ownership annotations

2 participants