Bloques condicionales con if y else

A veces un recurso solo debe aparecer si el usuario lo solicita. Helm permite envolver ese YAML en una conditional para renderizarlo bajo demanda.

Un bloque if comienza con {{ if SOMETHING }} y termina con {{ end }}. Todo lo que queda entre ambos se renderiza únicamente cuando la condición es verdadera.

La condición normalmente depende de un valor establecido por el usuario. Cambie ingress.enabled a true en values.yaml y el manifiesto envuelto aparecerá de repente.

Todo if debe tener su correspondiente {{ end }}. Si lo olvida, Helm lanza un error de bloque sin terminar al intentar renderizar el chart.

¿Quiere una alternativa? Añada una rama {{ else }}. Helm renderiza el primer bloque cuando la condición es verdadera; en caso contrario, renderiza la rama else.

Para varios casos, encadene las condiciones con {{ else if }}. Helm comprueba cada una en orden y renderiza la primera rama cuya condición sea verdadera.

Un if es verdadero salvo que el valor esté empty: false, cero, una cadena vacía o una lista vacía se consideran false en una condición.

Un patrón habitual consiste en envolver un único campo opcional, no todo un recurso. En este caso, la anotación solo se renderiza cuando el usuario proporciona un valor para ella.

Un bloque if deja líneas en blanco donde antes estaba la acción. Ese espacio en blanco puede romper el YAML, por lo que pronto aprenderá a eliminarlo. 🧹

Renderice con distintos valores y observe qué rama prevalece. helm template junto con --set le permite confirmar cada condición antes de realizar cualquier despliegue.

Si un usuario nunca establece la bandera, se considera vacía y el if permanece en false. Por eso los charts incluyen un default adecuado para ella en values.yaml.

Escribe {{ if .Values.cache }} pero el chart no se puede renderizar.

Ahora puede controlar el YAML con if, añadir ramas else y else if, y recordar el cierre {{ end }}. ¡El renderizado condicional está a su alcance! 🎯