Helm Academy · Leçon

L’objet Values et l’accès imbriqué

Lisez la configuration utilisateur profondément dans l’arborescence.

L’objet Values et l’accès imbriqué est une leçon Helm Academy gratuite sur CoddyKit. Ceci est la leçon 1 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Helm Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Helm Academy comprend 4 leçons au total.

Découvrez l'objet Values

Dans un modèle, .Values contient tous les paramètres de votre paquet issus de values.yaml, ainsi que les remplacements que vous avez fournis. C'est votre arborescence de configuration.

Lire une clé de premier niveau

Une clé de premier niveau comme replicaCount devient .Values.replicaCount. Le chemin en points reflète exactement la structure YAML. 🌳

# values.yaml
replicaCount: 3

# template
replicas: {{ .Values.replicaCount }}

Explorer les tables imbriquées

Lorsque les valeurs sont imbriquées, vous enchaînez les points. La table correspondant à l'image et contenant une clé d'étiquette est accessible avec .Values.image.tag, à raison d'un segment par niveau.

# values.yaml
image:
  repository: nginx
  tag: "1.27"

# template
image: {{ .Values.image.repository }}:{{ .Values.image.tag }}

Les clés respectent la casse

Les segments du chemin doivent correspondre aux caractères de la clé YAML, sans aucune différence. .Values.Image n'est pas identique à .Values.image et produit un rendu vide.

Les clés manquantes produisent du vide

Demander une valeur inexistante ne constitue pas une erreur par défaut. Helm ne produit rien, ce qui peut générer silencieusement un YAML invalide.

Les clés contenant des tirets nécessitent index

La syntaxe en points ne fonctionne pas avec les clés contenant des tirets. Accédez-y avec la fonction index et la clé sous forme de chaîne entre guillemets.

# values.yaml
service-port: 8080

# template
port: {{ index .Values "service-port" }}

D'où viennent les valeurs par défaut

L'auteur du paquet fournit des valeurs par défaut raisonnables dans values.yaml. Chaque clé qui s'y trouve est disponible sous .Values, sauf si un utilisateur la remplace.

Comment les remplacements atteignent .Values

L'option --set ou le fichier indiqué par -f est fusionné avec les valeurs par défaut avant le rendu. Au moment du modèle, .Values est l'arborescence finale fusionnée.

helm install web ./mychart --set replicaCount=5

Les listes résident aussi sous .Values

Une liste YAML devient un tableau sous .Values. Vous parcourez ce tableau avec range pour produire des éléments répétés, au lieu de le lire avec un unique chemin en points. 🔁

# values.yaml
ports:
  - 80
  - 443

Mettre les valeurs entre guillemets en toute sécurité

Les nombres et les booléens sont rendus tels quels, ce qui peut corrompre YAML. Entourez les chaînes fournies par l'utilisateur avec la fonction quote afin qu'elles restent du texte valide.

tag: {{ .Values.image.tag | quote }}

Inspectez l'arborescence avant de l'utiliser

Exécutez helm show values sur un paquet pour afficher toute son arborescence de valeurs. Cette sortie correspond exactement à la structure que vous adressez avec .Values.

helm show values ./mychart

Vérification rapide

Vous avez besoin d'une clé de valeurs nommée service-port, qui contient un tiret.

Récapitulatif : l'arborescence Values

Vous avez appris que .Values est l'arborescence de configuration fusionnée, accessible avec des chemins en points et sensible à la casse, et qu'il faut utiliser index pour les clés particulières. Inspectez-la avec helm show values.

Questions Fréquemment Posées

La leçon « L’objet Values et l’accès imbriqué » est-elle gratuite ?

Oui — le texte complet de « L’objet Values et l’accès imbriqué » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Helm Academy, passe à CoddyKit PRO. Le cours Helm Academy comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « L’objet Values et l’accès imbriqué » ?

Lisez la configuration utilisateur profondément dans l’arborescence. Tu pratiques Helm Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer Helm Academy ?

Aucune expérience préalable n'est requise. Helm Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 1 sur 4.

Combien de temps prend la leçon « L’objet Values et l’accès imbriqué » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon Helm Academy ?

Oui. Chaque leçon Helm Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

← Retour à Helm Academy