nindent frente a indent en la práctica

YAML utiliza espacios para mostrar la estructura, por lo que un bloque insertado a una profundidad incorrecta rompe el archivo. Helm le proporciona funciones auxiliares para indentar correctamente la salida.

La función indent añade un número fijo de espacios al principio de cada línea de una cadena y desplaza todo el bloque hacia la derecha.

Esta es la particularidad: indent desplaza todas las líneas, pero no añade un salto de línea inicial. La primera línea queda justo donde está la acción.

La función nindent aplica el mismo espaciado, pero primero imprime un salto de línea, de modo que el bloque comienza limpiamente en una línea nueva.

Ese salto de línea inicial de nindent evita que tenga que dejar un espacio final y adivinar la alineación después de una clave situada en la misma línea.

Utilizará nindent sobre todo al colocar un bloque de toYaml bajo una clave, ya que sitúa el mapa renderizado ordenadamente debajo de ella.

Elija el número contando los espacios desde la clave principal, no desde la columna cero. Un elemento secundario situado dos niveles más abajo suele necesitar nindent 4.

El indent normal es adecuado cuando el bloque ya comienza en su propia línea, de modo que no quiere insertar otro salto de línea delante.

La mayoría de los niveles de YAML avanzan de dos en dos espacios. Equivocarse por dos en el valor de nindent es la causa principal de que un chart no se pueda analizar.

No adivine la profundidad. Ejecute helm template y lea la salida sin procesar para confirmar que las líneas del bloque insertado quedan alineadas bajo su clave principal.

Ambas funciones toman la cadena del pipe situado a su izquierda, por lo que se combinan naturalmente con toYaml para dar formato a un mapa completo dentro de su manifiesto.

Ahora sabe que indent añade espacios a un bloque, que nindent añade primero un salto de línea y que renderizar es la forma más segura de confirmar la profundidad. 🧹