UIP 解决方案发布

“uip solution publish”的语法和选项，用于将解决方案“.zip”上传到解决方案订阅源。

uip solution publish将由.zip生成的解决方案uip solution pack上传到解决方案订阅源。默认情况下，包落在租户订阅源中；则传递 --personal-workspace 以当前用户的个人工作区订阅源为目标，或传递 --feed <name-or-key> 以特定文件夹订阅源为目标。包发布后， uip solution packages list即可查看该包，并且可以使用uip solution deploy run进行部署。

发布是一项经过身份验证的操作。请先运行uip login 。

备注：

已发布的包尚未部署。发布只会将 .zip 上传到订阅源，不会创建 Orchestrator 文件夹、配置资源或使包可运行。使用uip solution deploy run对其进行部署，然后它才能显示在流程列表中或可以作为作业启动。

大纲

uip solution publish <packagePath> \
  [--personal-workspace | --feed <name-or-key>] \
  [--package-name <name>] [--package-version <version>] \
  [--wait] [--timeout <seconds>] [--poll-interval <ms>] \
  [--login-validity <minutes>]

该命令遵循全局选项，并返回标准退出代码。

参数

• <packagePath> （必填） — 由uip solution pack生成的.zip包的路径。文件必须存在并且具有 .zip 扩展名；其他任何操作都将失败，结果为 Failure。.nupkg（单个项目的包，例如来自 uip maestro flow pack）— 改为打包包含的解决方案。

选项

长	值	默认	描述
--personal-workspace	标记	关闭	上传到当前用户的个人工作区订阅源，而不是租户订阅源。自动从 Orchestrator 解析工作区文件夹密钥。与 --feed 互斥。
--feed <name-or-key>	text	—	通过订阅源名称或文件夹密钥（来自solution feeds list ）发布到订阅源，而不是租户订阅源。与 --personal-workspace 互斥。
--package-name <name>	text	的名称 .zip	使用此名称发布，而不是使用打包 .zip 的名称发布。在内存中重写存档的 solutionMetadata.json（使用新的包版本密钥）— 磁盘上的文件保持不变，捆绑的项目包保留其自己的名称/版本。仅适用于 uip solution pack 生成的包。
--package-version <version>	text	版本从 .zip	在此版本下发布，而不是在打包 .zip 的版本下发布。使用该活动来清除“已存在的版本”版本。当您有打包的 .zip 但没有解决方案来源时，而不重新打包，则拒绝。与 --package-name 相同的内存重写。
--wait	标记	关闭	等待已发布的包达到 Ready 或 Active 状态，然后再返回。
--timeout <seconds>	秒	360	包状态轮询超时（仅与 --wait 相关）。
--poll-interval <ms>	毫秒	5000	包状态轮询之间的毫秒数。
--login-validity <minutes>	分钟	10	在令牌过期前触发刷新的最短分钟数。

示例

最小

uip solution publish ./dist/my-solution_1.0.0.zip

重新发布相同的.zip使用新版本

uip solution publish ./dist/my-solution_1.0.0.zip --package-version 1.0.1

当订阅源因为某个包的名称+版本已存在，且您拥有 .zip 但没有解决方案来源而拒绝了该包时，请使用此选项。--package-name 对于名称的作用相同。

发布到当前用户的个人工作区

uip solution publish ./dist/my-solution_1.0.0.zip --personal-workspace

发布到命名订阅源

uip solution publish ./dist/my-solution_1.0.0.zip --feed Finance

脚本编写 —chain pack → 发布并捕获包版本密钥

uip solution pack ./my-solution ./dist --version 1.2.0
KEY=$(uip solution publish ./dist/my-solution_1.2.0.zip --output-filter "Data.PackageVersionKey" --output plain)
echo "Published version key: $KEY"

数据形状（--输出 json）

{
  "Code": "SolutionPublish",
  "Data": {
    "Status": "Package is published to Orchestrator but not yet deployed",
    "PackageVersionKey": "a1b2c3d4-0000-0000-0000-000000000001",
    "PackageName": "my-solution",
    "PackageVersion": "1.0.0",
    "State": "Ready",
    "NextSteps": "Package is published to Orchestrator but not yet deployed. Deploy/activate it into an Orchestrator folder before it appears in the processes list or can be started as a job."
  }
}

• PackageVersionKey — 在订阅源中标识包特定版本的 GUID。
• PackageName / PackageVersion — 包中的值（或 --package-name/--package-version 覆盖）；在 deploy run --package-name --package-version 上重新使用它们。
• State — 仅在使用 --wait 时存在；最终包状态（Ready 或 Active）。

版本冲突

发布目标订阅源中已存在 name + version 的包时，将失败，并显示描述性错误。它可以是：

• 提升版本并重新打包：uip solution pack <solution-path> <output-path> --version <new-version>，或
• 在新版本下重新发布同一个 .zip，而不重新打包：uip solution publish <package-path> --package-version <new-version>。

相关命令

• uip solution pack — 生成.zip以发布。
• uip solution feeds list — 查找--feed的订阅源名称或密钥。
• uip solution packages list — 查看已发布版本。
• uip solution packages delete — 删除已发布版本。
• uip solution deploy run — 将已发布的包部署到 Orchestrator。

另请参阅

• 您的第一个管道— 打包 → 发布 → 部署运行演练。
• 身份验证— 会话管理。
• uip solution概述。