📌 项目地址:actions/runner-images | ⭐ 13,249 颗星 | 🔧 PowerShell | 📜 未标注
项目地址:actions/runner-images | ⭐ 13,249 | 主要语言 PowerShell
先说清楚它是什么
你在 workflow 里写下 runs-on: ubuntu-latest,GitHub 就会开一台虚拟机来跑这个 job。这台机器装了哪个版本的 Node、Python、Docker、Android SDK,全部由 actions/runner-images 这个仓库定义。它是 GitHub-hosted runners 使用的 VM 镜像的源代码,Azure Pipelines 的 Microsoft-hosted agents 也用同一套。
13k+ 的 Star 不代表有 13k 个人在改它。大多数人来这里只是查东西。我认为它对普通开发者的实际用途就两个半:
- 查软件版本。CI 昨天还好好的,今天红了,先来这看镜像里的工具链是不是升级了。
- 提 issue。请求预装新软件,或者报告某次镜像更新搞坏了你的构建。
- (半个)自建镜像。仓库里有一份从源码构建 VM 的说明(docs/create-image-and-azure-resources.md),想自己搭同样环境的 runner 可以照着做。
镜像清单里值得注意的东西
README 的 Available Images 表格是核心内容,我挑几行贴在下面:
| 镜像 | 架构 | YAML Label |
|---|---|---|
| Ubuntu 24.04 | x64 | ubuntu-latest 或 ubuntu-24.04 |
| Ubuntu 24.04 Arm64 | arm64 | ubuntu-24.04-arm |
| Ubuntu 26.04 | x64 | ubuntu-26.04 |
| Xcode 27 | arm64 | xcode-27 或 xcode-27-xlarge |
| macOS 26 Arm64 | arm64 | macos-latest、macos-26 或 macos-26-xlarge |
| macOS 26 | x64 | macos-26-intel、macos-26-large |
| Windows Server 2025 | x64 | windows-latest、windows-2025 或 windows-2025-vs2026 |
| Windows 11 Arm64 | arm64 | windows-11-arm |
| Ubuntu Slim | x64 | ubuntu-slim |
几个容易漏看的细节:
ubuntu-slim:预装软件更少的精简版 Ubuntu。启动快,依赖自己装,适合不想要一堆没用工具链的团队。- Arm 版已经铺满三条产品线:Ubuntu、macOS、Windows 11 都有 arm64 变体。macOS 这边,
macos-latest现在指向的是 Arm 版。 -large和-xlarge后缀只属于 macOS 镜像,而且只在 GitHub Actions 的 larger runners 里可用,Azure Pipelines 用户碰不到。- 表格里有些条目直接挂着 issue 链接(比如 macOS 14 指向 #13518),那是镜像下线公告。选 OS 版本前先看一眼,别踩在快退役的系统上。
-latest 标签的迁移规则
README 写得很明确:-latest 指向最新的 GA 版本;切换到新 OS 之前,官方会公告并留出足够的迁移时间。
规则归规则,我的建议是生产 workflow 里写死版本,比如 ubuntu-24.04 而不是 ubuntu-latest。标签一迁移,latest 的行为就变了,你的构建可能跟着变。想提前知道什么时候迁移,盯住仓库 README 的 Announcements 部分和 Image Releases 记录。
为什么主要语言是 PowerShell
这个仓库要同时生成 Windows 和 Linux/macOS 的镜像。PowerShell 本身跨平台,一套脚本逻辑能覆盖两边,选它不奇怪。每类镜像的完整预装软件清单放在仓库对应目录下(比如 ubuntu-24.04、macOS-26-arm64 各有一个),排查 CI 环境问题时,这就是第一手资料,别去搜博客,博客里的版本列表早就过时了。
参与方式
README 有一节 “How to Interact with the Repo”,规定了怎么和这个仓库打交道。日常操作就是提 issue:请求预装新软件(写清版本号和理由)、报告软件升级导致的 CI 故障、反馈镜像 bug。Software and Image Support 一节说明了支持政策,旧镜像会跟随 OS 生命周期逐步下线。
一句话总结:如果你天天用 GitHub Actions,这个仓库值得收藏。它不提供任何工具,但你的 CI 环境是什么样,答案全在里面。