GitLab CI中如何为Yocto构建的Linux镜像设置版本号

环境变量方案的合理性 #

环境变量是完全可行的方案，但没必要只靠日志查看——可以通过优化实现方式，让版本号的管理和查看更高效。

具体优化实现方式 #

1. 从Git自动提取版本号（推荐） #

不用手动修改yml，直接从Git仓库的标签或提交记录生成版本号，完全自动化：

• GitLab Pipeline内置了CI_COMMIT_TAG（如果代码打了标签）和CI_COMMIT_SHORT_SHA（提交短哈希）变量，直接拿来用就行
• 在pipeline的yml里定义版本变量，再传递给Yocto：

variables:
  # 如果有标签就用标签，没有就用提交短哈希
  IMAGE_VERSION: "${CI_COMMIT_TAG:-${CI_COMMIT_SHORT_SHA}}"

build-image:
  script:
    # 告诉Yocto要传递这个环境变量
    - export BB_ENV_EXTRAWHITE="$BB_ENV_EXTRAWHITE IMAGE_VERSION"
    - source poky/oe-init-build-env
    - bitbake your-target-image

然后在Yocto的配置里把版本号嵌入镜像，比如修改build/conf/local.conf，把版本号写入/etc/os-release：

IMAGE_FEATURES += "os-release"
OS_RELEASE_VERSION = "${IMAGE_VERSION}"

这样镜像生成后，/etc/os-release里就会包含对应的版本号，全程不用手动维护版本值。

2. 把版本号存为构建产物，方便查看 #

构建完成后，把版本号写入一个单独的文本文件，上传到GitLab Artifacts里，不用翻日志就能直接下载查看：

build-image:
  script:
    # ... 前面的构建步骤 ...
    - echo "${IMAGE_VERSION}" > image-version.txt
  artifacts:
    paths:
      - image-version.txt
      - build/tmp/deploy/images/your-target-image.img

之后在GitLab的Pipeline页面，直接从Artifacts里下载image-version.txt就能看到版本号，非常方便。

3. 手动指定版本号但不修改yml #

如果需要手动指定特定版本号，用GitLab Pipeline的手动触发变量就行：

• 触发Pipeline时，在页面上手动输入IMAGE_VERSION的值
• yml里只需要定义默认值，不用每次修改：

variables:
  IMAGE_VERSION: "v1.0.0" # 默认版本号

build-image:
  script:
    # ... 构建步骤 ...

这样既可以灵活指定版本，又不用频繁改动yml文件。

总的来说，环境变量是合适的方案，重点是优化版本号的生成和查看方式：

• 优先用Git自动生成版本号，减少手动操作；需要手动指定时用Pipeline手动变量，避免修改yml
• 通过Artifacts保存版本元数据，直接在GitLab页面就能查看，不用翻日志

内容的提问来源于stack exchange，提问作者Vincentz