Action Center: instalación de Azure PaaS

El script de instalación de Azure te permite instalar Action Center en uno o múltiples nodos.

Importante:

Todos los pasos en los procedimientos de instalación enumerados a continuación son obligatorios.

Antes de empezar

Asegúrate de que tienes las siguientes herramientas instaladas en tu equipo:

• PowerShell Web Deploy Snapin
• Módulo PowerShell AzureAZ versión 7.0 o superior.

Instalación de nodo único

Crear el servicio de aplicación de Azure para Action Center

1. Navega a tu portal de Azure y busca los servicios de aplicación.
2. Crea un nuevo servicio de aplicaciones y nómbralo como corresponda, por ejemplo UiPathActionCenter.
   Nota:

   Desde el menú desplegable de Runtime selecciona .NET Core 3.1.

3. Abre la aplicación web creada previamente y navega a Configuración > Configuración general desde el menú izquierdo y establece el campo Plataforma en 64 bits.

Crear el servicio principal de Azure para el Centro de Acción

1. En el portal de Azure, busca los registreos de aplicaciones y crea uno nuevo, nombrándolo como corresponda.

   Importante:

   Debes asignar el rol de colaborador al registro de la aplicación. Consulta aquí cómo hacerlo.

2. En la página Información general de tu aplicación, copia el ID de aplicación (cliente) y guárdalo para uso posterior. Ese es el ID de tu servicio principal de Azure.

   

3. En la página Clientes y secretos del registro de aplicación creado previamente, genera un nuevo secreto de cliente. Copia su Valor y guárdalo para uso posterior. Esa es la contraseña de tu servicio principal de Azure.

   

   Nota:

   Opcionalmente, puedes pedir a tu equipo de DevOps que te proporcione un ID y una contraseña principales de servicio de Azure que puedan acceder al servicio de la aplicación y su grupo de recursos asociado.

Instalación de Action Center en Azure

1. Descarga el archivo UiPathActionCenter.zip en tu máquina local. Contiene todos los scripts de instalación necesarios.

   Nota:

   UiPath proporciona el archivo UiPathActionCenter.zip bajo petición. Póngase en contacto con nosotros para obtener más información.

2. Extrae el contenido del archivo .zip en una carpeta en tu equipo.

3. Ejecuta el script Publish-ActionCenter-Azure.ps1 en PowerShell, utilizando estos parámetros de instalación.

   Consulta este script de ejemplo.

4. Disfruta utilizando Action Center en tu portal de Azure.

Instalación multinodo

La instalación multinodo es similar a la instalación de nodo único, con un paso adicional entre los pasos 6 y 7 del procedimiento de nodo único.

Por tanto, después del paso 6 deberás hacer lo siguiente:

• Abre el servicio de aplicación recién creado.
• Ve a la pestaña Escala (plan de servicio de aplicación) del menú izquierdo.
• Establece la Escala en una opción de recuento de instancia específica.
• Proporciona el recuento de instancia deseado.

Después, continúa con el paso 7 del proceso de nodo único.

Importante:

Después de migrar o actualizar a Orchestrator 2022.4PaaS, ve a la configuración del Servicio de aplicaciones de Azure y asegúrate de que las siguientes claves están presentes en la lista y su valor está establecido como true:

• IdentityServer.OAuth.Enabled
• IdentityServer.S2SIntegration.Enabled

Parámetros de script de instalación de Powershell

Nota:

Si quieres utilizar un dominio personalizado para tu servicio de aplicación de Action Center, establece el dominio personalizado primero y, a continuación, utiliza ese nombre de dominio en los parámetros de script. Por ejemplo, si tu dominio personalizado es https://actioncenter.xyz.com, utiliza el mismo valor para el parámetro del script actionCenterUrl.

