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 sont obligatoires dans les procédures d'installation énumérées ci-dessous. Orchestrator ne fonctionne pas sans l'installation d'Identity Server.

2. Avant de démarrer 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 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. Créez une application Azure AD et un principal de service qui peuvent accéder à l'App Service et au groupe de ressources d'Identity. En option, demandez à votre sympathique équipe DevOps de vous fournir un ID et un mot de passe principal de service Azure qui peuvent accéder à App Service et au groupe de ressources associé.

É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
   Attention : 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. Créez une application Azure AD et un principal de service qui peuvent accéder à l'App Service et au groupe de ressources d'Identity. En option, demandez à votre sympathique équipe DevOps de vous fournir un ID et un mot de passe principal de service Azure qui peuvent accéder à App Service et au groupe de ressources associé.

Étapes générales

1. Téléchargez l'archive UiPathOrchestrator.zip sur votre machine locale. Celle-ci contient tous les scripts nécessaires pour installer Orchestrator, le serveur d'identité et le service Webhooks. UiPath fournit l'archive UiPathOrchestrator.zip sur demande. Contactez-nous pour plus de détails.
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. Exécutez le script Publish-Orchestrator.ps1 dans PowerShell en utilisant les paramètres décrits ici.
   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. Exécutez le script Publish-IdentityServer.ps1 dans PowerShell en utilisant les paramètres décrits ici.
   Attention : Assurez-vous de terminer le processus en effectuant les étapes décrites sur la page Publier sur Identity Server .
5. Exécutez le script MigrateTo-IdentityServer.ps1 dans PowerShell en utilisant les paramètres décrits ici.
6. Installez le service Webhooks.
7. Démarrez le service d'applications Orchestrator et Identity. Profitez d'Orchestrator sur votre portail Azure.

Installation à plusieurs nœuds

Remarque : Les installations multi-nœuds nécessitent la configuration du module complémentaire haute disponibilité.

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. Créez une application Azure AD et un principal de service qui peuvent accéder à l'App Service et au groupe de ressources d'Identity. En option, demandez à votre sympathique équipe DevOps de vous fournir un ID et un mot de passe principal de service Azure qui peuvent accéder à App Service et au groupe de ressources associé.
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
   Attention : 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. Créez une application Azure AD et un principal de service qui peuvent accéder à l'App Service et au groupe de ressources d'Identity. En option, demandez à votre sympathique équipe DevOps de vous fournir un ID et un mot de passe principal de service Azure qui peuvent accéder à App Service et au groupe de ressources associé.

Étapes générales

1. Téléchargez l'archive UiPathOrchestrator.zip sur votre machine locale. Celle-ci contient tous les scripts nécessaires pour installer Orchestrator, le serveur d'identité et le service Webhooks. UiPath fournit l'archive UiPathOrchestrator.zip sur demande. Contactez-nous pour plus de détails.
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. Exécutez le script Publish-Orchestrator.ps1 dans PowerShell en utilisant les paramètres décrits ici.
   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. Exécutez le script Publish-IdentityServer.ps1 dans PowerShell en utilisant les paramètres décrits ici.
   Attention : Assurez-vous de terminer le processus en effectuant les étapes décrites sur la page Publier sur Identity Server .
5. Exécutez le script MigrateTo-IdentityServer.ps1 dans PowerShell en utilisant les paramètres décrits ici.
6. Installez le service Webhooks.
7. Démarrez le service d'applications Orchestrator et Identity. Profitez d'Orchestrator sur votre portail Azure.