Instalación de Azure App Service

Información general

El script de instalación de Azure te permite instalar Orchestrator en uno o varios nodos.

Importante:

1. Todos los pasos son obligatorios en los procedimientos de instalación que se enumeran a continuación. Orchestrator no funciona sin instalar Identity Server.

2. Antes de iniciar la instalación de Orchestrator, asegúrese de que sus certificados han sido emitidos por una entidad de certificación de confianza para Azure, como DigiCert.

3. Azure Stack no es compatible, ya que pueden producirse incompatibilidades de API. Utilice Cloud Azure para su implementación.

Instalación de nodo único

Para instalar Orchestrator en un servicio de aplicaciones de Azure realiza los siguientes pasos:

Pasos de Orchestrator

1. En el portal de Azure, en los servicios de aplicaciones, crea un nuevo servicio de aplicaciones con un nombre personalizado como UiPathOrchestrator. Al crear la aplicación web, asegúrate de seleccionar el Stack .NET Core 3.1. Para obtener más información, consulta la documentación oficial de Microsoft .
2. Abre la aplicación web recientemente creada en el portal de Azure y en la pestaña Configuración, selecciona Configuración general y luego realiza los siguientes cambios de configuración:
   • Establece la Plataforma en 64 bit.
   • Establece Web Sockets como Activado.
3. Establece la cadena de conexión de la base de datos en la Configuración > Configuración de la aplicación > Cadenas de conexión de la aplicación web, con el nombre Default. Por ejemplo, Server=13.13.13.13;Initial Catalog=UiPath;Persist Security Info=False;User ID=dbUser;Password=pass123; MultipleActiveResultSets=False;Encrypt=True; Connection Timeout=30;TrustServerCertificate=True.
   Importante:

   • El usuario SQL de Azure que se proporciona aquí debe tener acceso en el ámbito de servidor, no es suficiente el acceso en el ámbito de la base de datos para que la instalación se realice correctamente.
   • Asegúrate de establecer el TrustServerCertificate atributo en la cadena de conexión de la case de datos como True.
   • Para establecer una cadena de conexión a la base de datos para el módulo Actualizar servidor, sigue los pasos descritos para el parámetro -testAutomationFeatureEnabled en parámetros de Publish-Orchestrator.ps1.
   • Para establecer una cadena de conexión a la base de datos para el módulo Actualizar servidor, sigue los pasos descritos para el parámetro -updateServerFeatureEnabled en parámetros de Publish-Orchestrator.ps1.
4. El mecanismo de autenticación de Azure PowerShell admitido por nuestros scripts puede ser uno de los dos siguientes:

• Mediante tu propia identidad de usuario: utiliza el parámetro -noAzureAuthentication al iniciar sesión con Azure PowerShell.
• Mediante un director de servicio: crea una aplicación y un director de servicio de Azure AD que puedan acceder a tu Servicio de aplicaciones y Grupo de recursos de Orchestrator. De manera opcional, pregunta a tu equipo de DevOps que te proporcionen un ID y una contraseña de servicio principal para acceder al Grupo de recursos asociado y al servicio de aplicaciones.

Pasos del Identity Server

1. En el portal de Azure, en los servicios de aplicaciones, crea un nuevo servicio de aplicaciones con un nombre personalizado como UiPathIdentity. Al crear la aplicación web, asegúrate de seleccionar el Stack .NET Core 3.1. Para obtener más información, consulta la documentación oficial de Microsoft.
2. Establece la cadena de conexión de la base de datos en la Configuración > Cadenas de conexión de la aplicación web, con el nombre DefaultConnection. Por ejemplo, Server=13.13.13.13;Initial Catalog=UiPath;Persist Security Info=False;User ID=dbUser;Password=pass123; MultipleActiveResultSets=False;Encrypt=True; Connection Timeout=30;TrustServerCertificate=True
   Asegúrate de establecer el TrustServerCertificateatributo en la cadena de conexión de la case de datos como True.
3. Ve a la pestaña Ajustes > Configuración > Configuración general y selecciona 64-bit en la Plataforma.
4. El mecanismo de autenticación de Azure PowerShell admitido por nuestros scripts puede ser uno de los dos siguientes:

• Mediante tu propia identidad de usuario: utiliza el parámetro -noAzureAuthentication al iniciar sesión con Azure PowerShell.
• Mediante un director de servicio: crea una aplicación y un director de servicio de Azure AD que puedan acceder al Servicio de aplicaciones y Grupo de recursos de Identity. De manera opcional, pregunta a tu equipo de DevOps que te proporcionen un ID y una contraseña de servicio principal para acceder al Grupo de recursos asociado y al servicio de aplicaciones.

