실전에서 nindent와 indent 비교하기

YAML은 공백으로 구조를 나타내므로, 잘못된 깊이에 삽입된 블록은 파일을 망가뜨립니다. 헬름은 출력을 올바르게 indent할 수 있는 도우미를 제공합니다.

indent 함수는 문자열의 모든 줄 시작 부분에 고정된 수의 공백을 추가하여 전체 블록을 오른쪽으로 이동시킵니다.

여기서 주의할 점은 indent가 모든 줄을 이동하지만 앞에 새 줄을 추가하지 않는다는 것입니다. 첫 번째 줄은 해당 동작이 놓인 바로 그 위치에 배치됩니다.

nindent 함수는 같은 방식으로 공백을 넣지만 먼저 새 줄을 출력하므로 블록이 깔끔하게 새 줄에서 시작됩니다.

nindent가 앞에 새 줄을 추가하므로 같은 줄의 키 뒤에 공백을 남겨 두고 정렬을 추측할 필요가 없습니다.

키 아래에 toYaml 블록을 배치할 때는 대부분 nindent를 사용하게 됩니다. 렌더링된 맵을 키 바로 아래에 깔끔하게 배치해 주기 때문입니다.

열 0부터 세지 말고 부모 키에서부터 공백 수를 세어 정하세요. 두 단계 아래에 있는 자식은 보통 nindent 4가 필요합니다.

블록이 이미 자체 줄에서 시작하는 경우에는 일반 indent가 적합합니다. 블록 앞에 불필요한 새 줄을 추가하고 싶지 않을 때 사용하세요.

대부분의 YAML 중첩 단계는 두 칸의 공백으로 구분됩니다. nindent 수를 두 칸 잘못 지정하는 것이 파싱에 실패하는 차트의 가장 흔한 원인입니다.

깊이를 절대 추측하지 마세요. helm template을 실행하고 원시 출력을 읽어 삽입된 블록의 줄이 부모 키 아래에 맞게 정렬되었는지 확인하세요.

두 도우미 함수 모두 왼쪽의 파이프에서 문자열을 읽으므로, toYaml과 자연스럽게 함께 사용하여 전체 맵을 매니페스트 형식으로 만들 수 있습니다.

키 뒤 같은 줄에 {{ toYaml .Values.env | indent 4 }}를 작성하면 YAML 형식이 잘못됩니다.

이제 indent는 블록에 공백을 넣고, nindent는 먼저 새 줄을 추가하며, 렌더링이 깊이를 확인하는 가장 확실한 방법이라는 것을 알게 되었습니다. 🧹