- Visão geral
- Introdução
- Conceitos
- Usando o UiPath CLI
- Guias de instruções
- Receitas de CI/CD
- Referência de comando
- Visão geral
- Códigos de saída
- Opções globais
- Agente de código uip
- codificador UIP
- Contextualização da uip
- Documento da UIP
- Função UIP
- Proteções da UIP
- configuração-llm-uip
- gateway-llm-uip
- criação do uip Maestro
- Registro do uip Maestro
- hub de modelo da uip
- Atividades Localizar
- atividades get-padrão-xaml
- Analisar
- lista de regras do analisador
- Criar
- Limpeza
- instalação de entidades-de-dados
- lista de entidades de data-fabric
- comparação dos arquivos
- obter-repositório-objeto-da-Biblioteca
- obter-objeto-repositório
- Init
- lista de instâncias
- Empacotar
- inspeção de pacotes
- Instalação dos pacotes
- versões dos pacotes
- Publicar
- Remoto
- restore
- executar, depurar e adicionar; Execução
- Configurações
- Início do Studio
- pesquisa de modelos
- adição de dados de teste
- adicionar-fila-de-dados-de-teste
- adição-variação dos dados de teste
- TM
- UIA
- Validar
- fluxo de trabalho-exemplos obter
- lista de exemplos de fluxo de trabalho
- tarefas do UIP
- anexo
- Campo personalizado
- Defects
- Execuções
- exportar trabalhos
- Migração
- Rótulo do objeto
- Empacotar
- cenário-perf
- grupos de carga do cenário-perf
- dados de execução do cenário-perf
- relatório do cenário-perf
- Projeto
- permissões do projeto
- Prompts
- Relatar
- Requisitos
- Resultado
- Executar
- Agendamentos
- Log de caso de teste
- Casos de teste
- Conjuntos de Testes
- Log de etapa de teste
- Usuário
- Aguardar
- Traces da UIP
- Feedback de traces da uip
- Migração
- Referência e suporte
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 NuGet de feeds de tenants (ou um feed de biblioteca da pasta do Orchestrator por meio de --feed-folder) e não entra em contato com AutomationOps, exceto quando um sinalizador de governança ou --ignored-rules é passado enquanto você estão conectados — portanto, é seguro executar etapas de compilação que ainda não têm credenciais completas, desde que a resolução de dependência esteja coberta.
Resumo
uip solution pack <solutionPath> [outputPath] \
[--name <name>] [--version <version>] \
[--project <id-or-path> [--package-id <id>]] \
[--dry-run] \
[--skip-analyze] [--ignored-rules <rules>] [--governance-file-path <path>] [--governance-product <product>] \
[--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>]
uip solution pack <solutionPath> [outputPath] \
[--name <name>] [--version <version>] \
[--project <id-or-path> [--package-id <id>]] \
[--dry-run] \
[--skip-analyze] [--ignored-rules <rules>] [--governance-file-path <path>] [--governance-product <product>] \
[--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.zipserá escrito. Obrigatório, a menos que--dry-runesteja definido — omiti-lo sem--dry-runfalha 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. |
--project <id-or-path> | projeto Id ou caminho | — | Pack only this project of the solution into its own .nupkg, instead of the solution .zip. Takes the project's Id from the .uipx, or its path relative to the solution folder; separators and case are ignored. The project packs as a stand-alone project, so no solution resources go into it. Not supported for a .uis file, and cannot be combined with --name. Refer to Pack one project. |
--package-id <id> | text | o id que um pacote de solução completa dá ao projeto | Package id for the project packed with --project. Without it, the project keeps the id a whole-solution pack gives it: the one the solution saved, else <solution>.<type>.<project folder>. Requires --project. |
--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 ou quando a política de governança do tenant é verificada. |
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, --ignored-rules, --governance-file-path, and --governance-product control the workflow analyzer that runs against every RPA project in the solution. The flags can be combined.
| 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. |
--ignored-rules <rules> | IDs de regras separados por vírgulas | — | Analyzer rule IDs whose findings are ignored for every RPA project, for example ST-USG-034,ST-MRD-002. Repeat the flag to add more. The rules still run, but their findings are not reported and do not fail the pack. Applies on top of --governance-file-path or the shipped rules. When the signed-in tenant publishes an AutomationOps policy, the list is not applied and a warning says so. |
--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 fornecido com o WorkflowCompiler. Aceita uma política exportada do AutomationOps ou de um arquivo de configuração de regras do Studio. Quando você estiver conectado, o tenant será perguntado primeiro (sobre StudioWeb, a menos que --governance-product nomeie outro produto). Quando o tenant publica uma política própria, essa política é usada, esse arquivo é ignorado com um aviso e o pacote continua. Quando o tenant não publica nenhuma política, quando não pode ser solicitado ou quando seu serviço de política não responde, esse arquivo é usado. O arquivo é lido antes que o tenant seja solicitado, portanto, um arquivo ilegível ou não JSON falha no pacote em todos os casos. |
--governance-product <product> | 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)
These flags stamp traceability metadata into a package.metadata.json file at the archive root and into each project's .nuspec. None are required. When --author or --description is omitted, each member project keeps the value its own project file declares, and falls back to UiPath / Created by UiPath when it declares none.
| Long | Valor | Padrão | Description |
|---|---|---|---|
--author <text> | text | próprio autor de cada projeto, caso contrário UiPath | Autor do pacote. Quando definido, aplica-se a todos os projetos membros. |
--description <text> | text | each project's own description, else Created by UiPath | Descrição do pacote. Quando definido, aplica-se a todos os projetos membros. |
--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
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
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
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"
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
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
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 --governance-product Development
uip solution pack ./my-solution ./dist --version 1.2.0 --governance-product Development
Ignorar regras específicas do analisador
uip solution pack ./my-solution ./dist --version 1.2.0 --ignored-rules ST-USG-034,ST-MRD-002
uip solution pack ./my-solution ./dist --version 1.2.0 --ignored-rules ST-USG-034,ST-MRD-002
The rules still run, but their findings do not fail the pack. The list is not applied when the tenant publishes an AutomationOps policy.
Pack one project
uip solution pack ./my-solution ./dist --project MyProcess --package-id Acme.MyProcess --version 1.2.0
uip solution pack ./my-solution ./dist --project MyProcess --package-id Acme.MyProcess --version 1.2.0
--project produces the project's .nupkg instead of the solution .zip, for example to publish one project to an Orchestrator feed on its own. --name names the solution .zip, so it cannot be used with --project; --package-id names the project package.
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 "Packages" --output plain)
uip solution publish "$PKG"
PKG=$(uip solution pack ./my-solution ./dist --version 1.2.0 --output-filter "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"
}
}
{
"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.zipcaminho(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"
}
}
{
"Code": "SolutionPack",
"Data": {
"Package": "my-solution@1.0.0",
"DryRun": true,
"Status": "Valid"
}
}
Quando o pacote falha e o empacotador relata resultados por projeto, o envelope de falha Data.Projects, uma entrada por projeto de membro:
| Campo | Description |
|---|---|
Path | The project directory, relative to the solution directory, with forward slashes. |
Type | O tipo de projeto. |
Result | Success ou Failure. |
Message | The project's result message, when it has one. |
Findings | The project's findings. Each finding can carry Level, Source (Other, Analyzer, Validator, or Compiler), ErrorCode, RuleName, Description, FilePath, ActivityIdRef, and DocumentationLink. |
Data.Projects is omitted when the failure belongs to no project.
Com --project:
{
"Code": "SolutionPack",
"Data": {
"Package": "Acme.MyProcess@1.2.0",
"Packages": "/home/me/dist/Acme.MyProcess.1.2.0.nupkg"
}
}
{
"Code": "SolutionPack",
"Data": {
"Package": "Acme.MyProcess@1.2.0",
"Packages": "/home/me/dist/Acme.MyProcess.1.2.0.nupkg"
}
}
Package—<package-id>@<version>of the packed project.Packages— caminho absoluto de.nupkg.
Tipos de Projeto
Pack hands each member project to the packager tool for its project type. Some project types have their own pack behavior:
| Tipo de Projeto | Comportamento das pacotes |
|---|---|
| Fluxo | The .flow file is checked against the Maestro designer's validation rules. A flow with errors fails the pack. Every issue, warnings included, is reported as a finding, with ActivityIdRef naming the node. |
| Regras de Negócios | Packed as a .uirule archive named <rule-name>-<version>.uirule, holding the rule's .dmn files and an entry-points.json derived from them. |
| Entidades do Data Fabric | Apenas validado: o pacote verifica se todas as definições de entidade estão intactas e se o esquema é válido. Os recursos de definição de entidade são a carga implantável, portanto, nenhum pacote separado é produzido para o projeto. |
Modos de falha
--projectnão resolve. Um projetoIdou caminho que não está no.uipx, que corresponde a mais de um projeto, que aponta para fora da pasta da solução ou que fica na raiz da solução é recusado comErrorCode: invalid_argument. A mensagem lista os valoresIddo projeto da solução e caminhos para escolha.--projectwith a.uisfile, or with--name. Refused:--projectpacks a project out of a solution folder, and--namenames the solution.zipthat--projectdoes not produce.--package-idnames the project package.--package-idwithout--project, or an empty--projector--package-id. Refused.-
outputPathausente sem--dry-run. Falha com um ponteiro para fornecer um diretório de saída ou passar--dry-run. - Valor do sinalizador de governança vazio. Um valor vazio para
--governance-file-pathou--governance-producté rejeitado. - Unusable governance policy file. A
--governance-file-pathfile that cannot be read or is not JSON fails the pack. So does a file that holds only the inner policy of an AutomationOps export; pass the exported file as-is. - Colisão de IDs do pacote de membros. O ID do pacote de um membro é composto por
<solution>.<project-type>.<member-folder>, limitado a 100 caracteres e deve ser exclusivo em toda a solução. Espaços e pontos são recolhidos para um único ponto, e os IDs são comparados sem diferenciação entre maiúsculas e minúsculas. Quando dois membros compões o mesmo ID, o pacote falha comErrorCode: invalid_argument, nomeando o ID e as pastas que o produziram. A parte<solution>é o nome do próprio arquivo.uipx;--namerenomeia apenas o arquivo e não altera as IDs dos membros. Renomeie a pasta do membro ou.uipxe, em seguida, empacota novamente. - Falha no projeto. Um projeto que falha na compilação, validação ou análise falha no pacote.
Data.Projectso projeto e suas descobertas. - 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,
./outna 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 (ouuip updateprimeiro, se for um tipo recém-adicionado).
Comandos relacionados
uip solution publish— carrega o.zipempacotado 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 solutionvisão geral.
- Resumo
- Argumentos
- Opções
- Core
- Resolução de dependência
- Análise de governança
- Assinatura do pacote
- Metadados do pacote (rastreabilidade da origem)
- Exemplos
- Mínimo
- Comum — o nome fixo e a versão para uma compilação de CI
- Validar sem empacotar
- Metadados de rastreabilidade de origem do carimbo
- Assinar projetos empacotados
- Ignorar o analisador de fluxo de trabalho
- Analisar com base em uma política de governança do tenant
- Ignorar regras específicas do analisador
- Pack one project
- Scripting — capture o caminho de saída para a etapa de publicação
- Formato dos dados (--output json)
- Tipos de Projeto
- Modos de falha
- Comandos relacionados
- Veja também