Merge pull request #54 from paasup/update-apisix/2.17.0

apisix 차트를 2.16.0에서 2.17.0으로 올리고 3.18.0 발행 태그를 반영한다
2026-08-26 16:09:24 +09:00
parent 902a208907 3d3d508d04
commit 194dd1d52d
103 changed files with 36071 additions and 3 deletions
@@ -83,6 +83,25 @@ CLAUDE.md "설계 원칙"이 이 파이프라인을 직접 구속한다. 특히:
 - **Breaking change는 Rule Engine이 먼저 판단한다**(`custom-values.yaml`의 실제 사용 키 기준).
  LLM은 `breaking=true`일 때 Markdown 설명 생성만 담당한다.

+## helm_diff 사각지대 — off-by-default 서브차트
+
+`helm_diff` skill은 `helm template`을 **커스텀 값 없이 순수 기본값으로만** 렌더링한다
+(`-f custom-values.yaml`을 쓰지 않는다). 그래서 서브차트가 기본값으로 꺼져 있고
+`custom-values.yaml`에서만 `enabled: true`로 켜서 쓰는 경우, 그 서브차트의 리소스는
+diff에 아예 안 잡힌다 — `breaking=false`가 "그 서브차트도 안전하다"는 뜻이 아니다.
+
+실측 사례: apisix 2.16.0→2.17.0 업그레이드에서 `ingress-controller.enabled: true`로
+켜서 쓰는 `apisix-ingress-controller` 서브차트(1.2.0→1.3.0)에 새 CRD
+(`l4routepolicies.apisix.apache.org`)가 추가됐는데, `helm_diff.json`은 이걸 전혀
+보고하지 않았다(`breaking=false, warnings=0`). 서브차트 자체를 로컬에서 직접
+`helm pull` 해 비교하고서야 발견했다.
+
+**대응**: `custom-values.yaml`이 `enabled: true`로 켜는 서브차트가 있으면, 그 서브차트를
+`helm pull <repo>/<subchart> --version <old>`/`<new>`로 따로 받아 `values.yaml`·
+`templates/`·`crds/`를 직접 diff한다(특히 CRD 이름 목록 — `grep '^  name:' crds/*.yaml`).
+CRD가 추가됐다면 **Helm은 `helm upgrade`에서 기존 설치의 CRD를 자동 갱신하지 않으므로**
+`CUSTOM-README.md`에 수동 적용 안내를 남긴다.
+
 ## 참고

 - CLAUDE.md "자동화 Skills 작업" — 파이프라인 개요·환경변수