docs: Gitea Actions 캐시 문제 해결 방법 문서화

troubleshooting/250929_actions_cache_problem.md

@@ -0,0 +1,36 @@
+---
+date: 2025-09-29
+author: happybell80
+tags: [gitea, actions, cache, deployment]
+---
+
+# Gitea Actions 캐시로 인한 워크플로우 미반영 문제
+
+## 문제 상황
+- **증상**: 로컬에서 Actions 워크플로우(.gitea/workflows/) 수정 후 push해도 서버에서 이전 워크플로우 실행
+- **영향**: docker compose down 제거 등 중요한 수정사항이 반영되지 않음
+- **발생 빈도**: 워크플로우 파일 수정 시마다 반복 발생
+
+## 근본 원인
+1. **act runner 캐시 메커니즘**
+   - 실행 위치: `/root/.cache/act/*/hostexecutor/`
+   - 저장소 코드: `/home/admin/ivada_project/` (최신)
+   - Actions 실행: 캐시된 이전 워크플로우 사용
+
+2. **캐시 미갱신**
+   - act runner가 성능 최적화를 위해 워크플로우 캐시
+   - .gitea/workflows/ 파일 변경 시에도 캐시 자동 갱신 안됨
+
+## 해결 방법
+```bash
+# Actions 캐시 강제 삭제
+sudo rm -rf /root/.cache/act/
+
+# 또는 특정 프로젝트만
+sudo rm -rf /root/.cache/act/*/프로젝트명/
+```
+
+## 교훈
+- Gitea Actions 워크플로우 수정 후 반영 안되면 act runner 캐시 확인 필수
+- 중요한 워크플로우 변경 시 캐시 삭제 후 재실행
+- 향후 act runner 업데이트로 개선 기대