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. Remarque: l'identifiant principal du service indiqué doit se voir attribuer le rôle de contributeur au sein du service d'application dans le cadre de l'abonnement.
-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. Remarque: il doit être différent du nom de votre service d’application Orchestrator.
-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. 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 (Save).

   Attention : si vous n'avez pas précédemment créé d'application Azure AD et de principal de service à partir de l'installation d'Orchestrator sur Azure, créez-les maintenant. Vous devez les configurer pour pouvoir 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" }