mcpField
A
act

act

官方Agent-ready
github.com开发者工具72.5kact今天更新
代码仓库访问官网

关于 act

act 使开发者能够在本地环境中执行 GitHub Actions 工作流，无需推送到仓库即可测试 CI/CD 流程。支持多种事件类型和作业配置，适合快速迭代和调试。

主要功能

  1. 01在本地容器环境执行 GitHub Actions 工作流
  2. 02支持 pull_request、push 等多种触发事件
  3. 03指定特定作业运行，加快反馈循环
  4. 04跨平台支持，集成现有开发工具链

适用场景

  1. 01在提交代码前在本地验证 CI 管道配置
  2. 02调试复杂的工作流逻辑和环境变量
  3. 03离线测试 GitHub Actions，减少仓库推送

安装

选择你的系统或包管理器，复制命令到终端运行。

$
brew install act

安装完成后运行act --version确认安装成功。

命令示例

常用命令按使用顺序排列。

01
act
02
act pull_request
03
act -j test

详细介绍

act-logo

概览 push Go Report Card awesome-runners

“放眼全球，在本地运行 act”

在本地运行你的 GitHub Actions！为什么要这么做？有两个原因：

  • 快速反馈 — 每次想测试对 .github/workflows/ 文件所做的更改（或对嵌入式 GitHub Actions 所做的任何更改）时，不必都提交并推送，你可以使用 act 在本地运行这些 Actions。环境变量和文件系统均已配置为与 GitHub 提供的环境相匹配。
  • 本地任务运行器 — 我喜欢 make。不过，我也讨厌重复劳动。使用 act，你可以利用 .github/workflows/ 中定义的 GitHub Actions 替代 Makefile！

提示

现在可直接在 VS Code 中管理和运行 Act！
查看 GitHub Local Actions Visual Studio Code 扩展，它让你无需离开编辑器，就能利用 act 的强大功能在本地运行和测试工作流。

它是如何工作的？

运行 act 时，它会读取 .github/workflows/ 中的 GitHub Actions，并确定需要运行的 Actions 集合。它使用 Docker API 拉取或构建工作流文件中定义的必要映像，最后根据已定义的依赖关系确定执行路径。确定执行路径后，它会根据先前准备的映像，使用 Docker API 为每个 Action 运行容器。环境变量和文件系统均已配置为与 GitHub 提供的环境相匹配。

让我们通过一个示例仓库看看它的实际效果！

Demo

Act 用户指南

更多文档请参阅 act 用户指南。

支持

需要帮助？欢迎在讨论区提问！

参与贡献

想为 act 做贡献？太棒了！查看贡献指南，了解如何参与。

从源代码手动构建

评论

支持 Markdown