Act
개요
Act는 Docker를 사용하여 GitHub Actions 워크플로우를 로컬에서 실행합니다. GitHub에 푸시하지 않고 CI 파이프라인을 테스트하고 디버깅할 수 있습니다. 대부분의 GitHub Actions 기능을 지원합니다.
사용 방법
1단계: 설치
brew install act
2단계: 워크플로우 실행
act # push 이벤트 실행
act pull_request # PR 이벤트 실행
act -j test # 특정 작업(job) 실행
act -W .github/workflows/ci.yml # 특정 워크플로우 파일 지정
act --secret-file .env.secrets # 시크릿 파일과 함께 실행
3단계: 설정
# .actrc — 기본 설정 파일
-P ubuntu-latest=catthehacker/ubuntu:act-latest
--env-file .env
4단계: 디버깅
act -n # 드라이 런 (실제 실행 없이 시뮬레이션)
act -v # 상세 출력
act -l # 워크플로우 목록 보기
지침
- 처음 실행 시 Docker 이미지를 다운로드합니다(약 1~3GB).
- 모든 GitHub Actions 기능이 로컬에서 동작하는 것은 아닙니다(예: OIDC 토큰).
- 더 빠른 실행을 위해 마이크로(micro) 이미지를 사용하세요.
- GitHub 러너를 기다리지 않고 CI를 반복적으로 테스트할 때 매우 유용합니다.