Pasos de 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.

Pasos del catálogo de recursos

1. En el portal de Azure, en los servicios de aplicaciones, crea un nuevo servicio de aplicaciones con un nombre personalizado como UiPathResourceCatalogService. Al crear la aplicación web, asegúrate de seleccionar el Stack .NET Core 6. Para obtener más información, consulta la documentación oficial de Microsoft.
2. Ve a la pestaña Ajustes > Configuración > Configuración general y selecciona 64-bit en la Plataforma.
3. Establece la cadena de conexión de la base de datos en la Configuración > Cadenas de conexión de la aplicación web, con el nombre DefaultConnection. Por ejemplo, Server=13.13.13.13;Initial Catalog=UiPath;Persist Security Info=False;User ID=dbUser;Password=pass123; MultipleActiveResultSets=False;Encrypt=True; Connection Timeout=30;TrustServerCertificate=True
4. El mecanismo de autenticación de Azure PowerShell admitido por nuestros scripts puede ser uno de los dos siguientes:

• Mediante tu propia identidad de usuario: utiliza el parámetro -noAzureAuthentication al iniciar sesión con Azure PowerShell.
• Mediante un director de servicio: crea una aplicación y un director de servicio de Azure AD que puedan acceder a tu Servicio de aplicaciones y Grupo de recursos del Catálogo de recursos. De manera opcional, pregunta a tu equipo de DevOps que te proporcionen un ID y una contraseña de servicio principal para acceder al Grupo de recursos asociado y al servicio de aplicaciones.

Pasos generales

1. Descarga el archivo UiPathOrchestrator.zip en tu máquina local. Este contiene todos los scripts necesarios para instalar Orchestrator, Identity Server, Catálogo de recursos y el servicio de Webhooks. UiPath proporciona el archivo UiPathOrchestrator.zip bajo demanda. Ponte en contacto con nosotros para obtener más información.
2. Extrae el contenido del archivo UiPathOrchestrator.zip en una carpeta en tu equipo. Esto revela el archivo UiPath.Orchestrator.Web.zip.
   Nota:

   • Los siguientes pasos requieren ejecutar los scripts de PowerShell. Para deshabilitar avisos que puedan interrumpir estas tareas, ejecuta el comando Get-ChildItem *.ps1 -Recurse | Unblock-File en el directorio seleccionado en el paso anterior.
   • Descomprime el archivo UiPathOrchestrator.zip para extraer el archivo UiPath.Orchestrator.Web.zip.
3. Ejecuta el script Publish-Orchestrator.ps1, en PowerShell, utilizando los parámetros tal y como se describe aquí.
   Importante:

   • Antes de ejecutar el script Publish-Orchestrator.ps1, asegúrate de desinstalar el módulo de AzureRM PowerShell. Recomendamos utilizar el módulo de Az PowerShell como alternativa. No se puede tener instalados a la vez los módulos de AzureRM y Az al mismo tiempo.
   • Si no se detecta la versión de Az deseada, y AzureRM está presente al ejecutar el script, se te solicitará que confirmes la eliminación de AzureRM incluso en instalaciones no atendidas.
   • La actualización a Az v6.0.0 cuando se está usando cualquier versión anterior del módulo hace que se muestre el siguiente mensaje: WARNING: The version 'x.x.x' of module 'Az.<Name>' is currently in use. Retry the operation after closing the applications. Para solucionar este problema, asegúrate de ejecutar Publish-Orchestrator.ps1 en una nueva sesión de PowerShell.
   • Si utilizas agentes alojados por Microsoft, un problema Publish-Orchestrator.ps1 te impide ejecutar la versión de Az correcta. En lugar de utilizar la versión 5.4.0 o 6.0.0, tienes la versión 4.7.0. Como solución, asegúrate de eliminar la carpeta C:\Modules\az_4.7.0.
4. Ejecuta el script Publish-IdentityServer.ps1, en PowerShell, utilizando los parámetros tal y como se describe aquí.
   Importante: Asegúrate de completar el proceso realizando los pasos descritos en la página Publicar en Identity Server.
5. Ejecuta el script MigrateTo-IdentityServer.ps1, en PowerShell, utilizando los parámetros tal y como se describe aquí.
6. Ejecuta el script Publish-ResourceCatalog.ps1, en PowerShell, utilizando los parámetros tal y como se describe aquí.
7. Ejecuta el script MigrateTo-ResourceCatalog.ps1, en PowerShell, utilizando los parámetros tal y como se describe aquí.
8. Ejecuta el script Publish-Webhooks.ps1, en PowerShell, utilizando los parámetros tal y como se describe aquí.
9. Ejecuta el script MigrateTo-Webhooks.ps1, en PowerShell, utilizando los parámetros tal y como se describe aquí.
10. Inicia los servicios de la aplicación Orchestrator e Identidad. Disfruta de Orchestrator en tu portal de Azure.

