Oggetti Chart e Capabilities

Oltre a .Values e .Release, Helm espone .Chart per i metadati del chart e .Capabilities per i dati relativi al cluster di destinazione.

.Chart contiene i dati di Chart.yaml esposti ai template. Ogni campo scritto nel file può essere letto durante il rendering. 📦

.Chart.Name e .Chart.Version identificano il chart. Version è il SemVer del chart stesso e viene incrementato a ogni pubblicazione.

.Chart.AppVersion è la versione dell'applicazione distribuita, non quella del chart. Spesso determina il tag predefinito dell'immagine e le label.

Chart.yaml utilizza chiavi in minuscolo, ma l'oggetto le rende maiuscole. Si scrive .Chart.AppVersion anche se nel file compare appVersion.

.Capabilities descrive il cluster con cui Helm interagisce: la versione di Kubernetes e i gruppi API disponibili.

.Capabilities.KubeVersion indica la versione del cluster. I chart la utilizzano per adattare i manifest alle versioni più recenti o meno recenti di Kubernetes.

.Capabilities.APIVersions.Has verifica se un'API esiste nel cluster, permettendo di scegliere in modo sicuro il tipo di risorsa corretto.

I cluster differiscono per versione e API installate. Basare le condizioni su .Capabilities permette a un chart di eseguire correttamente il rendering in molte configurazioni di cluster.

In modalità offline, helm template non può interrogare un cluster reale, quindi presuppone una versione predefinita. Passi --kube-version per simulare una destinazione specifica.

Una regola utile: legga .Chart quando applica l'identità alle label e controlli .Capabilities quando decide quale struttura di manifest generare.

Ha imparato che .Chart espone i metadati di Chart.yaml, come Name, Version e AppVersion, mentre .Capabilities indica la versione del cluster e le API disponibili.