Delimitar un bloque con with

Escribir .Values.image.repository una y otra vez resulta engorroso. La acción with reduce el punto a un subárbol para que pueda escribir rutas más cortas.

Un bloque with comienza con {{ with SOMETHING }} y termina con {{ end }}. Dentro de él, el dot se restablece a lo que haya pasado.

Una vez dentro, .repository significa .Values.image.repository. La palabra clave with reasigna el punto al subárbol y acorta todas las rutas que dependen de él.

Si el valor está empty o no existe, with omite todo su bloque. Por tanto, limita el ámbito del punto y actúa al mismo tiempo como un if. 🛡️

Al igual que if, with acepta una rama else. else se renderiza cuando el valor está vacío, lo que le proporciona una alternativa ordenada para la configuración opcional.

Esta es la trampa: dentro de with, el punto ya no representa la raíz. Por eso .Release.Name falla, porque Release no se encuentra dentro de ese subárbol.

Para usar valores de la raíz dentro de with, añádales el prefijo $. El signo de dólar siempre apunta al contexto raíz original, sin importar a qué profundidad se encuentre.

Como with cambia el significado del punto, los bloques grandes se vuelven confusos rápidamente. Mantenga cortas las secciones with para que resulte evidente a qué apunta el punto.

Use if cuando solo quiera comprobar una condición, y use with cuando también quiera entrar en ese valor. with cambia el punto; if lo mantiene sin cambios.

¿No está seguro de qué contiene el punto? Renderice con helm template y lea la salida, o imprima el ámbito mientras depura un bloque with complicado.

Puede anidar un with dentro de otro para profundizar. Cada nivel desplaza el punto un paso más hacia abajo, así que debe controlar en todo momento dónde se encuentra.

Dentro de un bloque {{ with .Values.image }}, intenta leer .Release.Name y está vacío.

Ahora puede cambiar el ámbito del punto con with, obtener una comprobación automática de valor vacío, añadir una alternativa con else y volver a la raíz con $. ¡Plantillas más limpias! 🎯