CI/CD / 系统课时

选择 Runner 与运行环境

选择 Runner 与运行环境

Runner 是实际执行 GitHub Actions Job 的机器。选择 ubuntu、windows 或 macos 不只是语法差异,它会直接影响可用 Shell、文件路径、工具链和构建结果。本篇聚焦 GitHub-hosted Runner,学会根据项目依赖选择合适的运行环境并验证选择是否正确。

学习目标

  • 理解 Runner 与 Job 之间的运行关系
  • 根据操作系统和工具链要求选择 GitHub-hosted Runner
  • 能通过工作流验证 Runner 的系统与预装工具环境

Runner 决定 Job 在哪里执行

每个 Job 都需要运行环境,runs-on 用来指定 Runner 标签。GitHub-hosted Runner 由 GitHub 提供和维护,常见选择包括 ubuntu-latest、windows-latest 与 macos-latest。

Job 被调度到 Runner 后,其中的 Step 都在这个 Job 对应的运行环境中执行。因此,操作系统相关的 Shell、路径规则和系统工具都要以 Runner 为准,而不是以开发者自己的电脑为准。

Job 调度到不同 GitHub-hosted Runner 的运行关系

如果项目只是运行跨平台的 Node.js 单元测试,Ubuntu 往往就能满足需求;如果必须构建依赖 Windows 的程序,则应选择 Windows;需要 Xcode 等 Apple 平台工具链时,则需要 macOS Runner。真正的选择条件是任务依赖,而不是个人日常使用哪个系统。

用工作流验证运行环境

下面建立三个 Job,让同一条 workflow 分别运行在 Ubuntu、Windows 和 macOS。每个 Job 使用适合该环境的命令输出系统信息。

yaml
name: runner-demo

on:
  workflow_dispatch:

jobs:
  linux:
    runs-on: ubuntu-latest
    steps:
      - name: Show Linux environment
        run: |
          uname -s
          node --version

  windows:
    runs-on: windows-latest
    steps:
      - name: Show Windows environment
        shell: pwsh
        run: |
          [System.Environment]::OSVersion.Platform
          node --version

  macos:
    runs-on: macos-latest
    steps:
      - name: Show macOS environment
        run: |
          uname -s
          node --version

把文件保存为 .github/workflows/runner-demo.yml 并推送后,可以在 Actions 页面手动触发 runner-demo。三个 Job 没有通过 needs 建立依赖,因此可以分别被调度执行。

预期输出

text
linux:   Linux + Node.js 版本
windows: Win32NT + Node.js 版本
macos:   Darwin + Node.js 版本

Node.js 的具体版本属于 Runner 镜像中的动态环境,因此这里不固定版本号。验证重点是三个 Job 分别识别为 Linux、Windows 和 Darwin/macOS 环境,并且能够找到 Node.js。

latest 标签与工具版本不是一回事

ubuntu-latest 这类标签表示 GitHub 当前映射的受支持 Runner 镜像,并不意味着其中每个工具都是你项目想要的版本。依赖特定 Node.js、Python 或 Java 版本时,不应仅依赖镜像预装内容,而应在 workflow 中显式设置所需工具链版本。

操作系统版本同样可能影响原生依赖、编译器和系统库。如果项目对系统版本存在硬性要求,应查看当前 GitHub-hosted Runner 提供的有效标签与镜像说明,而不是根据旧日志猜测。

用需求反推 Runner

选择 Runner 时可以依次检查三个问题:任务是否依赖特定操作系统;是否需要该系统专属的 SDK 或构建工具;是否存在原生依赖或脚本只能在某个平台执行。如果三个答案都是否,优先选择能够稳定完成任务且配置简单的环境即可。

跨平台项目则可以把不同操作系统拆成多个 Job,分别运行测试。这样 Runner 的选择就成为可验证的兼容性边界:某个平台失败时,可以直接定位对应 Job,而不必把多个系统条件混进同一个执行环境。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

选择 Runner 与运行环境

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通