DOCS/troubleshooting/250929_actions_cache_problem.md

date, author, tags

date	author	tags
2025-09-29	happybell80	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/ 파일 변경 시에도 캐시 자동 갱신 안됨

해결 방법

# Actions 캐시 강제 삭제
sudo rm -rf /root/.cache/act/

# 또는 특정 프로젝트만
sudo rm -rf /root/.cache/act/*/프로젝트명/

교훈

• Gitea Actions 워크플로우 수정 후 반영 안되면 act runner 캐시 확인 필수
• 중요한 워크플로우 변경 시 캐시 삭제 후 재실행
• 향후 act runner 업데이트로 개선 기대