Skip to content

部署工作流

工作流完成画布校验和试运行后,可部署为生产运行版本。部署用于生成可供业务系统调用的生产版本;发布用于把已经部署的项目发布到当前账号可用的渠道。发布不会代替工作流接口接入,也不会自动完成调用方改造。

部署前验证

  • 开始节点的输入参数名称、类型、必填规则和示例值正确。
  • 所有节点连接完整,条件分支既覆盖命中场景,也覆盖未命中场景。
  • 模型、插件、数据库和外部接口在测试环境中可以正常调用。
  • 结束节点输出字段固定,失败分支不会返回无法识别的结构。
  • 使用正常、边界、缺失字段和外部服务失败等输入完成试运行。
  • 保存画布后,记录已经通过验证的版本。

配置并开始部署

  1. 单击项目右上角的 部署
  2. 选择已经完成试运行的部署版本。
  3. 设置 CPU 和内存规格。
  4. 根据工作流依赖选择数据库表、生产环境变量和对象存储同步范围。
  5. 单击 开始部署,等待打包、构建和部署完成。
  6. 部署失败时展开部署日志,先定位失败阶段,再修改和重新部署。

工作流使用的生产环境变量应与开发环境分开配置。外部接口地址、访问令牌或数据库连接信息不能写入节点说明、需求文本或截图。

工作流部署配置页面

图 1:工作流部署配置页面。选择部署版本和资源规格,并根据项目实际依赖配置数据库、生产环境变量和对象存储。

部署页面功能

页面区域作用检查要点
总览选择版本、配置资源并发起部署部署版本必须是已经保存并完成试运行验证的版本
日志查看构建、启动和运行日志部署失败时先根据时间和错误阶段定位原因
分析查看当前项目的运行分析数据结合实际业务量观察耗时和异常趋势
Trace查看一次工作流调用经过的节点与耗时重点核对分支选择、节点输入输出和错误节点
用量管理查看部署资源和调用用量根据持续运行情况判断是否需要调整规格

部署配置中的主要字段包括:

  • 部署版本:选择本次要上线的 Git 版本。重新部署不会自动采用尚未保存的画布修改。
  • 资源规格:设置 CPU 和内存。先使用满足验证需要的规格,再根据日志、分析和实际调用量调整。
  • 数据库:项目使用数据库时,选择需要同步到生产环境的表;页面显示“当前项目没有数据库”时无需创建空数据库。
  • 生产环境变量:单独配置生产地址、令牌等运行参数,不复用仅适用于开发环境的值。
  • 对象存储:确实需要将开发环境对象同步到生产环境时再开启,避免把测试文件带入生产环境。

部署后验证

  1. 使用与试运行相同的输入调用生产版本。
  2. 核对结束节点的输出字段、类型和业务含义。
  3. 日志 中检查工作流执行错误。
  4. Trace 中查看节点执行顺序、输入输出、错误节点和耗时。
  5. 使用失败场景再次验证异常分支和可见错误提示。

部署成功后,部署状态应为 运行中。还应核对部署记录、Git 提交、部署时间和运行地址,确保生产运行版本与本次验证的版本一致。

调用生产工作流

部署完成后,按照部署页面提供的生产调用说明接入工作流:

  1. 使用页面提供的请求地址和鉴权方式,不要根据预览地址自行拼接生产接口。
  2. 请求参数以 开始节点 的输入定义为准,字段名称、类型和必填规则必须一致。
  3. 响应结构以 结束节点 的输出定义为准,调用方不要依赖工作流中间节点的临时字段。
  4. 将令牌放在服务端安全配置中,不要写入浏览器代码、需求文本、截图或代码仓库。
  5. 使用正常、缺少必填字段、分支未命中和外部服务失败等场景验证生产调用。

如果部署页面提供 API、SDK 或 Web SDK 等多种调用方式,应以当前页面实际显示的入口和示例为准。API/SDK 适合后端系统集成;Web SDK 仅在当前项目已开通并显示该入口时使用。

重新部署后应复测调用方。如果输出结构、字段名称或鉴权方式发生变化,还需要同步更新调用方和接口文档。

发布工作流项目

生产验证通过后,单击项目右上角的 发布

  1. 核对发布来源对应的部署状态、Git Commit、部署时间和运行地址。
  2. 填写发布版本和发布描述,并按需上传展示截图。
  3. 选择当前页面显示为“可发布”的渠道并提交。
  4. 在发布历史中检查渠道、状态、版本和发布时间。
工作流发布页面

图 2:工作流发布页面。上方展示正在运行的部署来源,下方填写版本信息、展示截图并选择发布渠道。

发布页面各区域的含义如下:

  • 发布来源:展示部署记录、部署状态、Git 提交、部署时间和运行地址。只有来源状态正常且版本正确时才继续发布。
  • 版本信息:填写本次发布版本和更新说明,版本号应与团队发布记录保持一致。
  • 展示截图:最多上传三张,用于发布后的项目展示;不是工作流运行日志或接口响应附件。
  • 发布渠道:仅显示当前账号和项目可用的渠道。若显示“暂无可用发布渠道”,先检查该渠道是否已经发布、账号权限及渠道条件,不要重复提交。
  • 发布历史:核对渠道、状态、版本和发布时间,确认目标版本已经上线。
工作流发布渠道和发布历史

图 3:发布渠道和发布历史。示例中企业项目的 v0.0.1 已上线;当前没有新的可用发布渠道。

“发布项目”用于分发已部署的项目资产,不会代替工作流生产接口的接入和调用方回归验证。需要给其他系统调用时,以部署页面提供的生产 API 或 SDK 为准;需要在可用渠道中展示和分发项目时,再执行发布。