Parámetro	Descripción
orchestratorUrl	Obligatorio . La URL de la instancia de Orchestrator.
identityServerUrl	Obligatorio . La URL de la instancia de Identity Server.
actionCenterUrl	Obligatorio . La URL de la instancia de ActionCenter.
identityInstallationAccessToken	Obligatorio . El token de acceso del Portal de gestión de identidades. Consulta Configuración de autenticación de host para obtener más información.
azureSubscriptionId	Obligatorio . El ID de suscripción de Azure para el servicio de aplicaciones que aloja Action Center. Nota: Lo encontrarás en la página Información general del servicio de aplicaciones, en tu portal de Azure.
azureAccountTenantId	Obligatorio . El ID de tenant de Azure. Nota: Lo encontrarás en la página Información general del registro de la aplicación, en tu portal de Azure.
azureAccountApplicationId	Obligatorio . El ID principal del servicio de Azure. Nota: es el que copiaste y guardaste en el paso 5 del procedimiento de instalación de nodo único .
azureAccountPassword	Obligatorio . La contraseña principal del servicio de Azure. Nota: es el que copiaste y guardaste en el paso 6 del procedimiento de instalación de nodo único .
package	Obligatorio . Indica la ruta completa o relativa del archivo UiPath.ActionCenter.Web.zip . Nota: lo encontrarás en el archivo UiPath.Actioncenter.zip .
resourceGroupName	Obligatorio . El nombre del grupo de recursos de Azure que contiene el servicio de aplicación de Action Center.
appServiceName	Obligatorio . El nombre del servicio de aplicación de Azure de Action Center.
stopApplicationBeforePublish	Opcional. Si está presente, detiene la aplicación antes de su implementación y la inicia después de que esta finalice.
unattended	Opcional. Si está presente, la implementación continúa sin confirmación del usuario.

Ejemplo de script en PowerShell

.\Publish-ActionCenter-Azure.ps1 `
    -orchestratorUrl "https://<OrchestratorServiceURL>" `
    -identityServerUrl "https://<IdentityServerURL>/identity" `
    -actionCenterUrl "https://<ActionCenterServiceURL>" `
    -identityInstallationAccessToken "abcdefgh ... MAxJeysh6IQFSabcd" `
    -azureSubscriptionId "d12f123e-12ac-1da1-1234-ed1234d5cf4b" `
    -azureAccountTenantId "d1234d2a-b123-1d12-1234-902c51f12345" `
    -azureAccountApplicationId "12345678-67e1-123d-1234-1c6cd123b123" `
    -azureAccountPassword "O.T5pX4bX89I3~Wi.clbM_u0-R5Aa-sRl~" `
    -package "E:\)\)Work\)\)UiPathActionCenter\)\)UiPath.ActionCenter.Web.zip" `
    -stopApplicationBeforePublish `
    -resourceGroupName "<ResourceGroupName" `
    -appServiceName "<ActionCenterServiceName>" `
    -unattended

Solicitudes de depósitos de almacenamiento

Las características de Action Center que utilizan los depósitos de almacenamiento dentro de Orchestrator, como las imágenes y el renderizado de PDF en las acciones de formulario, calsificación de documentos y validación de documentos requieren la siguiente configuración en Orchestrator:

Para aceptar las solicitudes de Action Center en Orchestrator:

• Abre la aplicación web de Orchestrator en tu portal Azure.
• Navega a Configuración y selecciona Configuración de aplicación.
• Añade una Nueva configuración de aplicación e introduce lo siguiente:
  • Nombre - AcceptedRootUrls
  • Valor - https://localhost:6234,https://<ActionCenterServiceURL>

Importante:

Asegúrate de que el valor introducido en el campo Valor no tenga espacios vacíos.

Nota:

Replace <ActionCenterServiceURL> with the corresponding URL of your Action Center Service.

Para permitir OPTIONS en el archivo web.config de la aplicación web de Orchestrator:

• Abre la aplicación web de Orchestrator en tu portal Azure.

• Navega a Editor del servicio de aplicación (vista previa).

• Edita el archivo web.config.

  • Ve a la sección <requestFiltering><verbs>.
  • Añade <add verb="OPTIONS" allowed="true" /> al final de la sección.
  Nota:

  Actualizar Orchestrator reestablece el archivo web.config, por lo que deberás permitir el verbo OPTIONS de nuevo.

  Para proveedores de almacenamiento de terceros, consulta más detalles sobre la configuración de CORS/CSP.

Actualización

Para actualizar Azure PaaS Action Center, debes instalar una nueva versión superior que sustituya a la actual.

Desinstalando

Para eliminar Action Center de tu portal Azure, elimina los siguientes recursos de Azure:

• Servicio de aplicación de Action Center
• Registro de aplicación de Action Center