0Pricing
Helm Academy · Leçon

Insérer des fragments avec template et include

Pourquoi include se compose avec les pipelines contrairement à template.

Insérer des fragments avec template et include est une leçon Helm Academy gratuite sur CoddyKit. Ceci est la leçon 2 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.

Appeler un modèle partiel

Un modèle partiel défini ne fait rien tant que vous ne l’appelez pas. Helm fournit deux actions pour cela : template et include.

L’action template

L’action template rend un modèle partiel nommé directement à l’endroit de l’appel. Vous lui transmettez le nom du modèle partiel et un objet de contexte qu’il pourra lire.

{{ template "mychart.labels" . }}

Pourquoi template est limité

L’action template est une instruction, et non une expression. Sa sortie est directement envoyée au document et ne peut pas être transmise par canalisation à d’autres fonctions.

Voici include

Helm ajoute la fonction include pour combler cette lacune. Elle rend les mêmes modèles partiels, mais renvoie le résultat sous forme de chaîne que vous pouvez transformer.

{{ include "mychart.labels" . }}

include se compose avec les chaînes de traitement

Comme include renvoie une valeur, vous pouvez la transmettre à des fonctions comme indent ou nindent. C’est pourquoi les paquets utilisent presque toujours include de préférence.

{{ include "mychart.labels" . | indent 4 }}

L’indentation est la véritable raison

Le YAML inséré doit se trouver au bon niveau d’indentation. Seul include peut être transmis à nindent par canalisation, ce qui produit à chaque fois une sortie correctement imbriquée.

metadata:
  labels:
    {{- include "mychart.labels" . | nindent 4 }}

L’argument de contexte

Le point placé après le nom du modèle partiel correspond au contexte que vous lui transmettez. En passant le point racine, vous permettez au modèle partiel de lire .Values et .Release.

{{ include "mychart.fullname" . }}

Un outil qui construit un nom

Ici, un modèle partiel renvoie un nom, et un objet Deployment utilise include pour l’insérer dans les métadonnées. Une seule source de vérité, de nombreux appelants.

metadata:
  name: {{ include "mychart.fullname" . }}

template a toujours son utilité

Vous voyez encore template utilisé, souvent pour des modèles partiels qui produisent un bloc complet sur leur propre ligne, lorsqu’aucune canalisation n’est nécessaire.

{{ template "mychart.notes" . }}

Règle générale

Si la sortie doit être indentée ou subir un post-traitement, utilisez include. N’utilisez l’action de modèle simple que lorsque ce n’est réellement pas nécessaire.

Effectuer le rendu pour confirmer

Exécutez helm template . et vérifiez que le modèle partiel est développé avec l’indentation attendue. Un YAML mal aligné est l’erreur classique ici.

helm template my-release .

Vérification rapide

Vous devez effectuer le rendu d’un modèle partiel et l’indenter sous une clé d’étiquettes. Quelle action convient ?

Récapitulatif : template ou include

Les deux appellent des modèles partiels, mais include renvoie une chaîne utilisable dans une chaîne de traitement, tandis que template effectue uniquement une émission en place. Préférez include avec nindent pour obtenir un YAML propre. ✨

Questions Fréquemment Posées

La leçon « Insérer des fragments avec template et include » est-elle gratuite ?

Oui — le texte complet de « Insérer des fragments avec template et include » 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 « Insérer des fragments avec template et include » ?

Pourquoi include se compose avec les pipelines contrairement à template. 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 2 sur 4.

Combien de temps prend la leçon « Insérer des fragments avec template et include » ?

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

  1. Définir un fragment avec define
  2. Insérer des fragments avec template et include
  3. Assistants standard Fullname et Labels
  4. Transmettre une portée à un modèle nommé
← Retour à Helm Academy