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 aplicación y asígnale el nombre que corresponda, por ejemplo, UiPathActionCenter.
   Nota: en el menú desplegable Pila de tiempo de ejecución, 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 Registros de las aplicaciones y crea uno nuevo, con el nombre que corresponda.

   Importante: Debes asignar el rol de Contribuidor 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 simpático equipo de DevOps que te proporcione un ID y contraseña principales para el servicio de Azure, para acceder al servicio de la aplicación y a 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 demanda. Ponte 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 ejemplo de script.

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 2021.10 PaaS, ve a la configuración de Azure App Service y asegúrate de que las siguientes claves están presentes en el listado y que su valor se ha 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 desde el portal de Identity Management. Consulta la Configuración de ajustes de seguridad del host para obtener más detalles.
azureSubscriptionId	Obligatorio. El ID de suscripción de Azure para el servicio de aplicación que aloja Action Center. Nota: Lo encontrarás en la página Información general del servicio de la aplicación, en tu portal Azure.
azureAccountTenantId	Obligatorio. El ID de tenant de Azure. Nota: Lo encontrarás en la página Información general del registro de aplicaciones, en tu portal Azure.
azureAccountApplicationId	Obligatorio. El ID principal del servicio de Azure. Nota: es el que copió y guardó en el paso 5 del procedimiento de instalación de nodo único .
azureAccountPassword	Obligatorio. La contraseña del servicio principal de Azure. Nota: es el que copió y guardó en el paso 6 del procedimiento de instalación de un solo nodo .
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 la aplicación 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 contiene espacios en blanco.
    Nota: Reemplaza <ActionCenterServiceURL> con la URL correspondiente de tu servicio de Action Center.

    

Para habilitar OPTIONS en el web.config archivo 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 restablece el archivo web.config, así que tendrás que permitir el verbo OPTIONS de nuevo.

    Para proveedores de almacenamiento de terceros, consulta los 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