act 用于在本地运行 GitHub Actions

act 是 Nektos 提供的一个工具，它提供了一种方便的方式，可以使用 Docker 在本地运行 GitHub Actions。 act 提供了一种快速验证 CI 中更改的方法，无需将更改提交/推送到工作流程以触发和验证相同的更改。 它可以快速反馈，并且它作为本地任务运行器的兼容性可以验证我们所有 CI 作业，使其成为一个方便的工具。

可以使用 Homebrew、Chocolatey 甚至简单的 BASH 脚本在本地设置 act。 要使用 BASH 脚本进行设置，只需在终端中执行以下命令

curl https://raw.githubusercontent.com/nektos/act/master/install.sh | sudo bash

使用 Homebrew，您可以通过以下方式进行设置： brew install act。

下一步是定义我们可以用来在本地运行操作的自定义镜像。 act 为 Ubuntu GitHub 运行器提供微型、中型和大型 Docker 镜像。 act 尚未支持 Windows 和 macOS 镜像。

首次运行 act 时，我们可以定义要用于本地 CI 运行的镜像。 配置保存在 ~/.actrc 文件中。

在 GitHub 存储库中，首次运行 act 时，它将找到 ./.github/workflows 和所有存在的工作流程。 要查看作为 GitHub Actions CI 部分列出的作业，请执行以下命令

act -l

它将列出所有作业，您可以选择要运行的特定作业。如果您要运行特定作业，请输入以下命令

act -j <JOB_NAME>

要以试运行模式运行作业，请输入以下命令

act -n

要以详细日志模式运行作业，请输入以下命令

act -v

要重用 act 中的容器以维护状态，请输入以下命令

act -j <JOB_NAME> --bind --reuse

建议注释掉 GitHub 特定事件，例如 github.repository 或 github.event.head_commit.message。如果您在操作中使用环境变量，建议您创建一个 my.secrets 文件，并将这些环境变量提供给 act，方法是输入以下命令

act --secret-file my.secrets

如果环境变量通过 .env 文件提供，请使用以下命令

act --env-file my.env