자체 빌드 이미지 문서가 이 레포에 없는 경로를 인용하던 것을 없앤다 (#33) (#34)

images/·manifests/helm/·.claude/ 의 20개 파일이 doc/decisions·doc/analysis 등 **이 레포에
존재한 적 없는 경로 15종을 48곳에서** 인용하고 있었다. security-catalog 에서 포팅할 때
따라온 것인데, 그 레포는 개인 레포(github.com/wbsong111/security-catalog)라 팀 구성원은
접근조차 못 한다 — "security-catalog 에 있으나 이관되지 않았다" 는 안내가 아무 역할을
하지 못했다.

원문을 통째로 복사하지 않았다
----------------------------
원본 문서들이 서로를 근거로 인용한다. decisions/0001 하나만 봐도 analysis/cnpg-image-baseline.md
· analysis/vendor-unassessed-data-sources.md 처럼 **인용 목록에 없던 또 다른 미이관 문서**를
가리킨다. 복사는 문제를 옮기는 것이지 없애는 게 아니다.

그리고 대부분은 애초에 dip-catalog 가 더 나은 것을 갖고 있다. 7곳에서 인용되던
analysis/sles-oval-measurement.md 는 원문 스스로 "이 문서는 결정하지 않는다. 재측정하면
갱신된다" 고 밝히는 스냅샷인데, dip-catalog 는 같은 측정을 CoverageProbe 로 매 스캔마다
자동으로 한다. 문서를 복사하는 것보다 게이트를 가리키는 것이 정확하다.

그래서 성격별로 나눴다
---------------------
  재측정으로 복원 안 되는 것  →  doc/decisions/ 에 자립적 ADR 로 다시 씀 (4건)
  이미 단일 출처가 있는 것    →  그쪽으로 인용 교체 (11종 경로)

ADR 4건은 security-catalog 0001·0005·0006·0007 이 원본이고, 결론과 근거만 추려
dip-catalog 맥락으로 새로 썼다 — **레포 밖을 가리키는 링크가 0이다.** 번호는 이 레포에서
0001~0004 로 다시 붙였고 원본 대응은 각 문서와 README 에 적었다. 왜 안 가져온 것은 안
가져왔는지도 README 표에 남겼다.

인용 교체는 카테고리별로:
  analysis/*-cve.md, cnpg-image-vuln-comparison.md  →  해당 ADR · images/<image>/README.md
  analysis/sles-oval-measurement.md                 →  게이트 CoverageProbe (doc/sbom-pipeline.md)
  cve-zero-pipeline.md, architecture/build-pipeline.md → doc/sbom-pipeline.md
  image-selection.md                                →  .claude/image-authoring.md
  charts/*/deploy-test.md                           →  scripts/deploy-test/*.sh + 절차 문서

찾은 오류 2건
-------------
- images/cloudnative-pg/source.build.env 가 인용한 decisions/0004-cloudnative-pg-operator-self-build.md
  는 **번호 오기**다. 원본 0004 는 postgresql-chart-selection 이고 이 결정은 0005 다.
- cnpg-cluster values.yaml·templates/database.yaml 이 인용한 doc/deploy-test-cnpg.md 는
  **원본 레포에도 없다.** CREATE EXTENSION 함정 설명은 주석 자체에 이미 있어 인용만 뺐다.

검증
----
  우리 파일의 깨진 doc/ 인용        0건 (전수 스캔)
  새 문서·수정 문서의 로컬 링크     전부 실재 확인
  helm template                     cnpg-cluster · etcd · cloudnative-pg 정상 렌더

남은 doc/health-checking.md(144곳)·doc/integration/*(2곳)은 업스트림 CRD·차트 안의 문자열로
우리가 쓴 인용이 아니다 — 건드리지 않았다.

Closes #33

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>

doc/decisions/0003-etcd-chart-selection.md

@@ -0,0 +1,64 @@
+# 0003. etcd 배포 방식 — `groundhog2k/etcd` 단일 차트 채택, replicas=1(SPOF 수용)
+
+- 날짜: 2026-07-31
+- 상태: 확정
+- 원본: security-catalog ADR 0006 — dip-catalog 맥락으로 다시 썼다([README](README.md) 참고)
+
+## 결정
+
+카탈로그의 etcd 배포 방식으로 `groundhog2k/etcd` 차트(오퍼레이터 없는 단일 StatefulSet
+차트)를 채택한다. 용도는 **단일 APISIX 인스턴스의 설정 저장소**이며, 쿼럼 HA 대신
+`replicas: 1` 로 배포한다 — **단일 장애점을 의도적으로 수용한다.** 기존 `bitnami/etcd` 기반
+배포는 이 차트로 교체한다.
+
+카탈로그 위치는 [manifests/helm/etcd/1.1.12/](../../manifests/helm/etcd/1.1.12/)다.
+`replicas: 1` 은 `custom-values.yaml`(APISIX 용도), 쿼럼이 필요한 다른 소비자를 위한
+`replicas: 3` 프로파일은 `dip-values.yaml` 에 있다.
+
+## 배경
+
+dev 클러스터 `apisix` 네임스페이스에 이미 `data-apisix-etcd-0` PVC 가 있었다 — `bitnami/etcd`
+기반 APISIX 배포가 떠 있었다는 뜻이다. 이를 카탈로그 방식으로 정식 편입하며 이미지 출처를
+재검토했다. 후보는 `groundhog2k/etcd`(채택), `bitnami/etcd`(기존), `aenix-io/etcd-operator`
+류의 오퍼레이터 방식이다.
+
+## 근거
+
+**Bitnami 이미지 카탈로그 정책 변경(2025-08)이 결정적이었다.** `docker.io/bitnami/etcd` 는
+2025-08-28 부로 `bitnamilegacy/etcd` 로 이전되어 **동결**됐고(이후 보안 패치 없음),
+2025-09-29 공개 카탈로그 삭제 이후 신규 무료 티어는 44개 "development-only" 이미지로
+한정되며 그마저도 **버전 고정 없이 `latest` 태그만 제공**한다. 계속 패치를 받으려면 유료
+구독이 필요하다.
+
+이는 카탈로그 목표와 두 지점에서 정면 충돌한다.
+
+1. 패치가 멈춘 이미지는 시간이 지날수록 미수정 CVE 가 구조적으로 누적된다 —
+   "CRITICAL/HIGH 0건" 을 유지 가능한 상태로 지속할 수 없다.
+2. 버전 고정 없는 `latest`-only 배포는 **롤링 태그 금지** 규칙과 애초에 양립하지 않는다
+   ([.claude/image-authoring.md](../../.claude/image-authoring.md)).
+
+`groundhog2k/etcd` 는 업스트림 etcd 프로젝트의 원본 이미지(`quay.io/coreos/etcd`)를 그대로
+쓰므로 이 문제가 없다 — 다른 카탈로그 항목과 동일한 "업스트림 원본 이미지 + 버전 고정 태그"
+모델이다.
+
+**오퍼레이터 방식은 측정 없이 정성적으로 배제했다.** 단일 APISIX 인스턴스에 쿼럼 HA 가
+불필요하다고 판단해, CRD·컨트롤러·RBAC 을 추가로 들이는 비용이 이득보다 크다고 봤다. 실측
+비교는 하지 않았다 — 이 판단은 근거가 정성적이라는 것을 명시해 둔다.
+
+## 받아들인 비용
+
+- **단일 장애점(SPOF)** — `replicas: 1` 이라 etcd Pod/노드 장애 시 APISIX 설정 조회·변경이
+  즉시 불가능해진다. 쿼럼 기반 자동 복구가 없다.
+- **자동 백업이 없다** — 차트에 백업 기능이 없고, SPOF 상태에서 장애가 데이터 손실로 이어질
+  수 있다. 스냅샷은 수동(`etcdctl snapshot save`)이다.
+- **Bitnami 가 기본 제공하던 부가 기능**(메트릭 익스포터 등 번들 구성)을 잃는다. 필요하면
+  `serviceMonitor` 설정으로 별도 구성한다.
+- **쿼럼 HA 로 전환하려면 데이터 마이그레이션을 동반한 재배포가 필요하다** — `replicas` 는
+  최초 배포 후 변경 불가다(차트 제약).
+
+## 재검토 조건
+
+- APISIX 를 다중 인스턴스로 확장해 etcd 쿼럼 HA 가 실제로 필요해지면.
+- etcd Pod 장애로 인한 SPOF 위험이 운영상 수용 불가능한 빈도로 발생하면.
+- `groundhog2k/etcd` 유지보수가 중단되거나, 이 결정의 근거였던 문제(패치 중단·롤링 태그
+  강제)가 이 차트에서도 재현되면.