nektos/act

어떤 프로젝트인가요?

핵심 기능

• 01Docker 컨테이너를 사용해 GitHub Actions 워크플로를 로컬에서 실행합니다.
• 02작업 간 종속성을 파악해 실행 순서를 정합니다.
• 03GitHub 러너와 비슷하게 환경 변수와 파일 시스템 경로를 설정합니다.
• 04기존 워크플로 파일을 기반으로 로컬 작업 실행기로 사용할 수 있습니다.
• 05편집기에서 워크플로를 실행할 수 있는 VS Code 확장 프로그램을 제공합니다.

활용 사례

• 푸시하기 전에 .github/workflows/ 파일의 변경 사항을 테스트합니다.
• 원격 러너를 기다리지 않고 실패한 CI 작업을 디버깅합니다.
• 재사용 가능한 워크플로 정의로 Makefile을 대체해 로컬 작업을 실행합니다.

빠른 시작

1. 1

   Docker를 설치하고 실행 중인지 확인합니다

2. 2

   repo를 clone하고 make install로 소스에서 빌드합니다(Go 1.20 이상 필요)

   make install
3. 3

   .github/workflows/가 있는 repo에서 워크플로를 로컬로 실행합니다

   act

사용 전 알아둘 점

• !Docker를 설치하고 실행해야 합니다.
• !컨테이너에서 실행되므로 GitHub-hosted runner 환경과 완전히 일치하지 않을 수 있습니다.

토픽

자주 묻는 질문

act은(는) 무엇인가요?

GitHub Actions 워크플로를 Docker에서 로컬로 실행해 커밋하고 푸시하지 않고도 변경 사항을 테스트할 수 있는 CLI입니다. act는 .github/workflows/의 워크플로 파일을 읽고 Docker를 사용해 작업을 로컬에서 실행합니다. 각 워크플로에 필요한 이미지를 가져오거나 빌드하고, 작업 간 종속성을 바탕으로 실행 순서를 정한 뒤 각 단계마다 컨테이너를 시작합니다. 환경 변수와 파일 시스템 구조는 GitHub 호스팅 러너가 제공하는 환경과 비슷하게 설정됩니다.

act은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

act은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

act은(는) 아직 유지보수되고 있나요?

6개월 이내 업데이트. act의 마지막 커밋은 2026년 8월 9일입니다.

act은(는) 어디에 사용할 수 있나요?

푸시하기 전에 .github/workflows/ 파일의 변경 사항을 테스트합니다. 원격 러너를 기다리지 않고 실패한 CI 작업을 디버깅합니다. 재사용 가능한 워크플로 정의로 Makefile을 대체해 로컬 작업을 실행합니다.

act는 어떻게 설치하나요?

Docker를 설치하고 실행 중인지 확인합니다 repo를 clone하고 make install로 소스에서 빌드합니다(Go 1.20 이상 필요): make install .github/workflows/가 있는 repo에서 워크플로를 로컬로 실행합니다: act

act은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/nektos/act