Action Center : Installation d'Azure PaaS

Le script d'installation d'Azure permet d'installer l'Action Center sur un ou plusieurs nœuds.

Important :

Toutes les étapes des procédures d’installation énumérées ci-dessous sont obligatoires.

Avant de commencer

Assurez-vous que les outils suivants sont installés sur votre machine :

• PowerShell Web Deploy Snapin
• Module PowerShell AzureAZ version 7.0 ou supérieure.

Installation sur un nœud unique

Création du service d’application Azure pour Action Center

1. Accédez à votre portail Azure et recherchez les Services d’applications (App Services).

2. Créez un nouveau service d’application et nommez-le en conséquence, par exemple UiPathActionCenter.

   Remarque :

   Depuis le menu déroulant Pile d'exécution , sélectionnez .NET Core 3.1.

3. Ouvrez l’application Web précédemment créée et naviguez vers Configuration > Paramètres généraux (General settings) à partir du menu situé à gauche, puis réglez le champ Plate-forme (Platform) sur 64 Bits.

Création du Principal du service Azure pour l'Action Center

1. Sur le portail Azure, recherchez les Inscriptions d’applications (App registrations) et créez-en une nouvelle, nommée en conséquence.

   Important :

   Vous devez attribuer le rôle de contributeur à l'enregistrement de l'application. Voyez ici comment procéder.

2. Sur la page Vue d’ensemble (Overview) de votre application, copiez l’iD d’application (client) (Application (client) ID) et enregistrez-la pour une utilisation ultérieure. Il s’agit de votre identifiant principal pour le service Azure.

   

3. Sur la page Clients et clés secrètes (Clients & secrets) de l’inscription d’application précédemment créée, générez une nouvelle clé secrète de client. Copiez sa valeur (Value) et enregistrez-la pour une utilisation ultérieure. Il s’agit de votre mot de passe principal pour le service Azure.

   

   Remarque :

   En option, demandez à votre sympathique équipe DevOps de vous fournir un ID et un mot de passe de principal de service Azure qui peuvent accéder à App Service et au groupe de ressources associé.

Installation d’Action Center sur Azure

1. Téléchargez l'archive UiPathActionCenter.zip sur votre machine locale. Celle-ci contient tous les scripts d’installation nécessaires.

   Remarque :

   UiPath fournit l'archive UiPathActionCenter.zip sur demande. Contactez-nous pour plus de détails.

2. Extrayez le contenu du fichier .zip dans un dossier de votre machine.

3. Run the Publish-ActionCenter-Azure.ps1 script in PowerShell, using these installation parameters.

   Check out this script example.

4. Profitez d'Action Center sur votre portail Azure.

Installation à plusieurs nœuds

The multi-node installation is similar to the single node installation, with an additional step between steps 6 and 7 of the single node procedure.

Par conséquent, après l’étape 6, vous devez effectuer les actions suivantes :

• Ouvrez le service d’application nouvellement créé.
• Rendez-vous dans l’onglet Mise à l'échelle (Plan du service d'applications) (Scale out (App Service plan)) situé dans le menu de gauche.
• Sélectionnez l'option Évolutivité vers un nombre spécifique d'instances (Scale to a specific instance count).
• Indiquez le nombre d’instances (Instance count) souhaité.

Continue with step 7 of the single node procedure afterward.

Important :

Après la migration ou la mise à niveau vers Orchestrator 2022.4 PaaS, accédez à la configuration d'Azure App Service et assurez-vous que les clés suivantes sont présentes dans la liste et que leur valeur est définie sur true :

• IdentityServer.OAuth.Enabled
• IdentityServer.S2SIntegration.Enabled

Paramètres du script d’installation Powershell

Remarque :

Si vous souhaitez utiliser un domaine personnalisé pour votre service d’application Action Center, veuillez d’abord définir le domaine personnalisé, puis utiliser ce nom de domaine dans les paramètres du script.

Par exemple, si votre domaine personnalisé est https://actioncenter.xyz.com, utilisez la même valeur pour le paramètre de script actionCenterUrl.

