apisix 차트를 2.16.0에서 2.17.0으로 올리고 발행된 3.18.0 자체 빌드 태그를 반영한다

hardened-containers가 apisix 3.17 라인 EOL로 3.18.0을 게이트 PASS로 새로 발행했다 (hardened-containers 커밋 3518f98: "3.17 line went EOL"). 이게 이 카탈로그의 차트 버전 갱신 트리거다 — appVersion을 3.18로 맞추려면 차트도 2.17.0(appVersion 3.18.0)으로 올려야 한다. breaking_change_check: breaking=false. 다만 자동 diff가 못 잡는 실제 변경을 수동으로 하나 찾았다 — ingress-controller.enabled=true로 켜서 쓰는 apisix-ingress-controller 서브차트(1.2.0→1.3.0)에 새 CRD l4routepolicies.apisix.apache.org가 추가됐다. helm_diff는 이 서브차트를 기본값 (off)으로만 렌더링해 애초에 스캔 대상에서 빠뜨린다 — CUSTOM-README.md에 수동 적용 안내를 남기고, 이 사각지대 자체를 catalog-update-pipeline SKILL.md에 기록해 다음 리뷰 때 놓치지 않게 했다. catalog/image-map/{apisix,apisix-ingress-controller,adc}.env의 CHART_DIRS를 2.17.0으로 교체(2.16.0은 동결)하고, apply-published-tags.py로 발행된 실제 태그 (apisix 3.18.0-20260826, ingress-controller/adc는 최근 재스캔 리빌드분)를 반영했다. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-08-26 16:00:31 +09:00
parent b94db8828c
commit 3d3d508d04
103 changed files with 36071 additions and 3 deletions
@@ -0,0 +1,79 @@
+# apisix 버전 갱신 가이드
+
+## 1. git 작업 환경 구성
+
+- DIP 카탈로그 git 다운로드
+```sh
+git clone https://github.com/paasup/dip-catalog.git
+```
+
+- 작업 브랜치로 체크아웃
+```sh
+git checkout -b update-apisix/2.14.0
+```
+
+## 2. helm 차트 버전 업데이트
+
+- BUILD-README.md, CUSTOM-README.md, custom-values.yaml을 제외한 파일 삭제
+```sh
+# chart 디렉토리로 이동
+cd ~/dip-catalog/manifests/helm/apisix/2.14.0
+
+# 삭제할 파일 목록 확인
+find . -mindepth 1 \( -name "CUSTOM-README.md" -o -name "BUILD-README.md" -o -name "custom-values.yaml" \) -prune -o -print
+
+# 파일 삭제
+find . -mindepth 1 \( -name "CUSTOM-README.md" -o -name "BUILD-README.md" -o -name "custom-values.yaml" \) -prune -o -exec rm -rf {} +
+```
+
+- apisix 차트 다운로드
+```sh
+# manifests/helm/apisix 디렉토리로 이동
+cd ~/dip-catalog/manifests/helm/apisix
+
+# helm repo 추가
+helm repo add apisix https://charts.apiseven.com
+helm repo update
+
+# helm 차트 pull
+helm pull apisix/apisix --version="2.14.0"
+
+# 차트 압축 해제
+tar xzvf apisix-2.14.0.tgz
+
+# 압축 파일 삭제
+rm apisix-2.14.0.tgz
+```
+
+## 3. git push 및 tag 추가
+
+- 갱신작업 진행 후 commit
+```sh
+git add .
+git commit -m "update apisix/2.14.0"
+```
+
+- main 브랜치에 체크아웃 후 merge
+```sh
+git checkout main
+git merge update-apisix/2.14.0
+```
+
+- git에 push 후 작업 브랜치 삭제
+```sh
+git push -u origin main
+git branch -d update-apisix/2.14.0
+```
+
+- git tag 추가 후 push
+```sh
+git tag apisix/2.14.0
+git push origin apisix/2.14.0
+```
+
+## 4. 차트 버전 정보
+
+- apisix/2.14.0 (app version: 3.16.0)
+  - Apache APISIX 공식 Helm 차트 (https://charts.apiseven.com)
+  - keycloak-authz 커스텀 플러그인 포함 (Kong 포팅)
+  - 차트의 빌드 방법과 배포 방법을 BUILD-README.md, CUSTOM-README.md 문서에 작성하였다.