Pacote de solução uip

Sintaxe e opções para o "uip solution package", que produz um arquivo `.zip` implantável a partir de um diretório de soluções ou arquivo de pacote `.uis`.

produz um pacote uip solution pack .zip a partir de um diretório de soluções (contendo um manifesto .uipx ) ou de um arquivo pacote .uis . O arquivo resultante é o que uip solution publish carrega no feed do tenant, que uip solution deploy run pode implantar.

Pacote é uma operação offline — ele não entra em contato com o Orchestrator, exceto para resolver dependências do NuGet de feeds de tenants (ou um feed de biblioteca da pasta do Orchestrator por meio de --feed-folder) — portanto, é seguro executar dentro de etapas de compilação que ainda não têm credenciais completas, como desde que a resolução de dependência seja coberta.

Resumo

uip solution pack <solutionPath> [outputPath] \
  [--name <name>] [--version <version>] \
  [--dry-run] \
  [--skip-analyze] [--governance-file-path <path> | --automation-ops-profile <profile>] \
  [--nuget-sources-config-path <path>] [--exclude-configured-sources] [--feed-folder <name>] \
  [--signing-certificate-path <path>] [--signing-certificate-password <password>] [--signing-timestamp-server <url>] \
  [--author <text>] [--description <text>] [--release-notes <text>] [--project-url <url>] \
  [--repository-url <url>] [--repository-commit <sha>] [--repository-branch <branch>] [--repository-type <type>] \
  [--login-validity <minutes>]

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

Argumentos

• <solutionPath> (necessário) — Caminho para um diretório de solução (contendo um manifesto .uipx ) ou um arquivo .uis .
• [outputPath] opcional) — Diretório de saída onde o pacote .zip será escrito. Obrigatório, a menos que --dry-run esteja definido — omiti-lo sem --dry-run falha com um ponteiro para adicionar um ou outro.

Opções

Core

Long	Valor	Padrão	Description
-n, --name <name>	text	nome da pasta da solução (ou nome base do arquivo .uis)	Nome do pacote. O .zip empacotado é nomeado <name>_<version>.zip.
-v, --version <version>	text	1.0.0	Versão do pacote. Aparece no nome do arquivo de saída e é o valor passado para --package-version em deploy run.
--dry-run	Bandeira	desativada	Execute o pipeline completo do pacote (sincronização de recursos, emissão de dependência de runtime, validação de opções do empacotador) em uma cópia temporária descartável e descarte a saída. Pega falhas de tempo de empacotamento — uma dependência ausente, uma associação de recurso quebrada, um tipo de projeto desempacotado — sem produzir um .zip ou escrever qualquer coisa de volta na solução. Ele não inspeciona o conteúdo do pacote produzido, portanto, não pode garantir que o feed da solução aceitará o resultado. Torna [outputPath] opcional.
--login-validity <minutes>	minutos	10	Mínimo de minutos antes da expiração do token para disparar uma atualização. Relevante apenas quando a resolução de dependência precisa de um feed de tenant.

Resolução de dependência

Long	Valor	Padrão	Description
--nuget-sources-config-path <path>	Path	—	Caminho para um arquivo de configuração de origens do NuGet para resolver dependências do projeto.
--exclude-configured-sources	Bandeira	desativada	Resolver dependências apenas de feeds de tenant e --nuget-sources-config-path. Solta os feeds UiPath e nuget.org integrados — uma dependência fora desses feeds não será restaurada.
--feed-folder <name>	Nome ou caminho	—	Resolva dependências do feed de biblioteca desta pasta do Orchestrator em vez de cada feed de tenant. Aceita um nome de pasta ou caminho totalmente qualificado.

Análise de governança

--skip-analyze, --governance-file-path e --automation-ops-profile controlam o analisador de fluxo de trabalho que é executado em cada projeto de RPA na solução. --governance-file-path e --automation-ops-profile são mutuamente exclusivos.

Long	Valor	Padrão	Description
--skip-analyze	Bandeira	desativada	Ignorar o analisador de fluxo de trabalho para todos os projetos de RPA. Compilação e validação ainda em execução — apenas as regras do analisador são ignoradas.
--governance-file-path <path>	Path	—	Analise cada projeto de RPA em relação a este arquivo de política de governança local, em vez das regras do analisador enviadas com o WorkflowCompiler.
--automation-ops-profile <profile>	text	—	Analise cada projeto de RPA em relação à política de governança publicada no AutomationOps para o tenant conectado. O valor é o produto cuja política é baixada — por exemplo, StudioWeb, Development, Business.

Um valor vazio para qualquer sinalizador de governança (--governance-file-path "") é rejeitado como um erro, e não é tratado silenciosamente como "sem sinalizador".

Assinatura do pacote

A assinatura do .nupkg de um projeto já empacotado requer a CLI dotnet em PATH.

