Téléchargement des packages et des configurations de solutions

Options de téléchargement du package de solution et de la configuration à des fins de sauvegarde, de promotion de l’environnement et de gestion de la configuration.

Vous pouvez télécharger des packages de solutions et des fichiers de configuration de déploiement à partir de Solutions dans Orchestrator. Ceci est utile pour la récupération d'urgence, la promotion de l'environnement et la gestion de la configuration.

Astuce :

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

Téléchargement d'un paquet

La commande download-package récupère un package de solution à partir de Solutions.

Syntaxe de commande

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

Paramètres

Paramètre	Description	Requis
<package-name>	Nom du package à télécharger	Oui (Yes)
-d ou --destinationPath	Chemin de destination local où le paquet sera enregistré	Oui (Yes)
-v ou --version	Numéro de version (s'il est omis, la version la plus récente est téléchargée)	Non (No)
-f ou --fileName	Nom du fichier local (si omis, le nom de fichier sera le nom du package + version)	Non (No)
-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	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 download-package MySolution \
  -d C:\Downloads \
  -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

Cela télécharge le package dans :

C:\Downloads\MySolution.1.2.3.zip

Exemple avec nom de fichier personnalisé

uipcli solution download-package MySolution \
  -d C:\Downloads \
  -f CustomPackageName.zip \
  -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

Cas d'utilisation pour le téléchargement de packages

Disaster Recovery

• Archiver les packages pour la sauvegarde
• Restaurer les packages si Orchestrator n’est pas disponible

Production de l'environnement

• Télécharger depuis l'environnement de test
• Charger vers l’environnement de production

Audit

• Récupérer des versions spécifiques pour les examens de conformité
• Comparer le contenu du package entre les versions

Tests locaux

• Télécharger un package déployé pour validation
• Décompressez de test et déployez localement

Téléchargement des configurations de déploiement

La commande download-config récupère des modèles de configuration spécifiques à l'environnement pour un déploiement de solution.

Syntaxe de commande

uipcli solution download-config <package-name> [options]

Paramètres

Paramètre	Description	Requis
<package-name>	Nom du paquet	Oui (Yes)
-d ou --destinationPath	Chemin de destination local où les fichiers de configuration seront enregistrés	Oui (Yes)
-v ou --version	Numéro de version	Non (No)
-f ou --fileName	Nom du fichier local (si omis, le nom de fichier sera le nom du package + version)	Non (No)
--format	Format de configuration yaml yaml ou json	Non (No)
-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	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)

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

Important : les trois étendues sont requises pour toutes les commandes CLI liées à la solution. Ces étendues sont regroupées pour fournir une couverture complète de toutes les commandes de solution disponibles et doivent être configurées collectivement plutôt qu'individuellement par commande.

Authentification

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

Exemple

Télécharger la configuration au format YAML (par défaut)

uipcli solution download-config MySolution \
  -d C:\Configs \
  -v 1.0.0 \
  -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

Télécharger la configuration au format JSON avec un nom de fichier personnalisé

uipcli solution download-config MySolution \
  -d C:\Configs \
  -f CustomConfigFile \
  -v 1.0.0 \
  --format json \
  -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 sont les configurations de déploiement ?

Les configurations du déploiement définissent les paramètres spécifiques à l'environnement d'une solution :

• chaînes de connexion (Connection Strings)
• Points de terminaison de l’API
• Références des identifiants
• Variables de l'environnement
• Mappages de dossier

Ces configurations sont les suivantes :

• Créé lors du déploiement d’une solution
• Stocké dans les solutions
• Réutilisable dans plusieurs déploiements
• Contrôle de version séparément du package

Cas d'utilisation pour le téléchargement des configurations

Pipelines multi-environnements

# Download Dev config
uipcli solution download-config MySolution \
  -d C:\Configs\Dev \
  -f dev-config \
  -v 1.0.0 \
  -U https://cloud.uipath.com/ ...

# Download Prod config
uipcli solution download-config MySolution \
  -d C:\Configs\Prod \
  -f prod-config \
  -v 1.0.0 \
  -U https://cloud.uipath.com/ ...

Configuration en tant que code

• Fichiers de configuration du contrôle de version
• Suivre les modifications dans les paramètres de l’environnement
• Examiner les différences de configuration dans les demandes pull

Génération de modèles

• Télécharger une configuration de travail comme point de départ
• Modifier pour les nouveaux environnements
• Réutiliser les modèles de déploiement

Audit et conformité

• Archiver les configurations pour chaque déploiement
• Comparer les paramètres entre les environnements
• Vérifier que la configuration de production correspond aux modèles approuvés

Exemple d'intégration de pipeline

Téléchargement et configurations du contrôle de version

- name: Download Solution Configs
  run: |
    # Download config from Test environment
    uipcli solution download-config MySolution \
      -d ./configs/test \
      -f test-config \
      --format yaml \
      -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"

- name: Commit configs to repo
  run: |
    git add ./configs
    git commit -m "Update deployment configs from Test"
    git push

Résolution des problèmes

Erreur : "Unauthorized" ou "403 Forbidden"

• Vérifier que l'application externe a une étendue Solutions.Packages.Read
• Vérifiez que le nom de l'organisation (-A) est correct
• Confirmez que l’ID et la clé secrète de l’application externe sont valides

Erreur : « Package introuvable »

• Vérifier que le nom et la version du package sont corrects (sensibles à la casse)
• Assurez-vous de cibler le bon locataire et la bonne organisation
• Vérifiez que le package a été correctement téléchargé

Erreur : « Configuration introuvable »

• Vérifiez que le nom du package est correct
• Vérifiez que la version existe (ou omettez -v pour utiliser la dernière version)
• Assurez-vous que le package dispose de configurations de déploiement

Erreur : « Répertoire de sortie non accessible »

• Vérifier que le chemin de destination (-d) est valide et accessible en écriture
• Vérifier les autorisations de répertoire de l’agent
• Assurez-vous que l'espace disque suffisant est disponible

Prochaines étapes

Après avoir téléchargé les packages ou les configurations, vous pouvez :

1. Déployez des solutions dans les environnements cibles.
2. Fichiers de configuration du contrôle de version à des fins d’audit et de conformité.
3. Utilisez des configurations comme modèles pour les nouveaux déploiements.