📌 项目地址: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 个人在改它。大多数人来这里只是查东西。我认为它对普通开发者的实际用途就两个半:

  1. 查软件版本。CI 昨天还好好的,今天红了,先来这看镜像里的工具链是不是升级了。
  2. 提 issue。请求预装新软件,或者报告某次镜像更新搞坏了你的构建。
  3. (半个)自建镜像。仓库里有一份从源码构建 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 环境是什么样,答案全在里面。

这篇文章对你有帮助吗?

发表回复