Объекты Chart и Capabilities

Помимо .Values и .Release, Helm предоставляет .Chart для метаданных чарта и .Capabilities для сведений о целевом кластере.

.Chart — это содержимое Chart.yaml, доступное шаблонам. Во время рендеринга можно прочитать каждое указанное там поле. 📦

.Chart.Name и .Chart.Version задают идентичность чарта. Version — это собственная версия чарта в формате SemVer, которую увеличивают при каждой публикации.

.Chart.AppVersion — версия разворачиваемого приложения, а не чарта. Часто она используется для задания тега образа и меток по умолчанию.

В Chart.yaml используются ключи в нижнем регистре, но объект делает их прописными. Вы пишете .Chart.AppVersion, хотя в файле указано appVersion.

.Capabilities описывает кластер, с которым взаимодействует Helm: его версию Kubernetes и доступные группы API.

.Capabilities.KubeVersion сообщает версию кластера. Чарты используют её, чтобы адаптировать манифесты к более новым или старым версиям Kubernetes.

.Capabilities.APIVersions.Has проверяет наличие API в кластере, позволяя безопасно выбрать нужный тип ресурса.

Кластеры различаются версиями и установленными API. Проверка через .Capabilities позволяет одному чарту корректно работать в разных конфигурациях кластеров.

В автономном режиме helm template не может обратиться к реальному кластеру, поэтому использует версию по умолчанию. Передайте --kube-version, чтобы смоделировать конкретную целевую версию.

Полезное правило: обращайтесь к .Chart, когда добавляете идентификационные данные в метки, и проверяйте .Capabilities, когда решаете, какую структуру манифеста вывести.

Вам нужно пометить ресурсы версией разворачиваемого приложения.

Вы узнали, что .Chart предоставляет метаданные Chart.yaml, такие как Name, Version и AppVersion, а .Capabilities сообщает версию кластера и доступные API.