如何快速在本地跑通 GitHub Actions？actrun 新手完整教程

【免费下载链接】actrunGitHub Actions compatible local runner项目地址https://gitcode.com/gh_mirrors/ac/actrun点击查看免费下载还在为 GitHub Actions 的排队和慢启动烦恼吗本文带你用actrun一个用 MoonBit 编写的 GitHub Actions 兼容本地 runner在几分钟内把工作流跑起来本地运行、查看日志、跳过无关步骤最后再谈优化。为什么选择 actrun 本地运行把 CI 搬到本地你能获得这些好处⚡秒级反馈不用等云端队列local模式启动约 0.13 秒快速调试直接读run logs甚至查看单条 step 日志语义一致保持与 GitHub Actions 相同的 YAML 与上下文本地跑通后推上去基本不用改️可选隔离支持worktree、tmp、docker等工作区模式不污染你的工作目录性能基准Apple Silicon模式启动耗时写 1k 文件local~0.13s52msnix-packages~0.70s47msapple-container~0.93s14ms第一步安装 actrun安装方式任选其一推荐新手直接用npx零安装# npx无需安装 npx mizchi/actrun workflow run .github/workflows/ci.yml # npm 全局安装 npm install -g mizchi/actrun # Docker docker run --rm -v $PWD:/workspace -w /workspace ghcr.io/mizchi/actrun workflow run .github/workflows/ci.yml也可以从源码构建git clone https://gitcode.com/gh_mirrors/ac/actrun cd actrun moon build src/cmd/actrun --target native5 分钟跑通你的第一个工作流先用仓库自带的 01-hello.yml 体验一下name: hello on: push jobs: greet: runs-on: ubuntu-latest steps: - run: echo Hello from actrun!运行它就一条命令actrun workflow run examples/01-hello.yml接下来是新手最常用的几个动作# 不真正执行先看执行计划推荐先跑一次确认 actrun workflow run examples/01-hello.yml --dry-run # 列出项目里所有工作流 actrun workflow list # 查看历史运行与日志 actrun run list actrun run view run-1 actrun run logs run-1 --task greet 小技巧省略workflow run也可以actrun .github/workflows/ci.yml是等价简写。本地上下文自动填充在普通 git 仓库里直接运行actrun 会自动从本地仓库检测github.repository、github.ref_name、github.sha和github.actor通常不需要任何额外配置。如果你需要固定这些值比如演示、截图场景可以在actrun.toml里写[local_context]覆盖优先级规则见 local-context.md。让本地更快跳过与裁剪先跑起来再变快——下面这些开关就是变快的部分全都无需改动工作流文件目标命令 / 配置说明跳过本地不需要的 action--skip-action actions/checkout可重复使用也可写入actrun.toml的local_skip_actions只跑失败的部分actrun ci.yml --retry复跑时跳过已成功的 job按文件变更跳过整个工作流actrun ci.yml --affected HEAD~3类似 nx / turborepo 的 affected 机制只跑某个 job / stepactrun ci.yml --job build --step test定向调试本地专属调试步骤条件if: ${{ env.ACTRUN_LOCAL }}actrun 会设置ACTRUN_LOCALtrueACTRUN_LOCAL是个非常实用的特性本地执行时 actrun 会注入该环境变量你可以在工作流里用它区分本地与云端。仓库里的 06-local-skip.yml 就是一个完整示例本地跳过checkout和setup-node云端照常执行。# 组合拳跳过 checkout 只跑 build job 失败重试 actrun ci.yml --skip-action actions/checkout --job build --retry更多参数速查请见 cheatsheet.md--affected的完整配置方式见 advanced-workflow.md。常见工作流示例仓库examples/目录提供了 30 个可直接运行的样例覆盖新手关心的大部分场景场景示例文件环境变量与 step 输出02-env-and-outputs.ymlMatrix 矩阵03-matrix.ymlSecrets 与条件分支05-secrets.yml、09-conditional.ymlArtifacts 与 Cache07-artifacts.yml、08-cache.yml自定义 Actioncomposite / docker / node / wasm11-custom-actions.ymlNix 集成15-nix-flake.ymlSecrets 通过环境变量传入即可无需配置文件且会自动在日志中脱敏ACTRUN_SECRET_MY_TOKENxxx actrun workflow run .github/workflows/ci.yml进阶工具lint 与可视化跑起来之后还可以用 actrun 自带的分析命令提前发现问题# 类型检查表达式、检测未定义引用等类似 actionlint actrun lint .github/workflows/ci.yml # 画出 job 依赖图直观理解执行顺序 actrun viz .github/workflows/ci.yml --mermaid规则清单如undefined-context、circular-needs、script-injection等 20 余条详见 README.md。总结从跑通到变快装npx mizchi/actrun或npm install -g mizchi/actrun跑actrun workflow run .github/workflows/ci.yml看actrun run logs run-id快--skip-action/--retry/--affected按需裁剪actrun 的核心理念是先跑起来再谈优化本地语义与 GitHub Actions 对齐跑通即验证之后用actrun.toml固化你的本地配置把工作流从分钟级反馈提升到秒级反馈。更多契约与边界说明可查阅 public-api.md。赞分享【免费下载链接】actrunGitHub Actions compatible local runner项目地址https://gitcode.com/gh_mirrors/ac/actrun点击查看免费下载相关推荐如何在本地快速跑通Hy-SimulMTGGUF模型llama.cpp完整上手教程如何在本地快速跑通Hy SimulMTGGUF模型llama.cpp完整上手教程 Hy SimulMT 是腾讯混元推出的实时同声传译大模型支持中英双向语音大模型人工智能语音音频多模态本地部署模型量化NLP如何快速在本地跑通对抗OCRArmorOCR-GGUF llama.cpp新手入门完整教程如何快速在本地跑通对抗OCRArmorOCR GGUF llama.cpp新手入门完整教程 ArmorOCR GGUF 是 对抗OCRAdversari人工智能大模型计算机视觉OCR多模态本地部署ThermoQwen TSF社区贡献指南如何参与这个开源海洋AI项目ThermoQwen TSF社区贡献指南如何参与这个开源海洋AI项目 ThermoQwen TSF是一个基于Qwen3 1.7B大语言模型的海洋温跃层深度时间上一篇一台电脑四人开黑免费开源 Nucleus Co-Op 分屏游戏上手指南下一篇Sunshine游戏串流服务器搭建全攻略5步实现局域网低延迟畅玩PC游戏创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考