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 # 使用 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 令牌)。
- 使用微型镜像以获得更快的运行速度。
- 非常适合在不等待 GitHub Runner 的情况下迭代 CI。