Helm Chart Chart.yaml: Difference between revisions

From NovaOrdis Knowledge Base
Jump to navigation Jump to search
Line 29: Line 29:
====apiVersion====
====apiVersion====


Required element; the chart API version, always "v1".
Required element; the chart API version. The apiVersion field should be "v2" for charts that require at least Helm 3. Charts supporting previous Helm versions have an apiVersion set to v1 and are still installable by Helm 3.


====name====
====name====

Revision as of 18:53, 14 December 2019

External

Internal

Overview

The chart's main metadata file. It is required to be present. Some of the required and optional elements are presented below, unknown elements will be silently ignored.

Example

apiVersion: v1
name: archaeopteryx
version: 0.1.0
appVersion: "1.0"
description: archaeopteryx Helm chart

Elements

All fields below are available in templates as built-in objects, with their first letter capitalized and prefixed by ".Chart."

Example:

{{ .Chart.Name }}

For more details see Helm Templates.

apiVersion

Required element; the chart API version. The apiVersion field should be "v2" for charts that require at least Helm 3. Charts supporting previous Helm versions have an apiVersion set to v1 and are still installable by Helm 3.

name

Required element. Represents the name of the chart.

version

Required element. Represents the SemVer 2 chart version number. Non-SemVer names are explicitly disallowed by the system. For more details, see Chart Versioning.

appVersion

Optional element. Represents the application version: the version of the application packaged in this chart. It does not need to be SemVer 2. For more details, see Chart Versioning.

description

Optional element; the single-sentence description of this project.

keywords

home

sources

maintainers

engine

icon

deprecated

TODO: https://helm.sh/docs/developing_charts/#deprecating-charts.