Paramètre	Description
orchestratorUrl	Obligatoire. L'URL de l'instance Orchestrator.
identityServerUrl	Obligatoire. URL de l’instance Serveur d’identité.
actionCenterUrl	Obligatoire. L'URL de l'instance Action Center.
identityInstallationAccessToken	Obligatoire (Mandatory). Le jeton d’accès tiré du portail de gestion des identités. See Host authentication settings for details.
azureSubscriptionId	Obligatoire. L'ID d'abonnement Azure pour l'application App Service qui héberge Action Center. Find it on the app service's Overview page, in your Azure Portal.
azureAccountTenantId	Obligatoire. ID de locataire Azure. Find it on the app registration's Overview page, in your Azure Portal.
azureAccountApplicationId	Obligatoire. L'identifiant principal du service Azure. It's the one you copied and saved at step 5 of the Single Node Installation procedure.
azureAccountPassword	Obligatoire. Le mot de passe principal du service Azure. It's the one you copied and saved at step 6 of the Single Node Installation procedure.
package	Mandatory. Indicate the full path or relative path of the UiPath.ActionCenter.Web.zip archive. Find it in the UiPath.Actioncenter.zip archive.
resourceGroupName	Obligatoire. Nom du groupe de ressources Azure qui contient le service d'application Action Center.
appServiceName	Obligatoire. Nom du service d'application Azure de l'Action Center.
stopApplicationBeforePublish	Facultatif. S’il est actif, il arrête l’application avant le déploiement et la démarre une fois le déploiement terminé.
unattended	Facultatif. S'il est actif, le déploiement se poursuit sans confirmation de l'utilisateur.

Exemple de script PowerShell

.\Publish-ActionCenter-Azure.ps1 `
    -orchestratorUrl "https://<OrchestratorServiceURL>" `
    -identityServerUrl "https://<IdentityServerURL>/identity" `
    -actionCenterUrl "https://<ActionCenterServiceURL>" `
    -identityInstallationAccessToken "abcdefgh ... MAxJeysh6IQFSabcd" `
    -azureSubscriptionId "d12f123e-12ac-1da1-1234-ed1234d5cf4b" `
    -azureAccountTenantId "d1234d2a-b123-1d12-1234-902c51f12345" `
    -azureAccountApplicationId "12345678-67e1-123d-1234-1c6cd123b123" `
    -azureAccountPassword "O.T5pX4bX89I3~Wi.clbM_u0-R5Aa-sRl~" `
    -package "E:\)\)Work\)\)UiPathActionCenter\)\)UiPath.ActionCenter.Web.zip" `
    -stopApplicationBeforePublish `
    -resourceGroupName "<ResourceGroupName" `
    -appServiceName "<ActionCenterServiceName>" `
    -unattended

Requêtes de compartiments de stockage

Les fonctionnalités de l'Action Center qui utilisent les compartiments de stockage à l’intérieur d’Orchestrator, telles que les images et le rendu PDF sur les actions de formulaire (Form actions), la classification des documents (Document Classification) et les actions de validation de documents (Document Validation) nécessitent la configuration suivante dans Orchestrator :

Accepter les requêtes d'Action Center sur Orchestrator :

• Ouvrez l’application Web Orchestrator dans votre portail Azure.
• Accédez à Configuration et sélectionnez Paramètres d’application (Application Settings).
• Ajoutez un Nouveau paramètre d’application (New application setting) et entrez-y ce qui suit :

  • Nom - AcceptedRootUrls

  • Valeur - https://localhost:6234,https://<ActionCenterServiceURL>

    Important :

    Assurez-vous que la valeur saisie dans le champ Valeur ne possède pas d’espaces vides.

    Remarque :

    Remplacez <ActionCenterServiceURL> par l'URL correspondante de votre service Action Center.

    

Pour autoriser OPTIONS dans le fichier web.config de l’application Web Orchestrator :

• Ouvrez l’application Web Orchestrator dans votre portail Azure.
• Accédez à Application de l'éditeur de service (Vue d'ensemble) (App Service Editor (Preview)).
• Modifiez le fichier web.config :

  • Navigate to the <requestFiltering>``<verbs> section.

  • Ajoutez <add verb="OPTIONS" allowed="true" /> à la fin de la section.

    Remarque :

    La mise à niveau Orchestrator réinitialise le fichier web.config, de sorte que vous devez autoriser à nouveau le verbe OPTIONS.

    Concernant les fournisseurs de stockage tiers, retrouvez plus de détails sur la configuration CORS/CSP.

Mise à niveau

Pour mettre à niveau Azure PaaS Action Center, vous devez installer une nouvelle version supérieure qui remplace la version actuelle.

Désinstallation

Pour supprimer Action Center de votre Portail Azure, supprimez les ressources Azure suivantes :

• Service d’application Action Center
• Inscription d’application Action Center