Instalación multinodo

Nota: las instalaciones multinodo requieren la configuración de .

Para instalar Orchestrator en varios nodos en un servicio de aplicaciones de Azure realiza los siguientes pasos:

Pasos de Orchestrator

1. En el portal de Azure, en los servicios de aplicaciones, crea un nuevo servicio de aplicaciones con un nombre personalizado como UiPathOrchestrator. Al crear la aplicación web, asegúrate de seleccionar el Stack .NET 6 (LTS). Para obtener más información, consulta la documentación oficial de Microsoft .
2. Abre la aplicación web recientemente creada en el portal de Azure y en la pestaña Configuración, selecciona Configuración general y luego realiza los siguientes cambios de configuración:
   • Establece la Plataforma en 64 bit.
   • Establece Web Sockets como Activado.
3. Establece la cadena de conexión de la base de datos en la Configuración > Configuración de la aplicación > Cadenas de conexión de la aplicación web, con el nombre "Default". Por ejemplo, Server=13.13.13.13;Initial Catalog=UiPath;Persist Security Info=False;User ID=dbUser;Password=pass123; MultipleActiveResultSets=False;Encrypt=True; Connection Timeout=30;TrustServerCertificate=True.
   Importante:

   • El usuario SQL de Azure que se proporciona aquí debe tener acceso en el ámbito de servidor, no es suficiente el acceso en el ámbito de la base de datos para que la instalación se realice correctamente.
   • Asegúrate de establecer el TrustServerCertificate atributo en la cadena de conexión de la case de datos como True.
   • Asegúrate de seleccionar SQL Azure como el tipo de string de conexión de base de datos.
   • La configuración de Nlog no se conserva.
4. El mecanismo de autenticación de Azure PowerShell admitido por nuestros scripts puede ser uno de los dos siguientes:
   • Mediante tu propia identidad de usuario: utiliza el parámetro -noAzureAuthentication al iniciar sesión con Azure PowerShell.
   • Mediante un director de servicio: crea una aplicación y un director de servicio de Azure AD que puedan acceder a tu Servicio de aplicaciones y Grupo de recursos de Orchestrator. De manera opcional, pregunta a tu equipo de DevOps que te proporcionen un ID y una contraseña de servicio principal para acceder al Grupo de recursos asociado y al servicio de aplicaciones.
5. En la pestaña Escalado (plan de App Service), selecciona la opción Escalar a un recuento de instancia determinado y proporciona el recuento de instancia deseado.

Pasos del Identity Server

1. En el portal de Azure, en los servicios de aplicaciones, crea un nuevo servicio de aplicaciones con un nombre personalizado como UiPathIdentity. Al crear la aplicación web, asegúrate de seleccionar el Stack .NET 6 (LTS). Para obtener más información, consulta la documentación oficial de Microsoft.
2. Establece la cadena de conexión de la base de datos en la Configuración > Cadenas de conexión de la aplicación web, con el nombre DefaultConnection. Por ejemplo, Server=13.13.13.13;Initial Catalog=UiPath;Persist Security Info=False;User ID=dbUser;Password=pass123; MultipleActiveResultSets=False;Encrypt=True; Connection Timeout=30;TrustServerCertificate=True
   Importante:

   • Asegúrate de establecer el TrustServerCertificate atributo en la cadena de conexión de la case de datos como True.
   • Asegúrate de seleccionar SQL Azure como el tipo de string de conexión de base de datos.
3. Ve a la pestaña Ajustes > Configuración > Configuración general y selecciona 64-bit en la Plataforma.
4. El mecanismo de autenticación de Azure PowerShell admitido por nuestros scripts puede ser uno de los dos siguientes:

• Mediante tu propia identidad de usuario: utiliza el parámetro -noAzureAuthentication al iniciar sesión con Azure PowerShell.
• Mediante un director de servicio: crea una aplicación y un director de servicio de Azure AD que puedan acceder al Servicio de aplicaciones y Grupo de recursos de Identity. De manera opcional, pregunta a tu equipo de DevOps que te proporcionen un ID y una contraseña de servicio principal para acceder al Grupo de recursos asociado y al servicio de aplicaciones.

Pasos de 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 la pila del runtime selecciona .NET Core 6 (LTS).
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.

Pasos del catálogo de recursos

