SuperAPI AI 工具集

dx-devops-promote

部署与运维

查看项目

更新于 10-15 21:43

技能介绍

用途:驱动 DevOps Center 的完整晋升(promotion)工作流,把工作项沿发布流水线从源阶段推进到目标阶段,面向 CI 中的无头、自动化发布场景。

主要能力:校验晋升前置条件;准备工作项;将共享元数据的工作项合并为一次晋升;晋升一个或多个工作项,或整个源阶段;完成晋升。所有操作使用 sf devops CLI 命令并输出 --json,命令以记录 ID 为键,幂等可重试。

使用方式:先认证并校验,sf org display --json 失败时提示用户运行 sf org login web --set-default --alias <alias>;随后必须运行 sf devops promotion validate --work-item-id <id> --target-stage-id <target-stage-id> --target-org <alias> --json,校验失败即停止。准备用 sf devops work-item prepare;仅当校验返回 combineDetails 时用 sf devops work-item combine 合并,之后晋升父工作项。晋升用 sf devops promote,--work-item-id 与 --stage-id 二选一,--target-stage-id 必填;仅当本次会话已成功校验时才加 --skip-validation。最后用 sf devops promotion complete 完成。

适用场景:CI 中自动推进工作项或整个阶段、合并共享元数据的工作项、生产阶段含 Apex 的部署(需 --test-level RunLocalTests 或 RunSpecifiedTests)。

限制:不负责工作项创建/状态更新、冲突检测、轮询已有晋升状态、流水线或项目设置;晋升部署为异步,需另行轮询返回的标识符后再完成晋升,技能内不阻塞等待;命令必须使用 --json,ID 以 CLI 标志传入,禁止交互式提示。