act(本地运行 GitHub Actions)

act 是一个开源命令行工具,用于在本地模拟运行 GitHub Actions 工作流。它读取仓库中的工作流配置文件,借助容器技术在本机重建运行环境并执行各个作业,让开发者在不推送代码到远程的情况下测试和调试持续集成流程。

概述

调试持续集成流程通常很痛苦:每改一处配置都要提交、推送、等待远程运行,反馈周期漫长。act 把这个循环搬到本地,它解析工作流定义,识别其中的作业、步骤和触发事件,然后拉取相应的容器镜像来模拟托管运行环境,依次执行各步骤。开发者可以指定要模拟的触发事件类型,传入自定义的事件数据和密钥,从而在本地复现远程流水线的行为。

核心特点

• 本地执行工作流:无需推送即可运行,缩短调试反馈周期。
• 基于容器模拟环境:用容器镜像近似托管运行器的环境。
• 支持事件模拟:可指定触发事件类型并提供自定义事件负载。
• 密钥与变量注入:能在本地为工作流提供所需的密钥和环境变量。
• 选择性运行:可只运行指定的作业,便于聚焦调试。

应用场景

act 主要用于开发和调试 GitHub Actions 工作流。在编写新的流水线、排查失败步骤、验证条件逻辑时,本地运行能显著提升效率。它也可用于在受限网络或需要离线的环境中初步验证流程。需要注意的是,本地容器环境与官方托管运行器并非完全一致,某些依赖特定运行器特性或外部服务的步骤可能表现不同。

常见问题

问:act 能完全等价于云端运行吗?答:不能保证完全一致。它用容器近似托管环境,但官方运行器预装的软件、硬件资源和网络条件可能与本地不同,最终仍应以云端结果为准。

问:需要安装什么前置条件?答:act 依赖容器运行时来创建模拟环境,因此本机需要具备可用的容器环境。

问:能测试所有类型的动作吗?答:大多数常见动作可以运行,但依赖特定托管特性或外部集成的步骤可能无法在本地完整复现。