Restauration et analyse des solutions

Avant de packager une solution, vous restaurez généralement ses dépendances et la validez par rapport aux règles de gouvernance. Ces opérations s'exécutent localement et ne nécessitent pas l'authentification d'Orchestrator.

Restauration des dépendances

La commande restore télécharge tous les packages d'activités et dépendances de projet nécessaires dans un dossier local.

Syntaxe de commande

uipcli solution restore <solution-path> [options]

Paramètres :

Paramètre	Description	Requis
<solution-path>	Chemin d'accès au dossier de la solution ou au fichier .uipx	Oui (Yes)
--restoreFolder	Chemin d'accès local où les dépendances sont restaurées	Non (No)
--traceLevel	Niveau de journalisation : Verbose, Information, Warning	Non (No)

Exemple

uipcli solution restore C:\Solutions\MySolution \  --restoreFolder C:\Work\Output \  --traceLevel Verbose

Utilisation de flux NuGet personnalisés

Si votre solution dépend d'activités de flux personnalisés, vous pouvez fournir un fichier nuget.config dans le répertoire de la solution ou spécifier des flux à l'aide des paramètres de la bibliothèque Orchestrator :

uipcli solution restore C:\Solutions\MySolution \  -A myorg \  -I 12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx \  -S **** \  --libraryOrchestratorApplicationScope "OR.Folders OR.Settings.Read" \  --libraryOrchestratorTenant DefaultTenant \  --libraryOrchestratorUrl https://cloud.uipath.com/ \  --libraryOrchestratorFolder MyFolder \  --traceLevel Verbose

Voir Gestion des flux NuGet pour plus de détails sur la configuration des sources d’activité.

Considérations relatives aux performances

La restauration NuGet représente souvent l’étape la plus lente dans le packaging d’une solution. Chaque opération de restauration doit résoudre les dépendances directes et transitiques.

Pour améliorer les performances de restauration :

1. Mettez en cache le dossier de package global NuGet entre les exécutions de pipeline :
   • Windows : %UserProfile%\.nuget\packages
   • Linux/macOS : ~/.nuget/packages
2. Utilisez un nuget.config rogné avec uniquement des flux accessibles :
   • Supprimez de la configuration les flux lents ou inaccessibles.
   • Triez les flux par fiabilité et rapidité.
3. Utilisez des agents auto-hébergés si une mise en cache persistante est requise.

Reportez-vous à la documentation Gestion des flux NuGet pour obtenir des exemples de mise en cache dans Azure DevOps et dans les autres plates-formes CI/CD.

Analyser une solution

La commande analyze valide la solution au regard des règles et des politiques de gouvernance de l'analyseur de workflow.

Syntaxe de commande

uipcli solution analyze <solution-path> [options]

Paramètres :

Paramètre	Description	Requis
<solution-path>	Chemin d'accès au dossier de la solution ou au fichier .uipx	Oui (Yes)
--governanceFilePath	Chemin d’accès au fichier JSON de la politique de gouvernance	Non (No)
--resultPath	Chemin d’accès où les résultats d’analyse JSON seront enregistrés	Non (No)
--analyzerTraceLevel	Niveau de journalisation de l'analyseur : Warning, Information, Verbose	Non (No)
--traceLevel	Niveau de journalisation CLI	Non (No)

Exemple

uipcli solution analyze C:\Solutions\MySolution \  --governanceFilePath C:\Policies\uipath.policy.Production.json \  --resultPath C:\Output\analyze.json \  --analyzerTraceLevel Warning \  --traceLevel Information

Politiques de gouvernance

Les politiques de gouvernance définissent les règles qui doivent être respectées avant qu’une solution puisse être packagée et déployée. Celles-ci comprennent généralement :

• Normes de qualité du code
• Conventions d'affectation de noms
• Contrôles de sécurité
• Seuils de performance

Les fichiers de stratégie sont des documents JSON qui configurent les règles de l'analyseur de workflow. Vous pouvez :

• Créer des politiques dans Studio
• Les exporter depuis Orchestrator
• Contrôlez leur version avec votre code de solution

Utilisation des résultats d'analyse dans CI/CD

Les résultats d'analyse JSON peuvent être analysés par votre pipeline pour :

• Échec du développement si des violations critiques sont trouvées
• Générer des rapports de conformité
• Gérer les déploiements vers des environnements de production

Workflow standard

Un modèle CI/CD commun combine la restauration et l'analyse avant le packaging :

# 1. Restore dependenciesuipcli solution restore C:\Solutions\MySolution \  --restoreFolder C:\Output\Dependencies \  --traceLevel Information# 2. Analyze against governance rulesuipcli solution analyze C:\Solutions\MySolution \  --governanceFilePath C:\Policies\production.json \  --resultPath C:\Output\analysis.json \  --analyzerTraceLevel Warning# 3. Check analysis results# 4. Continue to packaging...

Cela garantit que seules les solutions validées et conformes sont soumises à la packaging et au déploiement.