Installation de Azure App Service

Vue d'ensemble (Overview)

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

Important :

1. Toutes les étapes des procédures d'installation énumérées ci-dessous doivent être suivies. Orchestrator ne fonctionne pas sans l'installation du serveur d'identité.

2. Avant de lancer l'installation d'Orchestrator, assurez-vous que vos certificats sont émis par une autorité de certification approuvée par Azure, telle que DigiCert.

3. Azure Stack n’est pas pris en charge, car des incompatibilités d’API peuvent se produire. Veuillez utiliser Azure Cloud pour votre déploiement.

Installation sur un nœud unique

Pour installer Orchestrator sur Azure App Service, procédez comme suit :

Étapes Orchestrator

1. Dans le portail Azure, sous Services d'applications (App Services), créez un service d'applications portant un nom personnalisé tel que UiPathOrchestrator. Lors de la création de l’application Web, assurez-vous de sélectionner la pile .NET Core 3.1. Pour plus d'informations, consultez la documentation officielle de Microsoft.

2. Ouvrez l’application Web nouvellement créée dans le portail Azure, et dans l'onglet Configuration, sélectionnez Paramètres généraux, puis réalisez les modifications suivantes :

   • Configurez la plate-forme sur 64 bits.
   • Configurez les Web Sockets sur On.

3. Définissez la chaîne de connexion à la base de données dans Configuration > Chaînes de connexion (Connection Strings) de l'application Web, avec le nom Default. Par exemple, Server=13.13.13.13;Initial Catalog=UiPath;Persist Security Info=False;User ID=dbUser;Password=pass123; MultipleActiveResultSets=False;Encrypt=True; Connection Timeout=30;TrustServerCertificate=True.

   Important :

   • L’utilisateur d'Azure SQL doit avoir accès au niveau du serveur ; l'accès au niveau de la base de données est insuffisant pour réussir l'installation.
   • Assurez-vous de règler l'attribut TrustServerCertificate dans la chaîne de connexion de base de données sur True.
   • Pour définir une chaîne de connexion à la base de données pour le module d'automatisation de test, suivez les étapes décrites pour le paramètre -testAutomationFeatureEnabled dans Publish-Orchestrator.ps1 Parameters.

4. Create an Azure AD application and service principal that can access your Orchestrator App Service and Resource Group. Optionally, ask your friendly DevOps team to provide you with an Azure Service Principal ID and Password that can access the App Service and associated Resource Group.

Étapes du serveur d'identité

1. Dans le portail Azure, sous Services d'applications (App Services), créez un service d'applications portant un nom personnalisé tel que UiPathIdentity. Lors de la création de l’application Web, assurez-vous de sélectionner la pile .NET Core 3.1. Pour plus d'informations, consultez la documentation officielle de Microsoft.

2. Définissez la chaîne de connexion à la base de données dans Configuration > Chaînes de connexion (Connection Strings) de l'application Web, avec le nom DefaultConnection. Par exemple, Server=13.13.13.13;Initial Catalog=UiPath;Persist Security Info=False;User ID=dbUser;Password=pass123; MultipleActiveResultSets=False;Encrypt=True; Connection Timeout=30;TrustServerCertificate=True.

   Important :

   Assurez-vous de règler l'attribut TrustServerCertificate dans la chaîne de connexion de base de données sur True.

3. Naviguez vers l'onglet Paramètres > Configuration > Paramètres généraux et sélectionnez 64 bits pour la plate-forme.

4. Create an Azure AD application and service principal that can access your Identity App Service and Resource Group. Optionally, ask your friendly DevOps team to provide you with an Azure Service Principal ID and Password that can access the App Service and associated Resource Group.

Étapes générales

