fix(release): 번들 parity 를 v1.16.9 로 맞추고 축소 누락을 막는다

[KeiaiLab-PHIL]

무엇

v1.16.9 태그가 릴리스 preflight 의 ADR-0038 게이트에서 멈췄다:

bundle CSV version (1.16.6) != Chart.yaml appVersion (1.16.9)

릴리스 커밋(#405)이 차트만 올리고 번들 재생성을 빠뜨린 탓이다. 번들을 1.16.9 로 재생성하고,
같은 자리에서 드러난 두 번째 함정을 함께 막는다.

두 번째 함정 — 축소 단계가 실패를 삼킨다

make bundle 은 번들 CRD 를 maxDescLen=0 으로 줄인다. OLM v1 은 번들 전체를 helm release
Secret(etcd 1MiB 한도)에 담기 때문에 full-description CRD 는 설치를 깨뜨린다(ADR-0038, kind
e2e 실증). 그런데 그 단계가 부르는 $(CONTROLLER_GEN) 이 없으면 레시피 줄의 종료 상태가
뒤따르는 rm -rf 것이 되어 실패가 성공으로 보인다. 실측:

✓ bundle: ./bundle/ (1.16.9, ... CRD maxDescLen=0)     ← 성공했다고 말한다
::error:: bundle CRD 합계 5100500B > 2.5MiB            ← 실제로는 축소가 안 됐다

preflight 가 잡아주긴 하지만 그때는 이미 태그를 민 뒤다.

bundle 타깃이 controller-gen 을 선행 요구하게 했다. 변수가 아니라 타깃 이름으로 건다 —
전제조건은 파싱 시점에 전개되는데 CONTROLLER_GEN 정의는 480행이라 193행에서 $(CONTROLLER_GEN)
으로 걸면 빈 문자열이 되어 아무것도 안 걸린다(실제로 그렇게 먼저 써보고 무동작을 확인했다).

검증

바이너리를 지우고 재현했다:

bin 항목수: 0
Downloading sigs.k8s.io/controller-tools/cmd/controller-gen@v0.17.0
✓ bundle: ./bundle/ (1.16.9, channels=stable+alpha, default=stable, CRD maxDescLen=0)
✓ bundle CSV version == appVersion (1.16.9)
✓ bundle CRD 개수 == config/crd/bases (9)
✓ bundle CRD 합계 1704439B (< 2.5MiB — OLM helm-release-secret 한도 안전)
✓ verify-bundle-parity PASS

CRD 합계가 축소 정상 동작 시의 값(1704439B)과 바이트 단위로 일치한다 — 축소가 결정론적이라
번들 CRD 파일 자체에는 diff 가 없고, 변경은 버전 문자열과 Makefile 한 줄뿐이다.

머지 후 v1.16.9 태그를 다시 밀어 이미지 발행을 재시도한다.

🤖 Generated with Claude Code

https://claude.ai/code/session_01VbPL3ACkTc18bnwYUd7G3w