From f7e2f23df0892d8ab6ed81a12d9473474476bdac Mon Sep 17 00:00:00 2001
From: happybell80 <happybell80@gmail.com>
Date: Mon, 29 Sep 2025 13:31:48 +0900
Subject: [PATCH] =?UTF-8?q?docs:=20Gitea=20Actions=20=EC=BA=90=EC=8B=9C=20?=
 =?UTF-8?q?=EB=AC=B8=EC=A0=9C=20=ED=95=B4=EA=B2=B0=20=EB=B0=A9=EB=B2=95=20?=
 =?UTF-8?q?=EB=AC=B8=EC=84=9C=ED=99=94?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../250929_actions_cache_problem.md           | 36 +++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 troubleshooting/250929_actions_cache_problem.md

diff --git a/troubleshooting/250929_actions_cache_problem.md b/troubleshooting/250929_actions_cache_problem.md
new file mode 100644
index 0000000..6dd6752
--- /dev/null
+++ b/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 업데이트로 개선 기대
\ No newline at end of file