Desinstalar implementaciones

Desinstala una implementación de solución del entorno de destino utilizando la CLI.

Cuando ya no se necesita una implementación de solución, puedes desinstalarla del entorno de destino. Esto elimina la configuración de implementación y desactiva todos los procesos asociados.

Consejo:

Para las instancias de Orchestrator firmadas por una autoridad de certificación privada (como UiPath Automation Suite), este comando también acepta los parámetros --ca-cert y --pinnedpubkey . Consulta Confiar en certificados personalizados para escenarios y ejemplos.

¿Qué es desinstalar?

Desinstalar una implementación:

• Elimina la implementación de la carpeta de destino en Orchestrator.
• Desactiva todos los procesos incluidos en la solución.
• Detiene cualquier desencadenador o programación en ejecución.
• Limpia las configuraciones específicas de la implementación.
• No elimina el paquete de Soluciones (utilice delete-package para eso).

Sintaxis del comando

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

Parámetros

Parámetro	Descripción	Obligatorio
<deployment-name>	Nombre de la implementación que se va a desinstalar	Sí
-U	URL de Orchestrator	Sí
-T	Nombre del tenant	Sí
-A	Nombre de la organización	Sí
-I	ID de aplicación externa	Sí
-S	Secreto de aplicación externa	Sí
--applicationScope	Ámbitos necesarios	Sí
--traceLevel	Nivel de registro	No
--ca-cert	Archivo(s) de CA raíz de confianza (PEM, DER o PKCS#7) para el certificado TLS de Orchestrator/Identity. Repetir o separar por comas. Consulta Confiar en certificados personalizados.	No
--pinnedpubkey	Anclar la clave pública hoja (sha256//<base64>). Consulta Confiar en certificados personalizados.	No

Autenticación

Consulta Autenticación y ámbitos para conocer los ámbitos necesarios y Configuración de la aplicación externa.

Ejemplo

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

Qué sucede durante la desinstalación

Al desinstalar una implementación:

1. Desactivación : la implementación se marca como inactiva.
2. Limpieza de procesos : todos los procesos de la solución se eliminan de la carpeta.
3. Limpieza de desencadenadores : los desencadenadores programados se detienen y eliminan.
4. Limpieza de la configuración : se eliminan los enlaces y configuraciones específicos de la implementación.
5. Retención de paquetes : el paquete permanece en Soluciones y puede volver a implementarse.

Desinstalar vs. Eliminar

Es importante entender la diferencia:

Operación	Lo que hace	Cuándo usarlo
Desinstalar	Elimina la implementación de la carpeta	Cuando quieres desactivar una implementación pero mantener el paquete para uso futuro
Eliminar paquete	Elimina el paquete de la gestión de soluciones	Cuando se desea eliminar de forma permanente una versión del paquete

Flujo de trabajo de limpieza 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 ...

Mejores prácticas

1. Mantener solo las implementaciones necesarias

No acumules implementaciones antiguas. Desinstálalos como parte de tu proceso de implementación:

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

2. Utilizar la denominación de la implementación para la limpieza

Incluye la versión en los nombres de implementación para facilitar la limpieza:

# 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óximos pasos

Después de desinstalar las implementaciones:

1. Elimina paquetes si ya no son necesarios.
2. Revise otras implementaciones en la carpeta para oportunidades de limpieza.
3. Documentar el historial de implementación para fines de auditoría.