Long	Valor	Padrão	Description
--signing-certificate-path <path>	Path	—	Caminho para um certificado de assinatura de código .pfx. Quando definido, cada projeto empacotado .nupkg na solução é assinado antes de ser agrupado na solução .zip.
--signing-certificate-password <password>	texto ou env.VAR	—	Senha do certificado. Passe env.ENV_NAME para ler uma variável de ambiente em vez do histórico do shell.
--signing-timestamp-server <url>	URL	—	URL do servidor de carimbo de data/hora para a assinatura.

Metadados do pacote (rastreabilidade da origem)

Esses sinalizadores marcam metadados de rastreabilidade em um arquivo package.metadata.json na raiz do arquivo e no .nuspec de cada projeto. Nenhum é necessário — omita todos eles e o pacote carregará apenas o nome, versão e os dois padrões exigidos pelo WorkflowCompiler (author: "UiPath", description: "Created by UiPath" quando não for substituído).

Long	Valor	Padrão	Description
--author <text>	text	UiPath	Autor do pacote.
--description <text>	text	Created by UiPath	Descrição do pacote.
--release-notes <text>	text	—	Notas de versão para o pacote.
--project-url <url>	URL	—	URL da ideia do Automation Hub.
--repository-url <url>	URL	—	URL do repositório de origem.
--repository-commit <sha>	text	—	Hash de confirmação do repositório de origem.
--repository-branch <branch>	text	—	Ramificação do repositório de origem.
--repository-type <type>	text	git (quando --repository-url está definido)	Tipo de repositório de origem. Gravado apenas quando --repository-url também está definido.

Exemplos

Mínimo

uip solution pack ./my-solution ./dist

Empacota a solução em ./my-solution em ./dist/my-solution_1.0.0.zip (versão padrão).

Comum — o nome fixo e a versão para uma compilação de CI

uip solution pack ./my-solution ./dist --name invoices --version 1.2.0

Grava ./dist/invoices_1.2.0.zip.

Validar sem empacotar

uip solution pack ./my-solution --dry-run

Executa o pipeline completo do pacote em um diretório temporário e descarta a saída — útil como uma porta de pré-implantação no CI, pois captura erros de associação de recursos, referência de variável e dependência de runtime sem precisar de outputPath um.

Metadados de rastreabilidade de origem do carimbo

uip solution pack ./my-solution ./dist --version 1.2.0 \
  --repository-url https://github.com/acme/repo \
  --repository-commit abc123 \
  --repository-branch main \
  --release-notes "v1.2.0"

Assinar projetos empacotados

uip solution pack ./my-solution ./dist --version 1.2.0 \
  --signing-certificate-path ./cert.pfx \
  --signing-certificate-password env.UIPATH_SIGNING_CERTIFICATE_PASSWORD \
  --signing-timestamp-server http://timestamp.digicert.com

Ignorar o analisador de fluxo de trabalho

uip solution pack ./my-solution ./dist --version 1.2.0 --skip-analyze

Compilação e validação ainda em execução — apenas as regras do analisador são ignoradas.

Analisar com base em uma política de governança do tenant

uip solution pack ./my-solution ./dist --version 1.2.0 --automation-ops-profile Development

Scripting — capture o caminho de saída para a etapa de publicação

PKG=$(uip solution pack ./my-solution ./dist --version 1.2.0 --output-filter "Data.Packages" --output plain)
uip solution publish "$PKG"

Formato dos dados (--output json)

Pacote real:

{
  "Code": "SolutionPack",
  "Data": {
    "Package": "my-solution@1.2.0",
    "Packages": "./dist/my-solution_1.2.0.zip"
  }
}

• Package — identificador <name>@<version> para a solução empacotada.
• Packages — lista separada por vírgulas de .zip caminho(s) escrito(s) para <outputPath>. Normalmente, um único caminho.

Simulação (--dry-run):

{
  "Code": "SolutionPack",
  "Data": {
    "Package": "my-solution@1.0.0",
    "DryRun": true,
    "Status": "Valid"
  }
}

Modos de falha

• outputPath ausente sem --dry-run. Falha com um ponteiro para fornecer um diretório de saída ou passar --dry-run.
• Sinalizadores de governança conflitantes. --governance-file-path e --automation-ops-profile são mutuamente exclusivos; um valor vazio para ambas é rejeitado.
• Caminho de saída dentro de um diretório de projeto membro. Recusado — qualquer coisa escrita lá será empacotada no próprio pacote desse projeto no próximo pacote. Escolha um caminho de saída fora dos diretórios do projeto da solução (por exemplo, ./out na raiz da solução ou um diretório totalmente fora da solução).
• Tipo de projeto desempacotado. Nomeia o tipo de projeto e aponta para uip tools search / uip tools install <tool> para adicionar a ferramenta de empacotamento que gerencia isso (ou uip update primeiro, se for um tipo recém-adicionado).

Comandos relacionados

• uip solution publish — carrega o .zip empacotado para o feed da solução do tenant.
• uip solution upload — caminho alternativo que carrega a solução no Studio Web para edição interativa em vez de empacotá-la para implantação.
• uip solution deploy run — implanta um pacote publicado no Orchestrator.

Veja também

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