Scripts de Webhooks

Publicación en Webhooks

La tabla siguiente describe todos los parámetros que puedes usar con el script Publish-Webhooks.ps1.

Parámetro	Descripción
-action	Indica el escenario que se ejecuta, las opciones disponibles son: Deploy - especifica que se trata de una instalación limpia; Update: especifica que estás actualizando tu instancia de servicio de Webhook.
-azureAccountApplicationId	El ID principal del servicio de Azure. Nota: el principal servicio indicado debe asignarse el rol de Colaborador al servicio de aplicaciones en el ámbito de la suscripción.
-azureAccountPassword	La contraseña de token de Azure para el ID principal de servicio.
-azureSubscriptionId	El ID de suscripción de Azure para el Servicio de aplicaciones correspondiente.
-azureAccountTenantId	El ID de tenant de Azure.
-appServiceName	El nombre del servicio de aplicaciones de Azure de Webhook. Nota: este debe ser distinto a tu nombre del Servicio de aplicaciones de Orchestrator.
-orchestratorUrl	Obligatorio. La URL de la instancia de Orchestrator.
-resourceGroupName	El nombre del grupo de recursos de Azure que contiene el Servicio de aplicaciones de Webhook.
-package	Indica la ruta completa o relativa del archivo UiPath.WebhookService.zip.
-stopApplicationBeforePublish	Cuando está presente, detiene la aplicación antes de iniciar la implementación y luego la reinicia una vez que la implementación finaliza.

En tu instalación del servicio de aplicaciones de Azure de Orchestrator, también deberás realizar estos pasos para instalar el servicio Webhooks:

1. Desde tu portal de Azure, crea una nueva aplicación web con un nombre personalizado, por ejemplo: UiPathWebhookService.
2. En el campo Publicar, selecciona Código.
3. Para Pila de tiempo de ejecución selecciona .NET Core 3.1.
4. Abre tu nueva aplicación web y ve a Ajustes > Configuración.
5. Desde la pestaña Configuración general, selecciona 64 bits para la Plataforma.
6. Selecciona Guardar.
   Importante: Si no has creado previamente una aplicación y un servicio principal de Azure AD desde la instalación de Orchestrator en Azure, hazlo ahora.Tienes que configurarlos para poder acceder a tu UiPathWebhookService y a tu grupo de recursos.
7. Abre una ventana de Powershell y ejecuta el script Publish-Webhooks.ps1. Por ejemplo:

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

   Importante: La tabla siguiente describe todos los parámetros que puedes usar con el script Publish-Webhooks.ps1.

Migrar a Webhooks

La tabla siguiente describe todos los parámetros que puedes usar con el script MigrateTo-Webhooks.ps1.

Parámetros	Descripción
-cliPackage	Indica la ruta al archivo UiPath.WebhookService.Migrate.Cli.zip.
-azureDetails	Una tabla hash con los siguientes valores: azureAccountApplicationId: el ID principal del servicio de Azure. azureAccountPassword: la contraseña de token de Azure para el ID principal de servicio. azureSubscriptionId- El ID de suscripción de Azure para el servicio de aplicaciones respectivo. azureAccountTenantId: el ID de tenant de Azure.
-orchDetails	Una tabla hash con los siguientes valores: resourceGroupName - El nombre del grupo de recursos de Azure que contiene el Servicio de aplicaciones de Orchestrator. appServiceName- El nombre del servicio de aplicaciones de Orchestrator. targetSlot - La ranura del servicio de aplicaciones de destino establecida por Azure.
-webhooksDetails	Una tabla hash con los siguientes valores: resourceGroupName - El nombre del grupo de recursos de Azure que contiene Orchestrator App Service. appServiceName - el nombre del servicio de aplicaciones de Webhook. targetSlot - La ranura del servicio de aplicaciones de destino establecida por Azure.

Este script MigrateTo-Webhooks.ps1 se utiliza para migrar los datos desde una instancia de Orchestrator existente a un nuevo servicio de aplicaciones de Webhooks y establecer las configuraciones para ambas. El script da por supuesto que Orchestrator y los Webhooks ya han sido publicados.

.\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" }