跳至主要内容

配置并运行 Pipeline

翻譯正在進行中本指南目前僅提供簡體中文版本，其他語言版本將在後續補充。

打开 App 详情，点击 Pipeline，选择要操作的 Deployment Environment。Repository、Deployment Configuration 和 Cluster 必须已经就绪。

1. 配置阶段​

点击 Configure Pipeline。推荐生产流水线：

BUILD_IMAGE → TEST_GATE → DEPLOY_K8S

Docker 环境最后一段使用 DEPLOY_DOCKER。

阶段行为
Build Image拉取发布分支，执行源码构建并生成镜像制品
Test Gate人工检查点；Approve 后继续，Reject 后本次发布失败
Deploy to K8S等待用户点击 Deploy，再应用 K8S 资源
Deploy to Docker等待用户点击 Deploy，再在 Docker Host Group 中发布
配置 Pipeline 阶段展示 Pipeline Name、Build Image、Test Gate、Deploy 阶段的新增、排序、命名与保存。images/spark-pipeline-stages-01.webp
截图待补充

Deploy 前必须存在 Build Image，且 Build 必须排在 Deploy 之前。环境绑定 K8S 时使用 Deploy to K8S，绑定 Docker 时使用 Deploy to Docker。

2. 配置 Build Settings​

点击 Build Settings：

  • Build Context Path：仓库相对路径，默认 .。
  • Build Command：镜像构建前的源码构建命令。
  • Effective Build Images：展示继承后实际使用的 Git Clone、Builder、Kaniko 镜像。
  • Description：记录特殊构建约定。

Dockerfile Path 和 Image Repository 在当前界面中由所选环境的 Deployment Configuration 统一维护，不需要在 Build Settings 重复填写。

默认行为：

  • Java：mvn -DskipTests package
  • Python：通常由 Dockerfile 安装依赖并构建，Build Command 可只做必要的预处理
  • Node.js Dockerfile：源码构建由 Dockerfile 负责
  • Node.js Managed NPM Build：由 Spark Node.js 构建插件执行 NPM/Yarn/PNPM
Pipeline Build Settings展示 Build Context、Build Command 和继承后的 Git Clone、Builder、Kaniko 镜像。images/spark-pipeline-build-settings-02.webp
截图待补充

3. 添加 Release Branch​

Pipeline 只构建 Release Channel 中处于 Active 状态的分支。点击 Quick Add Branch：

  • Link Existing Branch：从仓库选择已有分支。
  • Create Branch：从 Source Branch 创建一个新分支并加入 Release Channel。
  • 填写 Title 和可选 Description。
添加 Release Branch展示 Link Existing Branch / Create Branch、分支搜索、Source Branch、Title 和保存中状态。images/spark-pipeline-release-branch-03.webp
截图待补充

一个环境可同时有多个 Active Release Branch。启动时 Spark 会使用当前 Release Channel 生成本次发布来源；正式发布前应退出不再需要的临时分支，降低合并歧义。

4. 启动构建​

点击 Start Build。一次运行会创建独立 Release Order，并记录：

  • 运行编号和状态
  • 来源分支与源代码提交
  • 每个阶段的状态和进度
  • 构建日志与镜像制品
  • 部署快照和事件审计

同一个 App Environment 同时只能有一条活动运行。发现确实失去执行状态的旧运行时，界面可能提供强制重新开始；先查看日志和集群任务，避免把正常的慢构建误判为卡死。

5. 通过 Test Gate​

Build Image 成功后，Test Gate 进入 Waiting Approval：

  1. 打开 Build Logs，确认构建和镜像推送成功。
  2. 在测试环境执行冒烟、自动化或人工验收。
  3. 点击 Approve 继续；点击 Reject 终止本次 Release Order。

Test Gate 当前是人工检查点，不会自动执行测试脚本。需要自动测试时，应先把测试放入可重复的 Build Command/Dockerfile 流程，或等待后续独立自动测试阶段能力。

6. 手工确认 Deploy​

通过 Gate 后，Deploy 阶段进入 Waiting Deploy，不会自动修改运行环境。点击 Deploy 才开始发布。

  • K8S：生成 Deployment、Service 等资源并应用，持续观察进度。
  • Docker：按 Batch Size 在 Host Group 中启动容器，并执行健康检查。
  • 已成功的部署阶段可以 Redeploy。
  • 运行中或失败的部署可按界面提供的 Stop/Retry 操作恢复。
Gate 审批与手工部署展示 Waiting Approval 的 Approve/Reject，以及 Waiting Deploy 的 Deploy、进度和日志。images/spark-pipeline-gate-deploy-04.webp
截图待补充

7. Release History​

Release History 提供 Latest、Successful、All 视图。点击 Details 可查看：

  • Docker image 或其他发布制品
  • K8S Manifest / Docker Command 快照
  • 实际应用的资源名与部署日志
  • Release Event 时间线和操作人
Release History 与详情展示发布编号、状态、分支、镜像、部署快照、事件、日志和 Rollback。images/spark-pipeline-release-history-05.webp
截图待补充

8. 重试、取消和回滚​

  • Cancel Run：取消 Pending、Running、Waiting Approval 或 Waiting Deploy 的当前运行。
  • Retry Build：失败的 Build Image 可以在同一 Release Order 中重试。
  • Retry Docker Deploy：失败的 Docker Deploy 可以重试。
  • Redeploy：重新发布当前成功制品。
  • Rollback：从成功历史选择旧制品，创建一条新的回滚发布记录并重新部署；不会改写历史记录。

回滚恢复的是已记录制品和部署快照，不会回退 Git 分支。完成后仍应修复源码或配置并产生新的正常发布。

9. 发布前检查表​

  • Release Channel 只保留本次要发布的分支。
  • Dockerfile 和 Build Context 路径有效。
  • Build Command 在无交互环境中可执行。
  • 镜像仓库账号具备 push/pull 权限。
  • 端口、健康检查、资源和环境变量已核对。
  • Test Gate 的验证范围与负责人明确。
  • PROD 部署前已经验证回滚制品和运维观察入口。
最後於 更新