文档中心

持续交付

最佳实践

通过流水线实现 Java 源码打包归档并部署至 ECS

本文为您介绍如何使用持续交付一站式流水线对 Java 源码进行编译构建并自动化部署至 ECS 实例。

场景介绍

对于主机部署应用的场景，通过持续交付流水线，可实现源码编译构建，制品仓库打包归档，ECS 推送部署一站式体验，帮助您实现 CICD 流程的自动化与合规化。

本文以 Spring Boot Hello World 代码为例，使用 Maven 进行编译构建，将制品推送至制品仓库归档，并下载产物至 ECS 实例进行部署。

前提条件

云服务器

已开通火山引擎云服务器。

已购买 ECS 实例，具体操作可参见购买方式概述。

已为每个 ECS 实例安装运维助手，具体操作可参见安装批量作业客户端。

制品仓库

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

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

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

持续交付

已开通火山引擎持续交付。

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

已创建代码源，详细操作请参见创建代码源。本文接入 Spring Boot Hello World 示例代码源。

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

操作步骤

步骤一：创建流水线

登录持续交付控制台。

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

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

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

步骤二：流程编排

配置代码源。

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

在弹出的配置输入源页面，选择您的代码仓库类型、代码仓库和默认分支。配置完成后，单击确定。

配置 Java 编译构建任务。

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

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

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

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

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

配置项	说明
步骤名称	默认为制品上传。本示例保持默认。
地域	选择制品仓库所在的地域。
实例	选择制品仓库的实例名称。
仓库地址	选择要上传的目标仓库。仅支持选择非只读策略的 Generic 制品格式仓库。
制品文件路径	填写制品上传后，存储在制品仓库中的目标路径。本示例为/，表示存储至根目录。
制品名称	自定义制品仓库中归档的文件名称，本示例为webapp-$(PIPELINERUN_ID).jar。
是否上传单文件	本示例上传一个 .jar 包，不希望被压缩，故开启该开关。
打包路径	填写 Java 编译构建产物的文件路径。本示例为/workspace/target/demo-0.0.1-SNAPSHOT.jar。
失败时跳过	开启后当前步骤运行失败直接跳过。本示例不开启。

高级设置保持默认。

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

配置 ECS 部署任务。

删除模板中原本的应用部署阶段，在 Java 编译构建后新增阶段，并添加部署 > ECS 运维任务。

按要求配置当前任务，表格中未提及的配置项保持默认。配置完成后，单击确定。

配置项	说明
上游任务	展示当前任务的上游串行任务名称。本示例为 Java 编译构建。
制品下载	支持选择上游制品上传步骤构建的制品，制品会被下载到您配置的文件路径。本示例配置的文件路径为/tmp/demo.jar。
地域	选择 ECS 实例所在的地域。
ECS 实例	选择要进行部署的 ECS 实例，支持批量勾选。注意 ECS 实例需要安装运维助手，否则会导致任务失败。
执行路径	填写命令执行路径，对于 Linux 实例，默认在/home目录下。
执行用户	您可以指定以某个实例中存在的用户执行命令。建议避免使用 root 用户，以降低安全风险。注意请指定拥有执行命令权限的用户。
超时时间	设置命令在每个实例上执行的超时时间，执行超时后，将判断该任务在对应实例上执行失败。本示例为 5 分钟。
命令类型	选择要执行的命令类型，本示例使用 Shell。
命令内容	输入希望在 ECS 实例中运行的脚本。本示例脚本如下： #!/bin/bash # 应用程序配置变量 APP_NAME="demo" APP_JAR_PATH="/home/webapp/${APP_NAME}.jar" APP_PID_PATH="/home/webapp/${APP_NAME}.pid" NEW_APP_JAR="/tmp/${APP_NAME}.jar" APP_LOG_PATH="/home/webapp/${APP_NAME}.log" mkdir -p /home/webapp/ # 检查新旧jar文件是否存在 if [ ! -f "${NEW_APP_JAR}" ]; then echo "New application artifact not found!" exit 1 fi if [ -f "${APP_JAR_PATH}" ]; then echo "Check current application artifact" ls -al /home/webapp/ else echo "Current application artifact not found!" fi echo "Check new application artifact" ls -al /tmp # 停止应用程序 echo "Stopping the application..." # 执行springboot优雅退出 if [ -f "${APP_JAR_PATH}" ]; then if curl -s -o /dev/null -X POST http://localhost:8080/actuator/shutdown; then echo "Shutdown request sent successfully." echo "Application has been stopped." # 删除旧的jar文件 echo "Removing the old jar file..." rm -f ${APP_JAR_PATH} else echo "Failed to send shutdown request." fi else echo "Skip Stopping." fi if [ $? -eq 0 ]; then echo "Old jar file removed successfully." else echo "Failed to remove old jar file." exit 1 fi # 替换新的jar文件 echo "Replacing with the new jar file..." cp ${NEW_APP_JAR} ${APP_JAR_PATH} if [ $? -eq 0 ]; then echo "New jar file copied successfully." else echo "Failed to copy new jar file." exit 1 fi # 启动应用程序 echo "Starting the application..." nohup java -jar ${APP_JAR_PATH} > ${APP_LOG_PATH} 2>&1 & echo $! > ${APP_PID_PATH} echo "Application started." echo "Deployment complete."