1. En el portal de Azure, en los servicios de aplicaciones, crea un nuevo servicio de aplicaciones con un nombre personalizado como UiPathResourceCatalogService. Al crear la aplicación web, asegúrate de seleccionar el Stack .NET 6 (LTS). Para obtener más información, consulta la documentación oficial de Microsoft.
2. Ve a la pestaña Ajustes > Configuración > Configuración general y selecciona 64-bit en la Plataforma.
3. Establece la cadena de conexión de la base de datos en la Configuración > Cadenas de conexión de la aplicación web, con el nombre DefaultConnection. Por ejemplo, Server=13.13.13.13;Initial Catalog=UiPath;Persist Security Info=False;User ID=dbUser;Password=pass123; MultipleActiveResultSets=False;Encrypt=True; Connection Timeout=30;TrustServerCertificate=True
4. El mecanismo de autenticación de Azure PowerShell admitido por nuestros scripts puede ser uno de los dos siguientes:

• Mediante tu propia identidad de usuario: utiliza el parámetro -noAzureAuthentication al iniciar sesión con Azure PowerShell.
• Mediante un director de servicio: crea una aplicación y un director de servicio de Azure AD que puedan acceder a tu Servicio de aplicaciones y Grupo de recursos del Catálogo de recursos. De manera opcional, pregunta a tu equipo de DevOps que te proporcionen un ID y una contraseña de servicio principal para acceder al Grupo de recursos asociado y al servicio de aplicaciones.

Pasos generales

1. Descarga el archivo UiPathOrchestrator.zip en tu máquina local. Este contiene todos los scripts necesarios para instalar Orchestrator, Identity Server, Catálogo de recursos y el servicio de Webhooks. UiPath proporciona el archivo UiPathOrchestrator.zip bajo demanda. Ponte en contacto con nosotros para obtener más información.
2. Extrae el contenido del archivo comprimido en una carpeta en tu máquina.
   Nota: los siguientes pasos requieren ejecutar los scripts de PowerShell. Para deshabilitar avisos que puedan interrumpir estas tareas, ejecuta el comando Get-ChildItem *.ps1 -Recurse | Unblock-File en el directorio seleccionado en el paso anterior.
3. Ejecuta el script Publish-Orchestrator.ps1, en PowerShell, utilizando los parámetros tal y como se describe aquí.
   Importante:

   • Antes de ejecutar el script Publish-Orchestrator.ps1, asegúrate de desinstalar el módulo de AzureRM PowerShell. Recomendamos utilizar el módulo de Az PowerShell como alternativa. No se puede tener instalados a la vez los módulos de AzureRM y Az al mismo tiempo.
   • Si no se detecta la versión de Az deseada, y AzureRM está presente al ejecutar el script, se te solicitará que confirmes la eliminación de AzureRM incluso en instalaciones no atendidas.
   • La actualización a Az v6.0.0 cuando se está usando cualquier versión anterior del módulo hace que se muestre el siguiente mensaje: WARNING: The version 'x.x.x' of module 'Az.<Name>' is currently in use. Retry the operation after closing the applications. Para solucionar este problema, asegúrate de ejecutar Publish-Orchestrator.ps1 en una nueva sesión de PowerShell.
   • Si utilizas agentes alojados por Microsoft, un problema Publish-Orchestrator.ps1 te impide ejecutar la versión de Az correcta. En lugar de utilizar la versión 5.4.0 o 6.0.0, tienes la versión 4.7.0. Como solución, asegúrate de eliminar la carpeta C:\Modules\az_4.7.0.
4. Ejecuta el script Publish-IdentityServer.ps1, en PowerShell, utilizando los parámetros tal y como se describe aquí.
   Importante: Asegúrate de completar el proceso realizando los pasos descritos en la página Publicar en Identity Server.
5. Ejecuta el script MigrateTo-IdentityServer.ps1, en PowerShell, utilizando los parámetros tal y como se describe aquí.
6. Ejecuta el script Publish-ResourceCatalog.ps1, en PowerShell, utilizando los parámetros tal y como se describe aquí.
7. Ejecuta el script MigrateTo-ResourceCatalog.ps1, en PowerShell, utilizando los parámetros tal y como se describe aquí.
8. Ejecuta el script Publish-Webhooks.ps1, en PowerShell, utilizando los parámetros tal y como se describe aquí.
9. Ejecuta el script MigrateTo-Webhooks.ps1, en PowerShell, utilizando los parámetros tal y como se describe aquí.
10. Inicia los servicios de la aplicación Orchestrator e Identidad. Disfruta de Orchestrator en tu portal de Azure.