Repository navigation
Stop recommending to put CRDs under templates - #1616
Open
matheuscscp wants to merge 1 commit into
Open
matheuscscp wants to merge 1 commit into
matheuscscp wants to merge 1 commit into
Conversation
matheuscscp
added
area/docs
matheuscscp
added a commit
to matheuscscp/helm-www
that referenced
this pull request
Oct 16, 2026
HIP-0011 mentions that templating support for CRDs in *Helm 3* is kept only for backward compatibility with Helm 2: https://helm.sh/community/hips/hip-0011/#installing-crds > NOTE: There is no requirement that CRDs can only be placed in the `crds/` directory. They can be put along side other resources in the `templates/` directory. This was an intentional design choice to preserve backward compatibility. Helm 4 should have removed that support, since it was no longer required to keep compatibility with Helm 2. I'm gonna file a HIP for removing support in Helm 5. Problems caused by the recommendation being removed in this PR: * fluxcd/helm-controller#1601 * controlplaneio-fluxcd/terraform-kubernetes-flux-operator-bootstrap#102 And many more in Flux that I don't have the time to find. We are also removing this recommendation from the Flux HelmRelease docs: fluxcd/helm-controller#1616 Signed-off-by: Matheus Pimenta <matheuscscp@gmail.com>
This was referenced Oct 16, 2026
TerryHowe
added a commit
to helm/helm-www
that referenced
this pull request
Oct 17, 2026
HIP-0011 mentions that templating support for CRDs in *Helm 3* is kept only for backward compatibility with Helm 2: https://helm.sh/community/hips/hip-0011/#installing-crds > NOTE: There is no requirement that CRDs can only be placed in the `crds/` directory. They can be put along side other resources in the `templates/` directory. This was an intentional design choice to preserve backward compatibility. Helm 4 should have removed that support, since it was no longer required to keep compatibility with Helm 2. I'm gonna file a HIP for removing support in Helm 5. Problems caused by the recommendation being removed in this PR: * fluxcd/helm-controller#1601 * controlplaneio-fluxcd/terraform-kubernetes-flux-operator-bootstrap#102 And many more in Flux that I don't have the time to find. We are also removing this recommendation from the Flux HelmRelease docs: fluxcd/helm-controller#1616 Signed-off-by: Matheus Pimenta <matheuscscp@gmail.com> Co-authored-by: Terry Howe <terrylhowe@gmail.com>
matheuscscp
removed
the
backport:release/v1.6.x
Signed-off-by: Matheus Pimenta <matheuscscp@gmail.com>
matheuscscp
force-pushed
the
stop-templating-crds
branch
from
October 18, 2026 12:06
ced0d17 to
ebe2538
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Issues coming from putting CRDs under templates:
I'm gonna file docs improvements in Helm upstream too to fix this, both of us should stop recommending this workaround, because ecosystem components are doing it, and they shouldn't ship their charts based on cheap workarounds. Edit:
templates/directory helm/community#449