SuperAPI AI 工具集

act-local-testing

测试与质量

查看项目

更新于 10-16 03:38

技能介绍

用途:本技能面向希望在本地运行和调试 GitHub Actions 工作流的开发者,用 act 在推送前验证 CI/CD,实现快速本地迭代。

主要能力:运行由 push、pull_request、workflow_dispatch 等事件触发的全部或指定工作流与作业(如 act -W .github/workflows/ci.yml、act -j build、act -l 列出工作流与作业);支持空跑校验(act --dryrun、act -n)和流程图形展示(act -g);通过 Docker 镜像模拟 GitHub 运行器,可指定 catthehacker/ubuntu:act-latest 等镜像;支持密钥(--secret-file、-s)、环境变量(--env、--env-file)、矩阵组合(--matrix)、容器复用(--reuse)、绑定挂载(--bind)与交互暂停(--watch);可通过 .actrc 固化配置。

安装:macOS 用 brew install act;Linux 用 curl -s https://raw.githubusercontent.com/nektos/act/master/install.sh | sudo bash;Windows 用 choco install act-cli 或 scoop install act;源码安装 go install github.com/nektos/act@latest。

使用方式:将密钥写入 .secrets 并加入 .gitignore,环境变量写入 .env;调试时用 act -v 或 act -vv,配合 --reuse 后进入容器检查;常见排错包括确认 Docker 运行、手动拉取镜像、检查工作流文件与 YAML 语法、为缺失工具换用更完整镜像。

适用场景:本地验证 workflow 语法与单个作业、推送前快速回归、矩阵组合试跑、CI 工作流本地迭代。

限制:部分 GitHub 专属 action 不兼容 act,可用 if: ${{ !env.ACT }} 跳过;并非所有 action 表现与线上一致;需注意 Docker 磁盘占用,勿提交密钥文件。未提供具体版本价格等信息。