解决nektos/act中自托管Runner检测错误的问题

在使用nektos/act工具模拟GitHub Actions工作流时，用户可能会遇到一个常见问题：工具错误地将GitHub官方支持的Runner镜像识别为自托管(self-hosted)Runner。这个问题通常出现在使用ARM架构的机器上运行act时。

问题现象

当用户使用ubuntu-latest或ubuntu-22.04等GitHub官方支持的Runner配置时，act工具会输出错误信息，提示当前Runner被检测为自托管Runner。错误信息会建议用户手动安装Ruby等工具，但实际上用户期望的是使用GitHub官方提供的预配置环境。

问题原因

这个问题的根本原因在于架构不匹配。GitHub官方提供的Runner镜像是基于x86_64(amd64)架构构建的，而用户在ARM64(aarch64)架构的机器上运行act时，工具无法正确识别官方Runner镜像。

解决方案

解决这个问题的方法很简单：通过--container-architecture参数强制指定使用amd64架构的容器。具体命令如下：

act --container-architecture linux/amd64

这个参数会告诉Docker使用amd64架构的镜像，即使宿主机器是ARM架构。这样就能正确匹配GitHub官方支持的Runner镜像配置。

深入理解

nektos/act工具的核心功能是在本地模拟GitHub Actions的执行环境。它通过Docker容器来实现这一目标。当工作流中指定runs-on: ubuntu-latest时，act会尝试拉取对应的Docker镜像来创建执行环境。

GitHub官方维护的Runner镜像只提供了amd64架构的版本。当用户在ARM架构的机器上运行act时，Docker默认会尝试寻找ARM架构的镜像，导致无法找到官方镜像而回退到自托管模式。

最佳实践

对于使用ARM架构开发机的用户，建议：

1. 始终在运行act时添加--container-architecture linux/amd64参数
2. 可以将此参数设置为默认配置，避免每次手动输入
3. 确保使用的Docker镜像支持多架构或明确指定amd64版本

通过这种方式，用户可以在ARM架构的机器上获得与GitHub Actions官方环境一致的执行体验，确保本地测试与云端执行结果的一致性。