Scripts Webhooks

Publier sur des Webhooks

La table suivante décrit tous les paramètres pouvant être utilisés avec le script Publish-Webhooks.ps1.

Paramètre	Description
-action	Indiquez le scénario à exécuter, les options disponibles sont : Deploy : indique qu'il s'agit d'une nouvelle installation ; Update - indique que vous mettez à jour votre instance du service Webhook.
-azureAccountApplicationId	L'identifiant principal du service Azure. The indicated service principal must be assigned the Contributor role to the app service at the subscription scope.
-azureAccountPassword	Mot de passe du jeton Azure pour l'ID de principal de service.
-azureSubscriptionId	ID d'abonnement Azure du service d'application respectif.
-azureAccountTenantId	Les identifiants du locataire Azure.
-appServiceName	Nom du service d'application Azure de Webhook. This should be different from your Orchestrator App Service name.
-orchestratorUrl	Obligatoire. L'URL de l'instance Orchestrator.
-resourceGroupName	Nom du groupe de ressources Azure qui contient l'application Webhook App Service.
-package	Indiquez le chemin complet ou le chemin relatif de l'archive UiPath.WebhookService.zip.
-stopApplicationBeforePublish	Lorsqu'il est actif, il arrête l'application avant de commencer le déploiement et la redémarre une fois le déploiement terminé.
-azureUSGovernmentLogin	Facultatif (Optional). Ce paramètre est uniquement utilisé pour les déploiements du gouvernement américain.

Dans le cadre de votre installation d'Orchestrator sur Azure App service, vous devez également effectuer les étapes suivantes pour installer le service Webhooks :

1. Depuis votre portail Azure, créez une nouvelle application Web avec un nom personnalisé, par exemple : UiPathWebhookService.

2. Dans le champ Publier, sélectionnez Code.

3. Pour Pile d'exécution, sélectionnez .NET Core 3.1.

4. Ouvrez votre nouvelle application Web et naviguez vers Paramètres > Configuration.

5. Sous l’onglet Paramètres généraux, sélectionnez 64 bits pour la plate-forme.

6. Sélectionnez Enregistrer.

   Important :

   Si vous n'avez pas précédemment créé d'application et d'identifiant principal du service Azure AD à partir de l'installation d'Orchestrator sur Azure, faites-le maintenant. Vous devez les configurer pour accéder à votre UiPathWebhookService et à votre groupe de ressources.

7. Ouvrez une fenêtre Powershell et exécutez le script Publish-Webhooks.ps1. Par exemple :

   .\Publish-Webhooks.ps1 `
   -action deploy `
   -package ".\UiPath.WebhookService.Web.zip" `
   -azureAccountApplicationId "<AzureApplicationID>" `
   -azureAccountPassword "<AzureAccountPassword>" `
   -azureSubscriptionId "<SubscriptionID>" `
   -azureAccountTenantId "<TenantID>" `
   -resourceGroupName "<AzureResourceGroupYouPickedInStep1>" `
   -appServiceName "<UiPathWebhookService>"
   

   Important :

   Après un premier déploiement, vous devez également exécuter le script MigrateTo-Webhooks.ps1.

Migrer vers Webhooks

La table suivante décrit tous les paramètres pouvant être utilisés avec le script MigrateTo-Webhooks.ps1.

Paramètres	Description
-cliPackage	Indiquez le chemin d'accès à l'archive UiPath.WebhookService.Migrate.Cli.zip.
-azureDetails	Une table de hachage avec les valeurs suivantes : azureAccountApplicationId - ID principal du service Azure. azureAccountPassword - Mot de passe du jeton Azure pour l'ID de principal de service. azureSubscriptionId - ID d'abonnement Azure du service d'application respectif. azureAccountTenantId - ID du locataire Azure.
-orchDetails	Une table de hachage avec les valeurs suivantes : resourceGroupName - Nom du groupe de ressources Azure qui contient l'application App Service d'Orchestrator. appServiceName - nom du service de l'application Orchestrator. targetSlot - créneau de service de l'application cible fixé par Azure.
-webhooksDetails	Une table de hachage avec les valeurs suivantes : resourceGroupName - nom du groupe de ressources Azure qui contient le service de l'application Webhook. appServiceName - nom du service de l'application Webhook. targetSlot - créneau de service de l'application cible fixé par Azure.

Ce script MigrateTo-Webhooks.ps1 est utilisé pour migrer les données d'une instance Orchestrator existante vers un nouveau service d'application Webhook et définir les configurations pour les deux. Le script suppose qu'Orchestrator et les Webhooks ont déjà été publiés.

.\MigrateTo-Webhooks.ps1 `
    -cliPackage "UiPath.WebhookService.Migrator.Cli.zip"`
    -azureDetails @{azureSubscriptionId = "<subscription_id>"; azureAccountTenantId = "<azure_tenant_id>"; azureAccountApplicationId = "<azure_application_id>"; azureAccountPassword = "<azure_account_password>" } `
    -orchDetails @{ resourceGroupName = "<resourcegroup_name>"; appServiceName = "<appservice_name>";  targetSlot = "Production" } `
    -webhookDetails @{ resourceGroupName = "<resourcegroup_name>"; appServiceName = "<appservice_name>"; targetSlot = "Production" }