DOCS/troubleshooting/250929_actions_cache_problem.md

36 lines
1.2 KiB
Markdown

---
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 업데이트로 개선 기대