Verzeichnis-Layout
Chart.yaml (Metadaten, Pflicht) ·
values.yaml (Defaults) ·
values.schema.json (optionales JSON-Schema) ·
templates/ (Manifeste + _helpers.tpl)
· charts/ (gevendorte Dependencies) ·
crds/ (CRDs, siehe Anti-Patterns).
charts/, crds/,
templates/ sind für Helm reserviert.
Chart.yaml-Kernfelder
apiVersion: v2, Standard für Helm 3
und 4 (v1 = Helm 2; Charts v3
experimentell, helm create erzeugt sie nur mit
HELM_EXPERIMENTAL_CHART_V3=1 und
--chart-api-version=v3).
version: SemVer des Charts, treibt Paketname, Registry-Tag und Range-Auflösung.
appVersion: Version der paketierten App, informativ.
type: application oder
library (Library-Charts rendern selbst nichts,
liefern Template-Bausteine).
apiVersion: v2
name: shop-api
version: 1.4.0 # Chart-SemVer
appVersion: "2.8.1" # App-Version, informativ
type: application
dependencies:
- name: postgresql
version: ">=16.0.0 <17.0.0"
repository: oci://registry.example.com/charts
condition: postgresql.enabled