1. Download the UiPathOrchestrator.zip archive to your local machine. This contains all the scripts necessary to install Orchestrator, Identity Server, and Webhooks Service. UiPath provides the UiPathOrchestrator.zip archive on request. Contact us for details.

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

   Remarque :

   Les étapes suivantes nécessitent l'exécution des scripts PowerShell. Pour désactiver les invites interrompant ces tâches, exécutez la commande Get-ChildItem *.ps1 -Recurse | Unblock-File située dans le répertoire sélectionné à l'étape 10.

3. Run the Publish-Orchestrator.ps1 script, in PowerShell, using the parameters described here.

   Important :

   • Avant d’exécuter le script Publish-Orchestrator.ps1, assurez-vous de désinstaller le module PowerShell AzureRM. Nous vous recommandons d’utiliser le module Az PowerShell comme alternative. L’installation simultanée de modules AzureRM et Az n’est pas prise en charge.
   • Si la version Az souhaitée n’est pas détectée et qu’AzureRM est présent lors de l’exécution du script, vous êtes invité à confirmer la suppression d'AzureRM même sur les installations Unattended.
   • Notez que lorsqu’une version précédente du module est utilisée, la mise à niveau vers Az v6.0.0 fait apparaître le message suivant : WARNING: The version 'x.x.x' of module 'Az.<Name>' is currently in use. Retry the operation after closing the applications. Afin de résoudre ce problème, assurez-vous d’exécuter Publish-Orchestrator.ps1 dans une nouvelle session PowerShell.
   • Si vous utilisez des agents hébergés par Microsoft, un problème Publish-Orchestrator.ps1 vous empêche d'exécuter la version Az correcte. Au lieu d'utiliser la version 5.4.0 ou 6.0.0, vous êtes bloqué avec la 4.7.0. Pour contourner le problème, assurez-vous de supprimer le dossier C:\Modules\az_4.7.0.

4. Run the Publish-IdentityServer.ps1 script, in PowerShell, using the parameters described here.

   Important :

   Make sure to complete the process by performing the steps described on the Publish to Identity Server page.

5. Run the MigrateTo-IdentityServer.ps1 script, in PowerShell, using the parameters described here.

6. Install the Webhooks Service.

7. Démarrez le service d'applications Orchestrator et Identity. Profitez d'Orchestrator sur votre portail Azure.

Installation à plusieurs nœuds

Remarque :

Multi-node installations require the setup of the High Availability Add-on.

Pour installer Orchestrator sur plusieurs nœuds d'Azure App Service, procédez comme suit :

Étapes Orchestrator

1. Dans le portail Azure, sous Services d'applications (App Services), créez un service d'applications portant un nom personnalisé tel que UiPathOrchestrator. Lors de la création de l’application Web, assurez-vous de sélectionner la pile .NET Core 3.1. Pour plus d'informations, consultez la documentation officielle de Microsoft.

2. Ouvrez l’application Web nouvellement créée dans le portail Azure, et dans l'onglet Configuration, sélectionnez Paramètres généraux, puis réalisez les modifications suivantes :

   • Configurez la plate-forme sur 64 bits.
   • Configurez les Web Sockets sur On.

3. Définissez la chaîne de connexion à la base de données dans Configuration > Chaînes de connexion (Connection Strings) de l'application Web, avec le nom « Par défaut (Default) ». Par exemple : Server=13.13.13.13;Initial Catalog=UiPath;Persist Security Info=False;User ID=dbUser;Password=pass123; MultipleActiveResultSets=False;Encrypt=True; Connection Timeout=30;TrustServerCertificate=True.

   Important :

   • L’utilisateur d'Azure SQL doit avoir accès au niveau du serveur ; l'accès au niveau de la base de données est insuffisant pour réussir l'installation.
   • Assurez-vous de règler l'attribut TrustServerCertificate dans la chaîne de connexion de base de données sur True.

4. Create an Azure AD application and service principal that can access your Orchestrator App Service and Resource Group. Optionally, ask your friendly DevOps team to provide you with an Azure Service Principal ID and Password that can access the App Service and associated Resource Group.

