Charger et supprimer des packages de solutions

Après avoir compressé une solution, vous pouvez télécharger le package vers Solutions dans Orchestrator. Vous pouvez également supprimer des packages lorsqu'ils ne sont plus nécessaires.

Astuce :

For Orchestrator instances signed by a private Certificate Authority (such as UiPath Automation Suite), both upload-package and delete-package also accept --ca-cert and --pinnedpubkey parameters. See Trusting custom certificates for scenarios and examples.

Téléchargement d'un paquet

La commande upload-package transmet un fichier .zip de solution vers Solutions.

Syntaxe de commande

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

Paramètres :

Paramètre	Description	Requis
<package-path>	Chemin d'accès au fichier de package .zip	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 facultatives (valeurs appliquées par défaut)	Non (No)
--traceLevel	Niveau de journalisation	Non (No)
--ca-cert	Trusted root CA file(s) (PEM, DER, or PKCS#7) for the Orchestrator/Identity TLS certificate. Repeat or comma-separate. See Trusting custom certificates.	Non (No)
--pinnedpubkey	Pin the leaf public key (sha256//<base64>). See Trusting custom certificates.	Non (No)

Authentification

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

Exemple

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

Utilisation des clés secrètes CI/CD

Ne jamais coder en dur les informations d’identification dans les scripts. Utilisez la gestion des clés secrètes de votre plate-forme :

Azure DevOps :

- 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'

Actions 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

Que se passe-t-il après le téléchargement

Une fois téléchargé, le package :

• Apparaît dans Solutions dans Orchestrator.
• Peut être déployé dans n’importe quel dossier cible.
• Est versionné et suivi.
• Peut être téléchargé par d’autres pipelines ou des utilisateurs.

Deleting a package

La commande delete-package supprime un package de solution dans Solutions.

Syntaxe de commande

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

Paramètres :

Paramètre	Description	Requis
<package-name>	Nom du paquet (par l'extension .zip )	Oui (Yes)
-v ou --version	Numéro de version à supprimer	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 facultatives (valeurs appliquées par défaut)	Non (No)
--traceLevel	Niveau de journalisation	Non (No)
--ca-cert	Trusted root CA file(s) (PEM, DER, or PKCS#7) for the Orchestrator/Identity TLS certificate. Repeat or comma-separate. See Trusting custom certificates.	Non (No)
--pinnedpubkey	Pin the leaf public key (sha256//<base64>). See Trusting custom certificates.	Non (No)

Remarque :

Lorsque vous utilisez l'authentification d'application externe sans spécifier le paramètre --applicationScope , la CLI applique automatiquement ces étendues AutomationSolution par défaut :

Solutions.Packages Solutions.Deployments OR.Execution

Authentification

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

Exemple

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

Quand supprimer les packages

Scénarios courants de suppression de packages :

• Nettoyer les pipelines - Supprime les anciennes versions après un déploiement réussi.
• Échec des générations : supprimez les packages non valides qui ne doivent pas être déployés.
• Stratégies de rétention : appliquez les règles de cycle de vie des packages (par exemple, ne conservez que les 10 dernières versions).
• Gestion du stockage : libérez de l’espace dans les Solutions.

Exemple de pipeline : nettoyer les anciennes versions

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

Nom de package

Le nom du package utilisé dans les opérations de téléchargement et de suppression est dérivé du nom de la solution, et non du nom de fichier.

Exemple :

• La commande pack crée : MySolution.1.2.3.zip
• Nom du package à supprimer : MySolution
• Version : 1.2.3

Prochaines étapes

Après avoir téléchargé un package, vous pouvez :

1. Téléchargez les configurations de déploiement.
2. Déployez la solution dans un environnement cible.