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.

O suporte a feeds de pastas no UiPath CLI estará disponível em uma versão futura. Para obter mais informações sobre feeds de pastas, consulte Feed de solução na documentação de Gerenciamento de soluções.

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.