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 facultatives (valeurs appliquées par défaut)	Non (No)
--deploymentParentFolder	Le dossier Orchestrator dans lequel le dossier de déploiement sera créé. S'il n'est pas spécifié, le dossier de déploiement sera créé dans le dossier du locataire. Lorsqu'il est spécifié, le déploiement se fera sous le dossier respectif. Lorsqu'il est défini sur «[e-mail] » l’espace de travail), le déploiement sera sous l’espace de travail personnel de l’utilisateur spécifié.	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. Voir Téléchargement des packages de solutions et des configurations pour plus de détails sur l'obtention des fichiers de configuration.	Non (No)
--traceLevel	Niveau de journalisation	Non (No)

Remarque : Étendues d'application par défaut pour les solutions

Lorsque vous utilisez l'authentification d'application externe sans spécifier le paramètre --applicationScope , la CLI applique automatiquement ces étendues de solution 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.

Important :

Si un déploiement portant le même nom existe déjà à n'importe quel niveau au sein du locataire dans Orchestrator, cette opération met à niveau le déploiement existant au lieu d'en créer un nouveau. Si le déploiement existant est à l'état Échec, la mise à niveau ne se poursuit pas ; résolvez ou désinstallez le déploiement ayant échoué avant de réessayer.

Important :

Les solutions déployées au niveau du locataire n’affectent pas automatiquement un utilisateur au dossier résultant. Pour attribuer un compte, assurez-vous que la configuration appropriée est définie dans Orchestrator (Locataire > Dossiers).

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.3
MySolution-Test-2025-01-15
MySolution-Prod-Release-1.2.3
InvoiceProcessing-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 Dev
uipcli 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 Test
uipcli 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.2
uipcli 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.