Carregamento e exclusão de pacotes de solução

Após empacotar uma solução, você pode carregar o pacote para Soluções no Orchestrator. Você também pode excluir pacotes quando não forem mais necessários.

Fazendo upload de um pacote

O comando upload-package envia um arquivo .zip de solução para Soluções.

Sintaxe de comando

uipcli solution upload-package <package-path> [options]

Parâmetros:

Parâmetro	Description	Required
<package-path>	Caminho para o arquivo do pacote .zip	Sim
-U	URL do Orchestrator	Sim
-T	Nome do tenant	Sim
-A	Nome da Organização	Sim
-I	ID do aplicativo externo	Sim
-S	Segredo do aplicativo externo	Sim
--applicationScope	Escopos opcionais (padrão aplicados)	Não
--traceLevel	Nível de Registros de Log	Não

Autenticação

Consulte Autenticação e escopos para escopos necessários e Configuração de aplicativos externos.

Exemplo

uipcli solution upload-package C:\Output\MySolution.1.2.3.zip \
  -U https://cloud.uipath.com/ \
  -T DefaultTenant \
  -A myorg \
  -I 12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
  -S **** \
  --applicationScope "AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write" \
  --traceLevel Information

Usando segredos de CI/CD

Nunca codificar credenciais em scripts. Use o gerenciamento de segredos da sua plataforma:

DevOps do Azure:

- script: |
    uipcli solution upload-package $(Build.ArtifactStagingDirectory)\MySolution.$(Build.BuildId).zip \
      -U $(orchestratorUrl) \
      -T $(orchestratorTenant) \
      -A $(organizationName) \
      -I $(externalAppId) \
      -S $(externalAppSecret) \
      --applicationScope "AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write" \
      --traceLevel Information
  displayName: 'Upload Solution Package'

Ações do GitHub:

- name: Upload Solution Package
  run: |
    uipcli solution upload-package ${{ runner.temp }}/packages/MySolution.${{ github.run_number }}.zip \
      -U ${{ secrets.ORCHESTRATOR_URL }} \
      -T ${{ secrets.ORCHESTRATOR_TENANT }} \
      -A ${{ secrets.ORG_NAME }} \
      -I ${{ secrets.EXTERNAL_APP_ID }} \
      -S ${{ secrets.EXTERNAL_APP_SECRET }} \
      --applicationScope "AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write" \
      --traceLevel Information

O que acontece após o upload

Após ser carregado, o pacote:

• Aparece em Soluções no Orchestrator.
• Pode ser implantado em qualquer pasta de destino.
• É versionado e rastreado.
• Pode ser baixado por outros pipelines ou usuários.

Deleting a package

O comando delete-package remove um pacote de soluções de Soluções.

Sintaxe de comando

uipcli solution delete-package <package-name> [options]

Parâmetros:

Parâmetro	Description	Required
<package-name>	Nome do pacote (sem extensão .zip )	Sim
-v ou --version	Número da versão a excluir	Sim
-U	URL do Orchestrator	Sim
-T	Nome do tenant	Sim
-A	Nome da Organização	Sim
-I	ID do aplicativo externo	Sim
-S	Segredo do aplicativo externo	Sim
--applicationScope	Escopos opcionais (padrão aplicados)	Não
--traceLevel	Nível de Registros de Log	Não

Observação:

Ao usar a autenticação de aplicativos externos sem especificar o parâmetro --applicationScope , a CLI aplica automaticamente esses escopos padrão do AutomationSolution:

Solutions.Packages Solutions.Deployments OR.Execution

Autenticação

Consulte Autenticação e escopos para escopos necessários e Configuração de aplicativos externos.

Exemplo

uipcli solution delete-package MySolution \
  -v 1.2.3 \
  -U https://cloud.uipath.com/ \
  -T DefaultTenant \
  -A myorg \
  -I 12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
  -S **** \
  --applicationScope "AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write" \
  --traceLevel Information

Quando excluir pacotes

Cenários comuns para excluir pacotes:

• Pipelines de limpeza - Remova versões antigas após a implantação bem-sucedida.
• Compilações com falha - Excluir pacotes inválidos que não devem ser implantados.
• Políticas de retenção — aplicar as regras do ciclo de vida do pacote (por exemplo, manter apenas as últimas 10 versões).
• Gerenciamento de armazenamento - Liberar espaço em Soluções.

Exemplo do pipeline - limpeza de versões antigas

# Delete old version after deploying new one
uipcli solution delete-package MySolution \
  -v 1.2.2 \
  -U https://cloud.uipath.com/ \
  -T DefaultTenant \
  -A myorg \
  -I $(externalAppId) \
  -S $(externalAppSecret) \
  --applicationScope "AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write"

Nomenclatura do pacote

O nome do pacote usado em operações de upload e exclusão é derivado do nome da solução, não do nome do arquivo.

Exemplo:

• O comando Empacotar cria: MySolution.1.2.3.zip
• Nome do pacote para exclusão: MySolution
• Versão: 1.2.3

Próximas Etapas

Depois de carregar um pacote, você pode:

1. Baixe as configurações de implantação.
2. Implante a solução em um ambiente de destino.