← 목록

2025-09-03 · 정민호

Tekton에서 캐시 키를 설계할 때 자주 생기는 실수

레이어 캐시가 깨지거나 오래된 아티팩트가 배포되는 경우의 공통 패턴과 점검 순서를 소개합니다.

Tekton에서 캐시 키를 설계할 때 자주 생기는 실수
캐시 키에 커밋 해시만 넣고 의존성 매니페스트를 빼먹으면 빌드는 통과하지만 런타임 의존성은 갱신되지 않습니다. 반대로 너무 많은 파일을 키에 넣으면 캐시 적중률이 떨어져 파이프라인 시간이 늘어납니다. 좋은 균형은 "의존성 변경을 감지하는 최소 파일 집합"을 키에 포함하는 것입니다. lockfile이 여러 개라면 각 패키지 매니저별로 분리해 기록하세요. 캐시 볼륨의 TTL과 레지스트리 태그 정책도 함께 문서화해야 운영자가 실수로 오래된 캐시를 붙잡는 일을 줄일 수 있습니다. 마지막으로 캐시 무효화 이벤트를 알림으로 남기세요. 침묵 속에서 반복되는 캐시 미스는 비용 문제로 번질 수 있습니다.