Désinstallation des déploiements

Lorsqu'un déploiement de solution n'est plus nécessaire, vous pouvez le désinstaller à partir de l'environnement cible. Cela supprime la configuration du déploiement et désactive tous les processus associés.

Astuce :

Pour les instances Orchestrator signées par une autorité de certification privée (telle qu'UiPath Automation Suite), cette commande accepte également les paramètres --ca-cert et --pinnedpubkey . Voir Approbation de certificats personnalisés pour des scénarios et des exemples.

Qu’est-ce que la désinstallation ?

Désinstallation d'un déploiement :

• Supprime le déploiement du dossier cible dans Orchestrator.
• Désactive tous les processus inclus dans la solution.
• Arrête tous les déclencheurs ou planifications en cours d’exécution.
• Nettoyer les configurations spécifiques au déploiement.
• Ne supprime pas le package des Solutions ; utilisez Delete-package pour cela.

Syntaxe de commande

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

Paramètres

Paramètre	Description	Requis
<deployment-name>	Nom du déploiement à désinstaller	Oui (Yes)
-U	URL d'Orchestrator	Oui (Yes)
-T	Nom de locataire	Oui (Yes)
-A	Nom de l'organisation	Oui (Yes)
-I	ID d’application externe	Oui (Yes)
-S	Clé secrète d’application externe	Oui (Yes)
--applicationScope	Étendues requises	Oui (Yes)
--traceLevel	Niveau de journalisation	Non (No)
--ca-cert	Fichier(s) CA racine approuvé(s) (PEM, DER ou PKCS#7) pour le certificat TLS Orchestrator/Identity. Répétez ou séparez par des virgules. Voir Approbation des certificats personnalisés.	Non (No)
--pinnedpubkey	Épingler la clé publique de la feuille (sha256//<base64>). Voir Approbation des certificats personnalisés.	Non (No)

Authentification

Consultez Authentification et étendues pour les étendues requises et Configuration d'applications externes.

Exemple

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

Que se passe-t-il lors de la désinstallation

Lorsque vous désinstallez un déploiement :

1. Désactivation : le déploiement est marqué comme inactif.
2. Nettoyage des processus : tous les processus de la solution sont supprimés du dossier.
3. Nettoyage du déclencheur : les déclencheurs planifiés sont arrêtés et supprimés.
4. Nettoyage de la configuration : les liaisons et les configurations spécifiques au déploiement sont supprimées.
5. Rétention du package : le package reste dans Solutions et peut être redéployé.

Désinstaller vs. Supprimer

Il est important de comprendre la différence :

Opération (Operation)	Ce qu’il fait	Quand l'utiliser
Désinstaller	Supprime le déploiement du dossier	Lorsque vous souhaitez désactiver un déploiement mais conserver le package pour une utilisation future
Supprimer le package	Supprime le package de Solutions Management	Lorsque vous souhaitez supprimer définitivement une version de package

Workflow de nettoyage typique

# 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 ...

Meilleures pratiques

1. Ne conserver que les déploiements nécessaires

N’accumulez pas les anciens déploiements. Désinstallez-les dans le cadre de votre pipeline de déploiement :

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

2. Utiliser le nommage du déploiement pour le nettoyage

Incluez la version dans les noms de déploiement pour faciliter le nettoyage :

# 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

Prochaines étapes

Après avoir désinstallé les déploiements :

1. Supprimez les packages s’ils ne sont plus nécessaires.
2. Passez en revue les autres déploiements dans le dossier pour connaître les opportunités de nettoyage.
3. Documentez l'historique de déploiement à des fins d'audit.