如何基于GitLab CI实现自定义构建依赖构件的存储？

核心思路 #

直接用GitLab的通用包注册表（Generic Packages Registry）来存QT这类自定义构建的库文件就行。它支持自定义命名、版本标签，完全和流水线解耦，刚好能满足你指定构件、不存在就生成、复用构件的需求。

具体实现步骤 #

1. 先定好构件标识规则 #

先给构件搞个清晰的命名+版本规则，比如沿用你之前的习惯：qt6-static-<commit-hash>-<platform>，或者简单点用qt6-static-v1.0，确保能通过CI变量精准找到对应的构件。

2. 流水线分三个阶段设计 #

分成检查构件是否存在、生成并上传构件（按需）、用构件编译代码三个核心阶段，直接上yaml示例：

阶段1：检查构件是否存在

加个job，用GitLab API查通用包注册表有没有指定构件，输出环境变量给后续job判断：

check_artifact:
  stage: prepare
  script:
    - |
      ARTIFACT_NAME="QT6.static.tar.gz"
      ARTIFACT_VERSION="$CI_ARTIFACT_VERSION" # 这个变量可以触发流水线时手动指定
      RESPONSE=$(curl --header "PRIVATE-TOKEN: $CI_JOB_TOKEN" "$CI_API_V4_URL/projects/$CI_PROJECT_ID/packages/generic/$ARTIFACT_NAME/$ARTIFACT_VERSION")
      if echo "$RESPONSE" | grep -q "404"; then
        echo "构件不存在，接下来会触发构建"
        echo "ARTIFACT_EXISTS=false" >> build.env
      else
        echo "构件已存在，跳过构建步骤"
        echo "ARTIFACT_EXISTS=true" >> build.env
      fi
  artifacts:
    reports:
      dotenv: build.env

阶段2：生成并上传构件（仅当构件不存在时跑）

这个job依赖上面的检查结果，只有构件不存在才执行，包含自定义构建QT和上传的步骤：

build_and_upload_artifact:
  stage: build_artifact
  needs: [check_artifact]
  rules:
    - if: $ARTIFACT_EXISTS == "false"
  script:
    # 替换成你实际的QT自定义构建命令
    - ./configure_qt.sh --static
    - make -j$(nproc)
    - tar -czf QT6.static.tar.gz ./qt-build-output
    
    # 上传到GitLab通用包注册表
    - |
      ARTIFACT_NAME="QT6.static.tar.gz"
      ARTIFACT_VERSION="$CI_ARTIFACT_VERSION"
      curl --header "PRIVATE-TOKEN: $CI_JOB_TOKEN" \
           --upload-file QT6.static.tar.gz \
           "$CI_API_V4_URL/projects/$CI_PROJECT_ID/packages/generic/$ARTIFACT_NAME/$ARTIFACT_VERSION"

阶段3：拉取构件并编译项目

不管构件是本来就有还是刚生成的，这个job都要拉取构件，然后编译你的C++代码：

compile_project:
  stage: compile
  needs: [check_artifact, build_and_upload_artifact]
  script:
    # 拉取指定构件
    - |
      ARTIFACT_NAME="QT6.static.tar.gz"
      ARTIFACT_VERSION="$CI_ARTIFACT_VERSION"
      curl --header "PRIVATE-TOKEN: $CI_JOB_TOKEN" \
           --output QT6.static.tar.gz \
           "$CI_API_V4_URL/projects/$CI_PROJECT_ID/packages/generic/$ARTIFACT_NAME/$ARTIFACT_VERSION"
    - tar -xzf QT6.static.tar.gz
    
    # 用拉取的QT库编译你的项目
    - cmake . -DCMAKE_PREFIX_PATH=./qt-build-output
    - make -j$(nproc)

3. 变量配置 #

在GitLab项目的Settings > CI/CD > Variables里加个CI_ARTIFACT_VERSION变量，或者触发流水线时手动指定，比如提交代码时用git push -o ci.variable="CI_ARTIFACT_VERSION=custom-1.1"，这样就能灵活切换要使用的构件版本。

为啥这个方案比你试过的靠谱 #

• 对比容器注册表：不用把构件打包成镜像，直接存原始压缩包，更轻量化，避免镜像层缓存的复杂逻辑；
• 对比Git LFS：不占仓库存储空间，也不用处理LFS的拉取、版本关联问题，构件和代码仓库完全解耦；
• 对比流水线构件：通用包注册表的构件不绑定生成它的流水线，只要知道名称和版本就能拉取，完全符合你指定构件的需求。

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