Como desinstalar implantações

Quando uma implantação da solução não for mais necessária, você poderá desinstalá-la do ambiente de destino. Isso remove a configuração da implantação e desativa todos os processos associados.

O que é desinstalar?

Desinstalando uma implantação:

• Remove a implantação da pasta de destino no Orchestrator.
• Desativa todos os processos incluídos na solução.
• Interrompe qualquer gatilho ou agendamento em execução.
• Limpa configurações específicas da implantação.
• Não exclui o pacote de Soluções (use Delete-package para isso).

Sintaxe de comando

uipcli solution deploy-uninstall <deployment-name> [options]

Parâmetros:

Parâmetro	Description	Required
<deployment-name>	Nome da implantação a ser desinstalada	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 exigidos	Sim
--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 deploy-uninstall MySolution-Prod-v1.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

O que acontece durante a desinstalação

Quando você desinstala uma implantação:

1. Desativação - A implantação é marcada como inativa.
2. Limpeza de processos - Todos os processos na solução são removidos da pasta.
3. Limpeza de gatilhos - Os gatilhos agendados são interrompidos e removidos.
4. Limpeza de configuração - Associações e configurações específicas da implantação são excluídas.
5. Retenção de pacotes – O pacote permanece em Soluções e pode ser reimplantado.

Desinstalar versus Excluir

É importante entender a diferença:

Operação	O que faz	Quando usar
Desinstalar	Remove implantação da pasta	Quando você deseja desativar uma implantação, mas manter o pacote para uso futuro
Excluir pacote	Remove pacote do Gerenciamento de Soluções	Quando você deseja remover permanentemente uma versão de pacote

Fluxo de trabalho de limpeza típico:

# 1. First, uninstall all deployments using the package
uipcli solution deploy-uninstall MySolution-Dev-1.2.3 ...
uipcli solution deploy-uninstall MySolution-Test-1.2.3 ...

# 2. Then delete the package if no longer needed
uipcli solution delete-package MySolution -v 1.2.3 ...

Melhores práticas

1. Mantenha apenas as implantações necessárias

Não acumule implantações antigas. Desinstale-os como parte do seu pipeline de implantação:

# After successful deployment, always clean up
uipcli solution deploy-uninstall <old-deployment-name> ...

2. Use a nomeação de implantação para a limpeza

Inclua a versão nos nomes de implantação para facilitar a limpeza:

# Good naming convention
MySolution-Prod-v1.2.3

# Easy to identify and uninstall old versions
for old_version in 1.2.1 1.2.2; do
  uipcli solution deploy-uninstall MySolution-Prod-v$old_version ...
done

Próximas Etapas

Após desinstalar as implantações:

1. Exclua os pacotes se eles não forem mais necessários.
2. Revise outras implantações na pasta para ver oportunidades de limpeza.
3. Documente o histórico de implantação para fins de auditoria.