From 156e1b2dce604e797249e12d32e6f8d4a904148e Mon Sep 17 00:00:00 2001 From: kaffa Date: Fri, 29 May 2026 19:56:38 +0900 Subject: [PATCH] =?UTF-8?q?history:=20termix=20image.tag=20=EB=AA=85?= =?UTF-8?q?=EC=8B=9C=20=EA=B3=A0=EC=A0=95=EC=9D=80=20=EC=A0=95=EC=B1=85=20?= =?UTF-8?q?=EC=9C=84=EB=B0=B0=20=E2=80=94=20:latest=20=EB=B3=B5=EA=B7=80?= =?UTF-8?q?=20=EC=9C=84=EC=9E=84=20=EA=B8=B0=EB=A1=9D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 사용자 정책: 컨테이너 이미지 tag는 :latest 유지가 디폴트 - 헤임달의 image.tag 고정 변경 및 본 history의 '교훈' 가이드 모두 정정 - 헤임달에 :latest 복귀 별도 위임 --- history/2026-05-29-termix-upgrade-release-2.3.1.md | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/history/2026-05-29-termix-upgrade-release-2.3.1.md b/history/2026-05-29-termix-upgrade-release-2.3.1.md index 3507e63..2078cc8 100644 --- a/history/2026-05-29-termix-upgrade-release-2.3.1.md +++ b/history/2026-05-29-termix-upgrade-release-2.3.1.md @@ -30,12 +30,16 @@ tags: [history, termix, k3s, argocd, helm, image-tag] 수정: chart values의 `image.tag`에서 `-tag` suffix 제거 → 정상 pull. -> **교훈**: 새 서비스의 image tag를 처음 명시 고정할 때는 release 페이지 이름이 아니라 **registry의 실제 tag**를 확인할 것 (`crane ls ` 또는 registry UI). +## 정책 노트 — image.tag 명시 고정 ❌ -## 후속 / 영향 +이번에 chart values에 `image.tag: release-2.3.1`을 명시 고정했지만, **사용자 정책상 잘못된 변경**이다. -- `:latest` 부유가 사라져서 이제 chart values 변경 없이는 이미지가 바뀌지 않음. 이전엔 노드 재시작/pod 재기동 시 무의식적으로 새 latest를 pull할 수 있었음. -- 다음 termix 업그레이드 시 절차: GitHub release 확인 → registry tag 이름 검증 → chart `image.tag` 갱신 → chart minor bump → ArgoCD sync. +- 디폴트는 `:latest` 유지. 업그레이드는 pod 재시작 한 번으로 충분. +- 명시 고정은 (a) chart 매번 수정 + (b) tag 이름 매칭 (이번 `-tag` suffix처럼) 함정 + (c) 자동 갱신 차단 → 비용만 늘림. +- 사용자 정책: 명시 고정은 "이 버전이어야만 하는 명확한 이유"가 있을 때만. 단순 업그레이드 작업에서 임의로 도입하지 말 것. +- 처리: 헤임달에 `image.tag` 줄 제거 + `:latest` 복귀 작업 위임 (2026-05-29 동일자). + +수행자 노트: kappa가 헤임달 변경 + 이 history의 초안 가이드("좋은 변경") 모두 사용자 정책 위배로 정정. 향후 헤임달 위임 시 본 정책을 명시 전달. ## 검증