publicação da solução uip

Sintaxe e opções para "uip solution publish", que carrega uma solução `.zip` em um feed de soluções.

uip solution publish carrega uma solução .zip — produzida por uip solution pack — para um feed de solução. Por padrão, o pacote chega no feed do tenant; passe --personal-workspace para segmentar o feed do Espaço de Trabalho Pessoal do usuário atual ou --feed <name-or-key> para segmentar um feed de pasta específico. Depois que um pacote é publicado, ele fica visível para uip solution packages list e pode ser implantado com uip solution deploy run.

A publicação é uma operação autenticada. Execute uip login primeiro.

Observação:

Um pacote publicado ainda não foi implantado. A publicação apenas carrega o .zip para um feed — não cria uma pasta do Orchestrator, provisiona recursos ou torna o pacote executável. Implante-o com uip solution deploy run antes que ele apareça na lista de processos ou possa ser iniciado como um trabalho.

Resumo

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>]

O comando honra as opções globais e retorna os códigos de saída padrão.

Argumentos

• <packagePath> (necessário) — Caminho para um pacote .zip produzido por uip solution pack. O arquivo deve existir e ter uma extensão .zip; qualquer outra coisa falhará com um resultado Failure. Um .nupkg (um pacote de um único projeto, por exemplo, de uip maestro flow pack) é rejeitado explicitamente — empacote a solução de envolvimento.

Opções

Long	Valor	Padrão	Description
--personal-workspace	Bandeira	desativada	Carregue no feed do Espaço de Trabalho Pessoal do usuário atual em vez do feed do tenant. Resolve a chave da pasta do espaço de trabalho do Orchestrator automaticamente. mutuamente exclusivo com --feed.
--feed <name-or-key>	text	—	Publique em um feed por seu nome ou chave de pasta (de solution feeds list) em vez do feed do tenant. Mutualmente exclusivo com --personal-workspace.
--package-name <name>	text	Nome do .zip	Publique sob este nome em vez daquele com o qual .zip foi empacotado. Substitui o solutionMetadata.json do arquivo na memória (com uma nova chave de versão do pacote) — o arquivo no disco permanece intacto, e os pacotes de projeto incluídos mantêm seus próprios nomes/versões. Funciona apenas em um pacote produzido por uip solution pack.
--package-version <version>	text	versão do .zip	Publique sob esta versão em vez daquela com a qual .zip foi empacotado. Use-o para limpar uma mensagem > "versão já existe" rejeição quando você tem o .zip empacotado, mas não a origem da solução, sem reempacotar. Mesma regravação na memória que --package-name.
--wait	Bandeira	desativada	Aguarde até que o pacote publicado atinja o estado Ready ou Active antes de retornar.
--timeout <seconds>	segundos	360	Tempo limite de pesquisa do estado do pacote (relevante apenas com --wait).
--poll-interval <ms>	ms	5000	Milissegundos entre pesquisas de estado do pacote.
--login-validity <minutes>	minutos	10	Mínimo de minutos antes da expiração do token para disparar uma atualização.

Exemplos

Mínimo

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

Republique o mesmo arquivo.zip sob uma nova versão

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

Use isso quando o feed rejeitou o pacote porque seu nome+versão já existe e você tem o .zip, mas não a origem da solução. --package-name funciona da mesma maneira para o nome.

Publicar no Espaço de Trabalho Pessoal do usuário atual

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

Publicar em um feed nomeado

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

Script — pacote de string → publicar e capturar a chave da versão do pacote

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"

Formato dos dados (--output 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 identificando esta versão específica do pacote no feed.
• PackageName / PackageVersion — os valores do pacote (ou a substituição --package-name/--package-version); reutilize-os em deploy run --package-name --package-version.
• State — presente apenas quando --wait foi usado; o estado do pacote terminal (Ready Activeou).

Conflitos de versões

A publicação de um pacote que name + version já existe no feed de destino falha com um erro descritivo. Ou:

• Incrementar a versão e empacotar novamente: uip solution pack <solution-path> <output-path> --version <new-version>, ou
• Republique o mesmo .zip sob uma nova versão sem empacotar novamente: uip solution publish <package-path> --package-version <new-version>.

Comandos relacionados

• uip solution pack — produz o .zip para publicar.
• uip solution feeds list — encontre o nome de um feed ou a chave para --feed.
• uip solution packages list — consulte as versões publicadas.
• uip solution packages delete — remover uma versão publicada.
• uip solution deploy run — implantar o pacote publicado no Orchestrator.

Veja também

• Seu primeiro guia passo a passo do pipeline — empacotar → publicar → implantar execução.
• Autenticação — gerenciamento de sessão.
• uip solution visão geral.