Act
概述
Act 使用 Docker 在本機執行 GitHub Actions 工作流程。無需推送至 GitHub 即可測試與除錯 CI 管道。支援大部分 GitHub Actions 功能。
使用說明
步驟 1:安裝
brew install act
步驟 2:執行工作流程
act # 執行 push 事件
act pull_request # 執行 PR 事件
act -j test # 執行特定作業
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 Token)。
- 使用精簡映像檔可加速執行。
- 非常適合在不等待 GitHub Runner 的情況下反覆調整 CI 流程。