如何使用 act 快速调试 Github Actions?

6 min read

要使用 act 快速调试 Github Actions,请按照以下步骤操作:

1.首先,您需要在本地安装 act 工具,可以使用以下命令进行安装:

npm install -g act

2.接下来,您需要在存储库中创建一个名为 .github/workflows/your-workflow.yml 的工作流文件,并在其中定义您要测试的工作流。

例如,以下是一个示例工作流文件:

name: CI
on: push
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v2
      - name: Build
        run: npm install && npm run build

3.在命令行中进入存储库根目录,并运行以下命令来运行 act 工具:

act

该命令将通过解析您的工作流文件并模拟 workflow 事件来触发工作流并输出工作流运行的日志。

默认情况下,act 工具会使用 Docker 容器来模拟运行环境,您可以使用以下命令禁用 Docker

act -P ubuntu-latest=catthehacker/ubuntu:act-latest

如果您要通过 act 工具来测试某些部分的工作流程,则可以在命令后面添加部分名称。例如,以下命令将仅运行名为 build 的作业:

act build

通过以上步骤的操作,您应该能够使用 act 工具快速测试和调试 GitHub Actions 工作流程。