This part of the Best Practices Guide explains general conventions.
Chart names should be lower case letters and numbers. Words may be separated with dashes (-):
drupal nginx-lego aws-cluster-autoscaler
Neither uppercase letters nor underscores should be used in chart names. Dots should not be used in chart names.
The directory that contains a chart MUST have the same name as the chart. Thus,
nginx-lego MUST be created in a directory called
is not merely a stylistic detail, but a requirement of the Helm Chart format.
Wherever possible, Helm uses SemVer 2 to represent version numbers. (Note that Docker image tags do not necessarily follow SemVer, and are thus considered an unfortunate exception to the rule.)
When SemVer versions are stored in Kubernetes labels, we conventionally alter
+ character to an
_ character, as labels do not allow the
+ sign as a
YAML files should be indented using two spaces (and never tabs).
Usage of the Words Helm and Chart
There are a few conventions for using the words Helm and helm.
- Helm refers to the project as a whole
helmrefers to the client-side command
- The term
chartdoes not need to be capitalized, as it is not a proper noun
Chart.yamldoes need to be capitalized because the file name is case sensitive
When in doubt, use Helm (with an uppercase ‘H’).