Déployer et activer des solutions

Après avoir importé un package de solution dans Solutions, vous pouvez le déployer dans un dossier cible et l'activer pour le rendre opérationnel.

Workflow de déploiement

Le déploiement d’une solution est un processus en deux étapes :

1. Déployer : créez une configuration de déploiement et associez le package à un dossier cible.
2. Activer : rendre le déploiement en direct et opérationnel.

Cette séparation vous permet de préparer les déploiements à l'avance et de les activer pendant les périodes de maintenance ou après une approbation manuelle.

Déploiement d'une solution

La commande deploy crée un déploiement d’un package de solution dans un environnement spécifique.

Syntaxe de commande

uipcli solution deploy <package-name> [options]

Paramètres :

Paramètre	Description	Requis
<package-name>	Nom du package téléchargé	Oui (Yes)
-v ou --version	Version du package à déployer	Oui (Yes)
-d ou --deploymentName	Nom de ce déploiement	Oui (Yes)
-f ou --deploymentFolderName	Nom du dossier cible dans Orchestrator	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)
--deploymentParentFolder	Nom du dossier parent dans Orchestrator où la solution sera déployée	Non (No)
--configPath	Chemin d'accès local au fichier de configuration de la solution ; nécessaire dans les scénarios avec des liaisons de remplacement	Non (No)
--traceLevel	Niveau de journalisation	Non (No)

Authentification

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

Exemple

uipcli solution deploy MySolution \  -v 1.2.3 \  -d MySolution-Prod-v1.2.3 \  -f Production \  -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

Conventions d'affectation de noms du déploiement

Choisissez des noms de déploiement significatifs qui incluent :

• Nom de la solution
• Identificateur d'environnement
• Version ou date

Exemples :

MySolution-Dev-v1.2.3MySolution-Test-2025-01-15MySolution-Prod-Release-1.2.3InvoiceProcessing-Production-v2.0.0

Cela facilite le suivi et la gestion des déploiements dans tous les environnements.

Que se passe-t-il pendant le déploiement

Lorsque vous exécutez la commande de déploiement :

1. Le package est validé dans Solutions.
2. Une configuration de déploiement est créée.
3. Le déploiement est associé au dossier cible.
4. Les liaisons spécifiques à l'environnement sont initialisées.
5. Le déploiement est préparé, mais pas encore actif.

La solution ne commence pas à exécuter les processus tant que vous ne l’activez pas.

Activer un déploiement

La commande deploy-activate rend un déploiement actif et opérationnel.

Syntaxe de commande

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

Paramètres :

Paramètre	Description	Requis
<deployment-name>	Nom du déploiement à activer	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)

Authentification

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

Exemple

uipcli solution deploy-activate 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 pendant l’activation

Lorsque vous activez un déploiement :

1. Le déploiement devient la version active dans le dossier cible.
2. Les déclencheurs sont activés.
3. Tout déploiement auparavant actif dans le même dossier est désactivé.

Intégration du pipeline CI/CD

Terminer le workflow de déploiement

steps:  # 1. Pack the Solution  - name: Pack Solution    run: |      uipcli solution pack ./MySolution \        --output ./packages \        --version "1.0.${{ github.run_number }}"  # 2. Upload to Solutions Management  - name: Upload Package    run: |      uipcli solution upload-package ./packages/MySolution.1.0.${{ 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.Packages Solutions.Packages.Write"  # 3. Deploy to target environment  - name: Deploy Solution    run: |      uipcli solution deploy MySolution \        -v "1.0.${{ github.run_number }}" \        -d "MySolution-Prod-v1.0.${{ github.run_number }}" \        -f Production \        -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"  # 4. Activate the deployment  - name: Activate Deployment    run: |      uipcli solution deploy-activate "MySolution-Prod-v1.0.${{ github.run_number }}" \        -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"

Déploiements limités avec approbation manuelle

Vous pouvez séparer les étapes de déploiement et d'activation pour implémenter les workflows d'approbation :

# Stage 1: Deploy (automated)- stage: DeployToProduction  jobs:  - job: Deploy    steps:    - script: |        uipcli solution deploy MySolution -v $(version) -d MySolution-Prod-$(version) -f Production ...      displayName: 'Prepare Production Deployment'# Stage 2: Activate (requires approval)- stage: ActivateProduction  dependsOn: DeployToProduction  # Manual approval gate configured in Azure DevOps  jobs:  - deployment: Activate    environment: 'Production'    steps:    - script: |        uipcli solution deploy-activate MySolution-Prod-$(version) ...      displayName: 'Activate Production Deployment'

Offre multi-environnements

Déployez la même version sur plusieurs environnements de façon séquentielle :

# Deploy to Devuipcli solution deploy MySolution -v 1.2.3 -d MySolution-Dev-1.2.3 -f Dev ...uipcli solution deploy-activate MySolution-Dev-1.2.3 ...# Deploy to Testuipcli solution deploy MySolution -v 1.2.3 -d MySolution-Test-1.2.3 -f Test ...uipcli solution deploy-activate MySolution-Test-1.2.3 ...# Deploy to Production (after approval)uipcli solution deploy MySolution -v 1.2.3 -d MySolution-Prod-1.2.3 -f Production ...uipcli solution deploy-activate MySolution-Prod-1.2.3 ...

Stratégie de restauration

Pour revenir à une version précédente :

1. Déployez la version précédente avec un nouveau nom de déploiement.
2. Activez le déploiement de la version précédente.
3. Vous pouvez éventuellement désinstaller le nouveau déploiement.

# Roll back to v1.2.2uipcli solution deploy MySolution -v 1.2.2 -d MySolution-Prod-Rollback-1.2.2 -f Production ...uipcli solution deploy-activate MySolution-Prod-Rollback-1.2.2 ...

Prochaines étapes

Après avoir déployé et activé des solutions, vous pouvez :

1. Surveillez l'exécution dans Orchestrator.
2. Désinstallez les déploiements lorsqu’il n’est plus nécessaire.
3. Déployez de nouvelles versions en suivant le même workflow.