같은 값을 어떻게 적느냐가 타입을 바꾼다

목표

--set 계열 옵션의 문법을 값 덤프로 하나씩 확인하고, 같은 값을 values 파일로 줄 때와 --set 으로 줄 때 결과가 어떻게 달라지는지 JSON 타입까지 비교한다.

왜 중요한가

--set 은 급할 때 쓰는 편의 옵션처럼 보이지만 실제로는 작은 언어다. 점은 깊이를 파고, 쉼표는 값을 나누고, 중괄호는 리스트를 만들고, 대괄호는 원소를 집고, 역슬래시는 그 규칙을 잠시 끈다. 문법을 몰라서 생기는 사고보다 타입을 몰라서 생기는 사고가 더 잦다. --set image.tag=8 은 숫자 8 을 넣고, values 파일의 tag: "8" 은 문자열을 넣는다. 차트가 | quote 를 걸어 두었다면 둘 다 같아 보이지만, 걸지 않은 차트에서는 매니페스트가 조용히 달라진다. 값을 null 로 지우는 것과 빈 문자열로 두는 것도 다르고, 파일 본문을 값으로 넣는 일에는 전용 옵션이 필요하다. 이 실습은 그 차이를 전부 눈에 보이게 만들어 두고 하나씩 확인한다.

단계

1. /root/hc-set/dumper 차트(이름 dumper, 버전 0.1.0)를 만드세요. values.yaml 은 image(repository registry.local/api, tag "1.10"), replicas: 2, nodeSelector: {}, args: [], config: {} 를 담습니다. templates/dump.yaml 은 <릴리스이름>-dump ConfigMap 이고 data 에 dump.json 키 하나만 두는데, 그 값은 .Values 전체를 JSON 으로 바꿔 따옴표로 감싼 것입니다. 렌더한 뒤 그 JSON 만 뽑아 /root/hc-set/out/base.json 에 저장하세요.
2. 기본값을 고치지 말고 --set 만으로 image.repository 를 registry.local/web 로, replicas 를 5 로, args 를 alpha·beta·gamma 세 원소의 리스트로 바꿔 렌더하고 그 JSON 을 /root/hc-set/out/basics.json 에 저장하세요.
3. --set 으로 nodeSelector 에 kubernetes.io/os: linux 를, config 에 feature.flag: beta 를 넣어 렌더하고 JSON 을 /root/hc-set/out/escape.json 에 저장하세요. 두 키 모두 이름 안에 점이 들어 있습니다.
4. 같은 태그를 세 가지로 넣어 렌더하고 각각 저장하세요 — --set image.tag=8 은 /root/hc-set/out/num-set.json, --set-string image.tag=8 은 /root/hc-set/out/num-setstring.json, --set image.tag=1.10 은 /root/hc-set/out/num-float.json 입니다. 세 파일에서 image.tag 의 JSON 타입이 어떻게 갈리는지 확인하세요.
5. --set-json 으로 config 를 {"retries": 3, "mode": "strict"} 로, args 를 ["--a", "--b"] 로 넣어 렌더하고 JSON 을 /root/hc-set/out/setjson.json 에 저장하세요. retries 는 숫자여야 합니다.
6. /root/hc-set/ca.pem 에 인증서 모양의 세 줄짜리 파일을 만드세요(-----BEGIN CERTIFICATE-----, MIIBkTCB+wIJAKt, -----END CERTIFICATE-----). 이 파일의 내용을 config.ca 값으로 넣어 렌더하고 JSON 을 /root/hc-set/out/setfile.json 에 저장하세요. 경로가 아니라 내용이 들어가야 합니다.
7. --set 으로 image.tag 를 지워서(키 자체가 없어져야 합니다) 렌더한 JSON 을 /root/hc-set/out/null.json 에, args 의 0번 원소에 name: first 와 value: 1 을 넣어 렌더한 JSON 을 /root/hc-set/out/index.json 에 저장하세요. value 는 숫자여야 합니다.
8. /root/hc-set/override.yaml 에 image.tag: "8" 과 replicas: 5 를 적고 그 파일로 렌더한 JSON 을 /root/hc-set/out/via-file.json 에 저장하세요. 같은 두 값을 --set image.tag=8 --set replicas=5 로 준 결과를 /root/hc-set/out/via-set.json 에, --set-string image.tag=8 --set replicas=5 로 준 결과를 /root/hc-set/out/via-setstring.json 에 저장합니다. 파일 판과 set 판의 차이를 diff 로 떠서 /root/hc-set/out/compare.txt 에 남기세요(차이가 있으므로 diff 는 0 이 아닌 코드로 끝납니다).

참고

차트가 .Values 를 JSON 으로 덤프하므로 값의 타입까지 눈에 보인다
jq -r '.image.tag | type' 으로 숫자인지 문자열인지 확인한다
--set 옵션은 셸이 먼저 건드리지 않도록 작은따옴표로 감싼다
흔한 실수: 키 안의 점을 탈출하지 않아 중첩 맵이 만들어진다
흔한 실수: 이미지 태그를 --set 으로 주어 숫자가 된다 — --set-string 을 쓴다
공식 문서: https://helm.sh/docs/chart_best_practices/values/ · https://helm.sh/docs/helm/helm_template/

단계 8개

넘어온 값을 있는 그대로 내보내는 차트
점·쉼표·중괄호 — set 의 문법
키 안에 점이 들어 있을 때
숫자로 읽히는 값과 그렇지 않은 값
리스트와 객체를 통째로 넣는다
파일 내용을 값으로 넣는다
값을 지우고, 리스트 원소를 집어서 고친다
같은 값을 파일로 줄 때와 set 으로 줄 때