fix(templates)!: deprecate initContainers in favor of extraInitContainers

BREAKING CHANGE: The 'initContainers' parameter is now deprecated in favor
of 'extraInitContainers' for naming consistency with 'extraContainers'.
Both parameters will work until 2030 for backward compatibility.

The previous implementation used '.Values.initContainers' in the template
but 'extraInitContainers' was defined in values.yaml, causing the feature
to be completely non-functional.

Changes:
- Fix extraInitContainers not working (was referencing wrong parameter)
- Add deprecated 'initContainers' parameter to values.yaml with @deprecated tag
- Update deployment.yaml to support both parameters with OR logic
- Add TODO comment to remove initContainers support after 2030
- Create NOTES.txt with:
  - Deprecation warning when using initContainers
  - Post-installation instructions for accessing Jellyfin
  - Persistence status information
  - Links to documentation
- Improve extraInitContainers documentation with usage example
- Bump chart version 2.5.0 -> 3.0.0 (major due to deprecation)
- Add comprehensive changelog to artifacthub.io/changes

Migration guide:
  Old: initContainers: [...]
  New: extraInitContainers: [...]

The old parameter will continue to work but users will see a deprecation
warning in NOTES.txt after installation.

Follows best practices from community charts (Prometheus, Elastic, etc.)
where 'extra*' prefix indicates user-provided extension points.

Co-Authored-By: Claude <noreply@anthropic.com>
Signed-off-by: Aleksei Sviridkin <f@lex.la>
This commit is contained in:
Aleksei SviridkinandClaude committed 2025-11-06 00:51:45 +03:00 Unverified
1 parent 2401a45bb1
commit 90861109aa
4 files changed
+134 -5

No files matched your search

+9 -1
View File
@@ -8,5 +8,13 @@ keywords:
- jellyfin
- media
- self-hosted
version: 2.5.0
version: 3.0.0
appVersion: 10.11.2
annotations:
artifacthub.io/changes: |
- kind: deprecated
description: Deprecate initContainers parameter in favor of extraInitContainers for consistency (will be removed after 2030)
- kind: fixed
description: Fix extraInitContainers not working (was using wrong parameter name in template)
- kind: added
description: Add NOTES.txt with helpful post-installation information and deprecation warnings