Procédure: réutiliser les ressources Orchestrator existantes lors du déploiement

Réutilisez une connexion, une ressource ou une file d'attente d'Orchestrator existante lors du déploiement d'une solution à partir d'un pipeline CI/CD, au lieu d'en enregistrer une nouvelle.

Lorsque vous déployez une solution, toutes les ressources qu'elle déclare (files d'attente, ressources, processus, connexions) sont enregistrées à nouveau dans le dossier de déploiement. Dans de nombreux cas, vous disposez déjà d'une ressource partagée dans l'environnement cible, telle qu'une connexion à un système externe, et vous souhaitez que le déploiement la réutilise au lieu d'en créer une nouvelle.

Dans l'interface utilisateur d'Orchestrator, vous pouvez le faire en choisissant Personnaliser lors du déploiement et en liant la ressource manuellement. Cette étape manuelle ne se traduit pas par un pipeline Unattended. L'équivalent CLI consiste à récupérer la configuration du déploiement, à lier la ressource à l'intérieur de ce fichier, puis à transmettre le fichier à deploy run.

Remarque :

config link lie une ressource déclarée à une ressource existante. Pour que chaque ressource réutilise une ressource correspondante à la place, consultez Réutiliser chaque ressource ci-dessous.

Prérequis

• Un package de solution publié dans le locataire. Voir Empaqueter et publier une solution.
• Une application externe configurée pour l’authentification par informations d’identification avec les étendues suivantes: AutomationSolutions, Solutions.Deployments, Solutions.Packages, OR.Folders, RCS.FolderAuthorization. Voir Authentification — Flux 2. OR.Folders et RCS.FolderAuthorization sont requis pour que la CLI puisse résoudre et lier les ressources qui résident dans les dossiers Orchestrator.
• L'application externe affectée au dossier Orchestrator qui contient la ressource existante.

Étapes

1. Authentifiez-vous avec l’application externe.

   uip login \
     --client-id env.UIPATH_CLIENT_ID \
     --client-secret env.UIPATH_CLIENT_SECRET \
     --tenant "$UIPATH_TENANT"
   

2. Téléchargez la configuration de déploiement du package.

   uip solution deploy config get "my-package" \
     --package-version 1.0.0 \
     -d ./deploy-config.json
   

3. Liez la ressource de solution à la ressource Orchestrator existante. Utilisez le nom de la ressource tel qu'il apparaît dans le fichier de configuration et pointez --folder-path au niveau du dossier où se trouve la ressource existante.

   uip solution deploy config link ./deploy-config.json "MyConnection" \
     --name "SharedCrmConnection" \
     --folder-path "Shared"
   

4. Déployez le package avec la configuration modifiée.

   uip solution deploy run \
     --name "my-deployment" \
     --package-name "my-package" \
     --package-version 1.0.0 \
     --folder-name "MySolution" \
     --parent-folder-path "Shared" \
     --config-file ./deploy-config.json
   

Le déploiement réutilise la ressource liée et n’en crée pas de nouvelle dans le dossier de déploiement.

Remarque :

Sur config link, --folder-path est l'endroit où se trouve la ressource existante . Sur deploy run, --parent-folder-path est l'endroit où le dossier de déploiement est créé. Ce sont des indicateurs distincts associés à des sous-commandes distinctes.

Connexions: différer la sélection au runtime

Pour les ressources de connexion, la liaison d'une connexion existante n'est pas la seule option. Si vous définissez le authenticationType de la connexion sur ConfigurableByUsers dans la configuration du déploiement, vous pouvez laisser la connexion non liée et différer sa sélection et son authentification au moment de l'exécution — les utilisateurs choisissent et authentifient la connexion lorsque l'automatisation s'exécute. Il s'agit également d'une configuration valide pour l'activation.

authenticationType accepte deux valeurs: ConfigurableByUsers (préférez-vous à l'utilisateur au moment du runtime) et AuthenticateAfterDeployment (la connexion doit être authentifiée après le déploiement). Avec AuthenticateAfterDeployment, si la connexion n’est pas authentifiée au moment de l’exécution de l’activation, l’activation est signalée comme ayant échoué.

Réutiliser chaque ressource

Lorsque vous souhaitez que l'ensemble du déploiement réutilise les ressources existantes plutôt que d'en créer de nouvelles, définissez la politique de conflit sur toutes les ressources en un seul appel avant de procéder au déploiement.

1. Définissez la politique de conflit sur chaque ressource dans le fichier de configuration.

   uip solution deploy config set ./deploy-config.json --all conflictFixingAction UseExisting
   

2. Passez le même fichier à deploy run --config-file, comme indiqué à l'étape 4.

Voir également

• uip solution deploy — la référence pour config get, config link, config set et deploy run.
• Gérer les ressources et les files d’attente d’Orchestrator : permet de créer les ressources vers lesquelles vous souhaitez lier ultérieurement.
• Déployer dans Orchestrator à partir de CI — authentification, mise en cache et épinglage de version pour le pipeline dans lequel il s'intègre.
• Authentification — le flux d'application externe utilisé ici.