CI/CD / 系统课时

检出代码并准备构建环境

检出代码并准备构建环境

持续集成作业启动后,Runner 默认并没有自动准备好仓库代码和项目所需的特定语言版本。本节用官方 Action 完成代码检出和工具链安装,并通过版本命令验证环境,为后续安装依赖、测试和构建建立可靠起点。

学习目标

  • 使用 actions/checkout 将仓库内容检出到 Runner
  • 使用语言环境 Action 安装并选择项目需要的工具链版本
  • 在真正构建前验证代码目录和运行时版本

Runner 为什么还需要准备

runs-on 决定作业使用哪类 Runner,但“获得一台 Runner”与“项目已经可以构建”是两回事。CI 通常至少还要完成两个动作:把当前仓库检出到工作目录,并准备项目要求的语言或工具版本。

这两个动作最好显式写入工作流。这样构建依赖不会隐藏在 Runner 当前恰好预装的软件版本中,升级 Runner 镜像时也更容易判断环境发生了什么变化。

检出代码并安装工具链

以 Node.js 项目为例,可以组合官方维护的 actions/checkout 与 actions/setup-node。下面的工作流支持从 Actions 页面手动运行,并在准备完成后验证仓库与 Node.js 环境。

yaml
name: prepare-build-environment

on:
  workflow_dispatch:

jobs:
  prepare:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '22'

      - name: Verify environment
        run: |
          test -f "$GITHUB_WORKSPACE/.git/HEAD"
          node --version
          echo "workspace ready"

预期输出

text
v22.<VERSION>
workspace ready

<VERSION> 表示实际安装的 Node.js 22 补丁版本,可能随工具缓存和版本解析结果变化。test 成功时不会额外输出;如果仓库没有正确检出,该步骤会直接失败。

两个 Action 分别解决什么问题

actions/checkout 负责把仓库内容放入 $GITHUB_WORKSPACE,后续测试和构建命令才能读取源码、配置文件以及依赖清单。多数需要操作当前仓库文件的作业,都应先完成检出。

actions/setup-node 则负责准备指定 Node.js 版本,并让后续步骤能够直接调用 node。类似地,Java、Python 等生态应使用对应的环境准备方式,而不是假设 Runner 当前的默认版本恰好符合项目要求。

GitHub Actions 构建环境准备数据流

把版本要求写进工作流

语言版本应来自项目明确的构建约束,而不是随意使用 latest。固定主版本或更精确的版本范围,可以减少不同时间执行同一工作流时产生的环境漂移。

如果项目随后使用 npm ci,还可以根据锁文件配置依赖缓存。不过缓存属于构建优化,不应取代检出代码和选择运行时这两个基础步骤。先确保环境可重复,再优化执行速度。

验证准备阶段是否可靠

在仓库的 Actions 页面手动触发该工作流后,检查三个事实:Checkout repository 成功、Setup Node.js 成功,以及验证步骤打印 v22.<VERSION> 和 workspace ready。这比只看到作业变绿更能证明环境确实符合预期。

后续加入依赖安装、测试和打包时,应继续建立在这套显式准备过程之上。CI 的起点不是“Runner 能启动”,而是“源码和正确工具链都已到位,并且已经验证”。

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

目录与阅读设置

阅读设置

17

记录一个想法

检出代码并准备构建环境

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

登录哪都通