讲师中心 微信公众号
AI工具推荐 视频效率加速

GitLab CI 中 Maven 构建产物跨阶段传递的正确实践

夏宇同学_5390

夏宇同学_5390

发布时间:2026-10-01 09:51:49

|

889人浏览过

|

来源于php中文网

原创

GitLab CI 中 Maven 构建产物跨阶段传递的正确实践

本文详解如何在 GitLab CI 流水线中可靠传递 Maven 构建产物(如 *-exec.jar)至后续 Docker 构建阶段,解决因工作目录隔离导致的 lstat /target: no such file or directory 错误。核心在于显式声明 artifacts 并合理配置路径。

本文详解如何在 gitlab ci 流水线中可靠传递 maven 构建产物(如 *-exec.jar)至后续 docker 构建阶段,解决因工作目录隔离导致的 lstat /target: no such file or directory 错误。核心在于显式声明 artifacts 并合理配置路径。

在 GitLab CI 中,每个 job 默认运行在独立的临时容器环境中,彼此之间不共享文件系统。这意味着 maven-build 阶段生成的 target/ 目录(含可执行 JAR)不会自动出现在 docker-build 阶段的工作目录里——这正是报错 lstat /var/lib/docker/tmp/.../target: no such file or directory 的根本原因。GitLab 不会自动“猜”你要传递哪些构建产物;必须通过 artifacts 显式声明并持久化。

✅ 正确做法:在 maven-build job 中明确定义 artifacts,将目标 JAR 文件作为制品上传:

maven-build:
  image: maven:3.6.3-jdk-8
  stage: build
  script: "mvn $MAVEN_CLI_OPTS clean deploy -e"
  artifacts:
    paths:
      - target/*-exec.jar  # ✅ 推荐:相对路径,更安全(无需 $CI_PROJECT_DIR)
    expire_in: 1 week       # 可选:自动清理过期制品

⚠️ 注意事项:

Git Worktree
Git Worktree

Git Worktree 多需求并行开发助手:在当前 worktree 目录独立开发、修改、提交代码,不跨目录。基于目录命名规范自动识别仓库归属(如 main-repo-feature‑a → main‑repo 仓库)。遵循最小改动原则,从需求分析到 commit 交付全流程负责。触发场景:用户在 ...

下载
  • 路径必须为相对路径:artifacts.paths 中应使用 target/xxx.jar 而非绝对路径 $CI_PROJECT_DIR/target/xxx.jar。GitLab 会自动在当前 job 工作目录下查找。
  • 通配符需谨慎:*-exec.jar 依赖项目实际输出命名(如 hello-spring-boot-exec.jar)。若不确定,可先用 ls -l target/ 在 script 中调试,或改用精确名称 target/hello-spring-boot-exec.jar。
  • Dockerfile 同步更新:确保 Dockerfile 中 COPY 指令与实际产物名一致:
    FROM openjdk:8-jre-slim
    COPY target/hello-spring-boot-exec.jar /app.jar  # ✅ 与 artifacts 和 mvn 输出严格匹配
    ENTRYPOINT ["java", "-jar", "/app.jar"]
    EXPOSE 7001

? 进阶优化建议:

  • 启用 needs 显式依赖(GitLab 12.2+):避免隐式阶段顺序,提升可读性与调试效率:
    docker-build:
      stage: package
      needs: ["maven-build"]  # ✅ 明确声明依赖关系
      script:
        - docker info
        - docker build -t gitlab.my-domain.local:5000/spring-boot-hello-world:$CI_COMMIT_TAG .
        - docker push gitlab.my-domain.local:5000/spring-boot-hello-world:$CI_COMMIT_TAG
  • 镜像标签语义化:避免硬编码 latest,改用 $CI_COMMIT_TAG 或 $CI_COMMIT_SHORT_SHA,保障可追溯性与生产稳定性(参考《Docker 标签命名规范》)。
  • 安全加固:docker-build job 应使用 docker:dind(Docker-in-Docker)服务而非仅 image: docker:stable,并启用 TLS(推荐 docker:24.0.0-dind + DOCKER_TLS_CERTDIR)。

总结:GitLab CI 的制品传递不是“默认行为”,而是需主动设计的契约。artifacts 是连接构建与打包阶段的桥梁——缺失它,Docker 构建便成了无源之水。从今天起,请把 artifacts 视为 Java 容器化流水线的必需字段,而非可选项。

热门AI工具

更多
切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
Java Maven专题
Java Maven专题

本专题聚焦 Java 主流构建工具 Maven 的学习与应用,系统讲解项目结构、依赖管理、插件使用、生命周期与多模块项目配置。通过企业管理系统、Web 应用与微服务项目实战,帮助学员全面掌握 Maven 在 Java 项目构建与团队协作中的核心技能。

3100

2025.09.15

Java Maven/Gradle 构建与依赖管理合集
Java Maven/Gradle 构建与依赖管理合集

系统讲解 Java 项目构建工具的使用与进阶配置,涵盖 Maven 的 POM 文件结构、生命周期(clean/compile/package/install/deploy)与插件机制、依赖范围(compile/provided/test/runtime)与传递依赖管理、多模块聚合与继承、私有 Nexus 仓库发布,以及 Gradle 的 Groovy / Kotlin DSL 语法、Task 自定义与增量构建、依赖版本目录(Versi

329

2026.05.09

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

0

2026.09.30

LLVM RISC-V参数配置教程
LLVM RISC-V参数配置教程

本专题介绍LLVM对RISC-V基础ISA和扩展的支持方式,涵盖RV32、RV64、标准扩展、实验性扩展、厂商扩展、-menable-experimental-extensions和版本差异。

0

2026.09.30

LLVM IR中间表示入门指南
LLVM IR中间表示入门指南

本专题整理LLVM IR的核心概念,包括中间表示作用、模块结构、函数、基本块、SSA形式、类型系统和常见语法,帮助新手理解LLVM编译流程中的关键层。

0

2026.09.30

PDF转图片方法
PDF转图片方法

需要把 PDF 页面用于上传、预览、分享或图片归档时,PDF 转图片方法专题整理 JPG/PNG 格式选择、逐页导出、清晰度设置、批量下载和结果检查等流程,帮助用户稳定完成 PDF 图片化处理。

0

2026.09.30

PixTV AI视频生成与无限画布创作
PixTV AI视频生成与无限画布创作

PixTV专题整理AI视频与视觉内容创作相关功能使用教程,涵盖AI生图、视频生成、无限画布、多模型创作、素材管理、声音音乐及视频剪辑等功能,帮助用户快速掌握PixTV从创意到成片的完整制作方法。

0

2026.09.29

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

200

2026.09.23

Buffalo框架路由与请求处理实操指南
Buffalo框架路由与请求处理实操指南

本专题讲解Buffalo框架路由与请求处理机制,涵盖路由注册与分组、资源路由、Handler编写规范、Context上下文方法、参数绑定、中间件编写挂载、Session与Cookie读写、Flash消息及错误页面定制方法。

120

2026.09.23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
vscode手册
vscode手册

共0课时 | 0人学习

Git 教程
Git 教程

共21课时 | 7.9万人学习

Git版本控制工具
Git版本控制工具

共8课时 | 1.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn