Comentarios y comillas en plantillas

Un chart ofrece dos formas de dejar notas: comentarios YAML normales y comentarios de plantilla especiales. Se comportan de manera muy diferente durante el renderizado.

Una línea que comienza con una almohadilla es un comentario YAML normal. Pasa directamente a través de la plantilla y permanece en la salida renderizada para que cualquiera pueda leerla.

Helm tiene su propio tipo de comentario, que desaparece por completo. Envuelva el texto en {{/* */}} y el motor lo elimina antes de generar la salida.

Use un signo de almohadilla para documentar el YAML desplegado. Use un comentario de plantilla para las notas sobre la lógica de la plantilla que los usuarios nunca deben ver. 📝

Los comentarios de plantilla resultan útiles para desactivar código. Envuelva una acción en {{/* */}} y Helm la omite: no se renderiza ni produce errores.

YAML suele inferir los tipos. El valor 1.10 puede convertirse en 1.1, y yes puede transformarse en true. Poner comillas fuerza una cadena limpia.

Helm incluye una función quote que envuelve un valor entre comillas dobles por usted, de modo que el campo renderizado sea inequívocamente una cadena.

Normalmente verá quote escrito como una tubería al final de una acción. Se lee de forma natural: tome el valor y después póngale comillas.

Sin comillas, una versión como 1.20 puede perder silenciosamente el cero final y convertirse en 1.2, lo que rompe la referencia de la imagen. Poner comillas lo evita. ⚠️

A veces Kubernetes necesita que un número se conserve como texto, por ejemplo, un puerto en una anotación. Pasarlo por quote lo mantiene como cadena de forma segura.

También puede escribir comillas literales directamente en YAML. La función quote simplemente lo hace de forma programática cuando el valor proviene de una plantilla.

Añade una nota que no debe aparecer en el YAML desplegado.

Ahora puede ocultar notas con {{/* */}}, mantener visibles las que llevan un signo de almohadilla y forzar cadenas limpias mediante la función quote. 🎯