act 用于本地运行 GitHub Actions

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

act 可以使用 Homebrew、Chocolatey 甚至一个简单的 BASH 脚本在本地进行设置。要使用 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