通过流水线实现 Java 源码打包归档和托管应用部署

本文为您介绍如何通过一站式流水线对 Java 源码进行编译构建，归档构建产物 JAR 包，并完成 Java 托管应用的自动化 Kubernetes 部署。

场景介绍

通过持续交付的一站式流水线，可完成 Java 项目的编译构建、制品归档和自动化 Kubernetes 部署工作。

• 上传制品：持续交付与火山引擎的制品仓库无缝集成，支持将编译构建的产物上传至制品仓库进行归档。

• Java 应用托管：持续交付提供 Java 应用托管功能，支持通过传统的 JAR 包方式完成 Java 应用的容器化部署。

• 应用部署：持续交付的流水线与应用交付模块相互联动，支持通过流水线完成 Java 托管应用的自动化部署。

前提条件

• 制品仓库

  • 已开通火山引擎制品仓库。

    说明

    制品仓库当前处于公测状态，如需体验，请优先联系您的售前经理或解决方案经理。

  • 已创建制品仓库实例。具体操作可参见 创建基础版实例。

  • 已创建 Generic 制品格式仓库，且仓库的发布策略要求为非只读策略。 具体操作可参见 创建 Generic 仓库。

• 持续交付

  • 已创建工作区，详细操作请参见 创建工作区。

  • 已创建代码源，详细操作请参见 创建代码源。

  • 已准备好待部署的 Java 托管应用。详细操作请参见 创建和部署托管应用（JAR /WAR）。

  • 首次使用制品上传，需完成跨服务授权。具体操作可参见 跨服务授权。

操作步骤

步骤一：创建流水线

1. 登录 持续交付控制台。

2. 在左侧导航栏选择 工作区，在工作区页面单击目标工作区名称，进入当前工作区。

3. 单击 创建流水线，弹出 选择流水线模板 对话框。

4. 选择 Java - 编译构建 & 制品上传 - 应用部署，单击 确定，进入当前流水线的流程编排页面。

步骤二：流程编排

1. 配置代码源。

   1. 在代码源&触发器区域，单击 添加 > 代码源。

   2. 在弹出的配置输入源页面，选择您的代码仓库类型、代码仓库和默认分支。

      

   3. 单击 确定。

2. 配置 Java 编译构建&制品上传任务

   1. 单击 Java 编译构建 卡片，弹出编辑任务面板。

   2. 配置代码源下载策略。本实践对 Java 源码进行编译构建，故选择 下载代码。

   3. 在面板中配置 Java 编译构建步骤。

      

      配置项	说明
      步骤名称	默认为 Java编译构建。本示例保持默认。
      版本	根据实际选择 Java 版本。
      编译命令	根据实际业务，编写编译命令。
      失败时跳过	开启后当前步骤运行失败直接跳过。本示例不开启。

   4. 在面板中配置制品上传步骤。

      

      配置项	说明
      步骤名称	默认为制品上传。本示例保持默认。
      地域	选择制品仓库所在的地域。
      实例	选择制品仓库的实例名称。
      仓库地址	选择要上传的目标仓库。仅支持选择非只读策略的 Generic 制品格式仓库。
      制品名称	自定义制品仓库中归档的文件名称，默认为Artifact-$(PIPELINE_ID)-$(CP_STEP_NAME)-$(DATETIME).gzip。本示例保持默认。
      打包路径	填写 Java 编译构建产物所在的路径。本示例为./target/。
      是否包含打包路径的目录	是否将打包路径的目录一起上传。本示例仅包含一个打包路径，选择关闭该开关。 该开关默认关闭。当包含多个打包路径时，将强制开启，避免多个路径下存在同名文件时无法分辨。
      制品文件路径	填写制品上传后，存储在制品仓库中的目标路径。本示例为/，表示存储至根目录。
      失败时跳过	开启后当前步骤运行失败直接跳过。本示例不开启。

   5. 高级设置保持默认。

   6. 单击 确定，完成当前任务配置。

3. 配置应用部署任务。

   1. 单击 应用部署 卡片，弹出编辑任务面板。

   2. 在面板中配置应用部署任务。

      

      配置项	说明
      任务名称	默认为应用部署。本示例保持默认。
      上游任务	显示本任务的上游任务名称，本场景为 Java 编译构建。
      应用类型	选择 托管应用。
      应用	选择具体要部署的应用。
      环境	对于 Java 托管应用，一个应用仅有一个环境。将根据选择的应用自动显示部署环境。
      应用技术栈	将根据选择的应用自动显示技术栈，本场景显示为 Java。
      版本号	设置本次部署的版本号，默认使用时间戳。本示例保持默认。
      制品	选择当前应用要部署的制品。本场景选择上游编译构建&制品上传任务的产物。
      部署方案	选择 原生部署。
      超时时间	设置自动超时时间。任务运行时长超过该时间，则判断部署失败，系统自动触发回滚操作，回滚到升级前版本。本示例保持默认。
      任务输出	显示当前任务的产物。本任务没有产物。
      高级设置	是否开启 Webhook 通知。本示例不开启。

   3. 单击 确定，完成当前任务配置。

4. 可选配置流水线的基本信息、缓存目录、通知提醒。本示例保持默认。

5. 单击 保存，保存流水线当前配置。

步骤三：运行流水线

1. 在流水线列表页，选择刚才创建的目标流水线，单击操作列的运行图标。

2. 在弹出的运行流水线对话框中，确认使用的代码源分支信息，可选填写运行说明。

3. 单击 确定，流水线开始运行，系统跳转至当前流水线的详情页面。

结果验证

1. Java 编译构建&制品上传任务运行成功后，将输出制品详情地址。单击可跳转至制品仓库控制台，查看上传的制品详情。

2. 应用部署任务运行成功后，可点击查看部署详情，跳转至对应 Java 托管应用的变更记录详情页面，查看部署结果。