5. Dans l'onglet Évolutivité horizontale (Scale out) (plan du service d'applications), sélectionnez l'option Évolutivité vers un nombre spécifique d'instances (Scale to a specific instance count) et indiquez le Nombre d'instances (Instance count) spécifié.

Étapes du serveur d'identité

1. Dans le portail Azure, sous Services d'applications (App Services), créez un service d'applications portant un nom personnalisé tel que UiPathIdentity. Lors de la création de l’application Web, assurez-vous de sélectionner la pile .NET Core 3.1. Pour plus d'informations, consultez la documentation officielle de Microsoft.

2. Définissez la chaîne de connexion à la base de données dans Configuration > Chaînes de connexion (Connection Strings) de l'application Web, avec le nom DefaultConnection. Par exemple, Server=13.13.13.13;Initial Catalog=UiPath;Persist Security Info=False;User ID=dbUser;Password=pass123; MultipleActiveResultSets=False;Encrypt=True; Connection Timeout=30;TrustServerCertificate=True.

   Important :

   Assurez-vous de règler l'attribut TrustServerCertificate dans la chaîne de connexion de base de données sur True.

3. Naviguez vers l'onglet Paramètres > Configuration > Paramètres généraux et sélectionnez 64 bits pour la plate-forme.

4. Create an Azure AD application and service principal that can access your Identity App Service and Resource Group. Optionally, ask your friendly DevOps team to provide you with an Azure Service Principal ID and Password that can access the App Service and associated Resource Group.

Étapes générales

1. Download the UiPathOrchestrator.zip archive to your local machine. This contains all the scripts necessary to install Orchestrator, Identity Server, and Webhooks Service. UiPath provides the UiPathOrchestrator.zip archive on request. Contact us for details.

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

   Remarque :

   Les étapes suivantes nécessitent l'exécution des scripts PowerShell. Pour désactiver les invites interrompant ces tâches, exécutez la commande Get-ChildItem *.ps1 -Recurse | Unblock-File située dans le répertoire sélectionné à l'étape 11.

3. Run the Publish-Orchestrator.ps1 script, in PowerShell, using the parameters described here.

   Important :

   • Avant d’exécuter le script Publish-Orchestrator.ps1, assurez-vous de désinstaller le module PowerShell AzureRM. Nous vous recommandons d’utiliser le module Az PowerShell comme alternative. L’installation simultanée de modules AzureRM et Az n’est pas prise en charge.
   • Si la version Az souhaitée n’est pas détectée et qu’AzureRM est présent lors de l’exécution du script, vous êtes invité à confirmer la suppression d'AzureRM même sur les installations Unattended.
   • Notez que lorsqu’une version précédente du module est utilisée, la mise à niveau vers Az v6.0.0 fait apparaître le message suivant : WARNING: The version 'x.x.x' of module 'Az.<Name>' is currently in use. Retry the operation after closing the applications. Afin de résoudre ce problème, assurez-vous d’exécuter Publish-Orchestrator.ps1 dans une nouvelle session PowerShell.
   • Si vous utilisez des agents hébergés par Microsoft, un problème Publish-Orchestrator.ps1 vous empêche d'exécuter la version Az correcte. Au lieu d'utiliser la version 5.4.0 ou 6.0.0, vous êtes bloqué avec la 4.7.0. Pour contourner le problème, assurez-vous de supprimer le dossier C:\Modules\az_4.7.0.

4. Run the Publish-IdentityServer.ps1 script, in PowerShell, using the parameters described here.

   Important :

   Make sure to complete the process by performing the steps described on the Publish to Identity Server page.

5. Run the MigrateTo-IdentityServer.ps1 script, in PowerShell, using the parameters described here.

6. Install the Webhooks Service.

7. Démarrez le service d'applications Orchestrator et Identity. Profitez d'Orchestrator sur votre portail Azure.