wbsong111
7746570ec0
images/·scripts/build/build-hardened-image.sh·suggest-go-upgrades.py·
build-image.yml·.claude/image-authoring.md·이미지 ADR(0001·0002·0004)을 삭제했다 —
전부 별도 public 레포 security-images 로 이미 이관됐다.
카탈로그 쪽에는 "무엇을 배포 중인가"를 아는 부분만 남긴다:
- catalog/image-map/<image>.env — 옛 catalog.env 의 카탈로그 레이아웃 정보만 뗀 것
- scripts/build/check-rebuild-needed.py — 드리프트 탐지(A 파트)만 남기고 핀 판단
(B 파트: pin_changes/apply_changes/parse_module_specs)은 제거
- scripts/build/apply-published-tags.py(신규) — security-images 의 published.json
을 읽어 카탈로그 values 를 패치
- .github/workflows/{self-build-drift-check,catalog-tag-update}.yml(신규) — 각각
드리프트 스캔+트리거, 발행 태그 반영
effective_severity 를 cve-gate.py 로 옮겼다 — check-rebuild-needed.py 가 핀 도구를
거치지 않고 게이트를 직접 로드하게 하기 위한 선행 작업이다.
두 레포의 계약은 published.json 스키마 하나뿐이다 — security-images 는 이 카탈로그를
모른다(단방향 의존). 이관 배경·결합점 전체는
doc/migrations/self-build-images-to-security-images.md.
부수 수정: 자체 빌드 이미지를 참조하는 차트 values/README 의 죽은 링크(images/**,
doc/decisions/000{1,2,4}, .claude/image-authoring.md)를 security-images 레포를
가리키는 서술로 교체. deploy-test 스크립트·CUSTOM-README 의 개인 Docker Hub 계정
(docker.io/wbsong111) 을 docker.io/paasup 로 교체.
pitfalls.md 의 "스캐너 결과를 그대로 믿지 말 것" 절은 sbom-cve-gate skill 이 차트
축 설명에 실제로 참조하고 있어 남겼다 — "이미지 태그의 베이스 OS" 절만 제거했다
(다른 참조 없음, security-images 문서로 이관 완료).
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
이미지 → 차트 매핑
security-images 레포가 발행하는 자체 빌드 이미지가 이 카탈로그의 어느 차트·어느 필드를
가리키는지 선언한다. 이 디렉토리에 파일이 있는 이미지 이름 = 이 카탈로그가 추적하는
자체 빌드 이미지 목록이다(scripts/build/check-rebuild-needed.py와
.github/workflows/catalog-tag-update.yml이 이 목록을 기준으로 동작한다).
이관 배경: 이 정보는 원래 security-images(당시 images/<image>/catalog.env)에 있었다.
"어느 이미지를 쓰는가"는 카탈로그가 알아야 하고 "그 이미지를 어떻게 만드는가"는
security-images 가 알아야 하므로, 레포 분리 시 이 지식을 카탈로그 쪽으로 옮겼다 —
doc/migrations/self-build-images-to-security-images.md
참고.
파일 형식 — <image>.env
<image>는 security-images 레포의 images/<image>/ 디렉토리명과 정확히 같아야 한다
(published.json의 키도 같다).
| 키 | 의미 |
|---|---|
CHART_DIRS |
이 이미지의 태그를 참조하는 차트 버전 디렉토리 (공백 구분, 여러 개 가능) |
TAG_STYLE |
imageName(단일 필드 문자열) | split(registry/repository/tag 분리) |
TAG_BLOCK |
split일 때 태그가 있는 블록의 점 구분 경로 (기본 image) |
카탈로그는 한 차트의 여러 버전을 동시에 보관하는 "버전 보관소"다 — 이미지 하나가
여러 버전 디렉토리에 걸리는 것이 정상이다. 새 버전 디렉토리를 만들 때 이 매핑도
함께 갱신한다. 빠뜨리면 scripts/build/patch-catalog-tag.py가 그 파일을 검사조차
하지 않아 낡은 태그가 조용히 남는다(실측: cnpg-postgresql이 cnpg-cluster/1.0.0만
매핑돼 있어 1.1.0이 낡은 태그로 남은 사고가 있었다).