- 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 | — | Empacote apenas este projeto da solução em seu próprio .nupkg, em vez da solução .zip. Obtém o Id do projeto de .uipx, ou seu caminho relativo à pasta da solução; separadores e maiúsculas/minúsculas são ignorados. O projeto é empacotado como um projeto independente, portanto, nenhum recurso da solução vai para ele. Não é compatível com um arquivo .uis e não pode ser combinado com --name. Consulte Empacotar um projeto. |
--package-id <id> | text | o id que um pacote de solução completa dá ao projeto | ID do pacote para o projeto empacotado com --project. Sem ele, o projeto mantém o id que um pacote de solução completa proporciona a ele: aquele que a solução salvou, então <solution>.<type>.<project folder>. Requer --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 e --governance-product controlam o analisador de fluxo de trabalho que é executado em relação a cada projeto de RPA na solução. Os sinalizadores podem ser combinados.
| 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 | — | IDs de regra do analisador cujas descobertas são ignoradas para cada projeto de RPA, por exemplo ST-USG-034,ST-MRD-002 Repita o sinalizador para adicionar mais. As regras ainda são executadas, mas suas descobertas não são relatadas e não falham no pacote. Aplica-se sobre --governance-file-path ou às regras enviadas. Quando o tenant conectado publica uma política do AutomationOps, a lista não é aplicada e um aviso diz isso. |
--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)
Esses sinalizadores marcam metadados de rastreabilidade em um arquivo package.metadata.json na raiz do arquivo e em cada projeto. .nuspec Nenhum é necessário. Quando --author ou --description é omitido, cada projeto membro mantém o valor que seu próprio arquivo de projeto declara e retorna para UiPath / Created by UiPath quando não declara nenhum.
| 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 | a própria descrição de cada projeto, caso contrário 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
As regras ainda são executadas, mas suas descobertas não falham no pacote. A lista não é aplicada quando o tenant publica uma política do AutomationOps.
Empacotar um projeto
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 produz o .nupkg do projeto em vez da solução .zip, por exemplo, para publicar um projeto em um feed do Orchestrator por conta própria. --name nomeia a solução .zip, portanto, não pode ser usada com --project; --package-id nomeia o pacote do projeto.
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 | O diretório do projeto, relativo ao diretório da solução, com barras comuns. |
Type | O tipo de projeto. |
Result | Success ou Failure. |
Message | A mensagem de resultado do projeto, quando tiver uma. |
Findings | As descobertas do projeto. Cada descoberta pode carregar Level, Source (Other, Analyzer, Validator ou Compiler), ErrorCode, RuleName, Description, FilePath, ActivityIdRef, e DocumentationLink. |
Data.Projects é omitido quando a falha não pertence a nenhum projeto.
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>do projeto empacotado.Packages— caminho absoluto de.nupkg.
Tipos de Projeto
Empacotar entrega cada projeto de membro à ferramenta empacotador para seu tipo de projeto. Alguns tipos de projeto têm seu próprio comportamento do pacote:
| Tipo de Projeto | Comportamento das pacotes |
|---|---|
| Fluxo | O .flow é verificado em relação às regras de validação do designer do Maestro. Um fluxo com erros falha no pacote. Cada problema, incluindo avisos, é relatado como uma descoberta, com ActivityIdRef nomeando o nó. |
| Regras de Negócios | Compactado como um arquivo .uirule chamado <rule-name>-<version>.uirule, contendo os arquivos .dmn da regra e um entry-points.json derivados deles. |
| 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.--projectcom um arquivo.uisou com--name. Recusado:--projectempacota um projeto fora de uma pasta de solução e--namenomeia a solução.zipque--projectnão produz.--package-idnomeia o pacote do projeto.--package-idsem--project, ou um--projectou--package-idvazio. Recusado.-
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. - Arquivo de política de governança inutilizável. Um arquivo
--governance-file-pathque não pode ser lido ou não é JSON falha no pacote. O mesmo acontece com um arquivo que contém apenas a política interna de uma exportação do AutomationOps; passe o arquivo exportado como está. - 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
- Empacotar um projeto
- 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