- Primeros pasos
- Requisitos
- Mejores prácticas
- Instalación
- Consideraciones sobre la instalación
- Acerca de la instalación
- Scripts de Orchestrator
- Scripts de Identity Server
- Scripts de Webhooks
- Scripts del catálogo de recursos
- Despliegue de Azure Marketplace
- Implementación de AWS
- Herramienta de configuración de la plataforma
- Webhooks AppSettings.json
- Deshabilitar la telemetría
- Actualizando
- Servidor de identidad
- Solución de problemas de errores de inicio
Scripts de Orchestrator
Publish-Orchestrator.ps1
.
Parámetro |
Descripción |
---|---|
|
Obligatorio.Indica el tipo de escenario que quieres iniciar. Las siguientes opciones están disponibles:
|
|
Obligatorio.El ID principal del servicio de Azure. Ten en cuenta que a la entidad de servicio utilizada debe asignarse el perfil de colaborador al App Service en el ámbito de la suscripción. |
|
Obligatorio.La contraseña de token de Azure para el ID principal de servicio. |
|
Obligatorio.El ID de suscripción de Azure para el App Service que aloja Orchestrator. |
|
Obligatorio. El ID de tenant de Azure. |
|
Obligatorio.El nombre del grupo de recursos de Azure que contiene Orchestrator App Service. |
|
Obligatorio.El nombre de Orchestrator Azure App Service. |
|
Obligatorio.Indica la ruta completa del archivo
UiPath.Orchestrator.Web.zip .
|
|
Opcional.Especifica la ruta completa del archivo
UiPathActivities.zip , incluido de forma predeterminada, a partir de la versión v2018.4.4, en UiPathOrchestrator.zip . Esto te permite instalar la fuente de actividad local en Azure en el momento de la instalación.Ten en cuenta que este parámetro solo puede utilizarse con el tipo de repositorio Legacy . De lo contrario, tendrá que configurarse manualmente.
|
|
Opcional.Este parámetro habilita el módulo Probar automatización para las colas de datos de prueba, la ejecución de pruebas y la programación. Puedes habilitar esta característica en función de uno de los siguientes escenarios: Comenzar de cero con una instalación de Orchestrator limpia Realiza la siguiente configuración para tu App Service antes de ejecutar el
Publish-Orchestrator.ps1 script usando el -testAutomationFeatureEnabled parámetro :
Asegúrate de marcar esta configuración como
Deployment slot setting , especialmente, si utilizas ranuras del tipo intercambio en caliente (hotswap).
Habilitar Probar automatización después de la instalación de Orchestrator Si ya has implementado Orchestrator sin habilitar el módulo Probar automatización, ejecuta el script
Publish-Orchestrator.ps1 con los mismos parámetros que para una actualización, y añade el parámetro -testAutomationFeatureEnabled .
Actualizar Orchestrator Si actualizas tu instancia de Orchestrator, añade el parámetro
-testAutomationFeatureEnabled al script Publish-Orchestrator.ps1 antes de ejecutarlo.
Para obtener más información sobre la actualización de Orchestrator, consulta Actualización de Publish-Orchestrator.ps1. |
|
Opcional. Este parámetro habilita el módulo Actualizar servidor. Puedes habilitar esta característica en función de uno de los siguientes escenarios: Empezar de nuevo con una instalación limpia de Orchestrator Realiza la siguiente configuración para tu App Service antes de ejecutar el
Publish-Orchestrator.ps1 script usando el -updateServerFeatureEnabled parámetro :
Habilitar Actualizar servidor tras la instalación de Orchestrator Si ya has implementado Orchestrator sin habilitar el módulo Actualizar servidor, ejecuta el script
Publish-Orchestrator.ps1 con los mismos parámetros que para una actualización, y añade el parámetro -updateServerFeatureEnabled .
Actualizar Orchestrator Si actualizas tu instancia de Orchestrator, añade el parámetro
-updateServerFeatureEnabled al script Publish-Orchestrator.ps1 antes de ejecutarlo.
Para obtener más información sobre la actualización de Orchestrator, consulta Actualización de Publish-Orchestrator.ps1. |
|
Opcional.Esto solo se debe utilizar si quieres utilizar Elasticsearch para los registros. Facilita la URL de Elasticsearch como el valor, por ejemplo
"http://elasticserver:9200" .Si tu instancia de Orchestrator requiere autenticación, facilita los parámetros ElasticSearchUsername , ElasticSearchPassword , elasticSearchDiagnosticsUsername y elasticSearchDiagnosticsPassword .
|
|
Opcional. Este parámetro te permite enviar registros de UiPath Robot solo al servidor de Elasticsearch configurado. Facilita la URL de ElasticSearch como el valor, por ejemplo
"http://elasticserver:9200" . Ten en cuenta que solo puede utilizarse junto con el parámetro -robotsElasticSearchUrl . Si no facilitas este parámetro, los registros de UiPath Robot se envían a la base de datos SQL configurada y ElasticSearch.
|
|
Opcional.Este parámetro te permite indicar el nombre de usuario de tu instancia de Elasticsearch si está habilitada su autenticación. |
|
Opcional.Este parámetro te permite indicar la contraseña de tu instancia de Elasticsearch si está habilitada su autenticación. |
|
Opcional.Este parámetro te permite indicar el nombre de usuario de tu instancia de Elasticsearch si está habilitada su autenticación. Este parámetro, junto con
elasticSearchDiagnosticsPassword "Password" , es obligatorio para los registros internos de Orchestrator.
|
|
Opcional.Este parámetro te permite indicar la contraseña de tu instancia de Elasticsearch si está habilitada su autenticación.Este parámetro, junto con
elasticSearchDiagnosticsUsername "Username" , es obligatorio para los registros internos de Orchestrator.
|
|
Opcional.Utiliza Redis como base de datos para distribuir mensajes y caché a y desde todos los equipos conectados a través de tu equilibrador de carga. Si
-redisConnectionString está especificado, se establecerá automáticamente en true , de lo contrario, se establecerá en false .
|
|
Opcional.Solo se puede utilizar si
loadBalancerUseRedis está establecido en true . Una cadena de conexión que te permite configurar tu servidor Redis, que contiene la URL del servidor, la contraseña y el puerto utilizado con Redis. También es posible habilitar las conexiones cifradas de SSL entre los nodos de Orchestrator y el servicio Redis. Para obtener más información, haz clic aquí.
Ejemplos:
|
|
Opcional.Te ayuda a habilitar el servicio de Azure SignalR, lo que facilita la comunicación directa entre tu flota de UiPath Robots y el servicio SignalR (Orchestrator ya no mediará). Ten en cuenta que, si está habilitado, los UiPath Robots con una versión anterior a 2019.2 dependerán solo del protocolo de latidos para comunicarse con Orchestrator, lo que significa que cualquier comando que provenga de Orchestrator será recogido por un UiPath Robot cada 30 segundos.Ejemplo:
-azureSignalRConnectionString "Endpoint=https://doctest.signalr.net;AccessKey=M1ug+sBu07hyyi12AgyJ52SEd4OgC2Mm6BvllVHCC9c=;Version=1.0;" |
|
Opcional. Define el destino en el que se guardarán los medios de ejecución y los paquetes.Puede cumplimentarse con los siguientes destinos:
Si has invalidado el parámetro
UiPath.Orchestrator.dll.config Storage.Type en la sección Configuración de Azure App Service, al actualizar tendrás que traspasar este valor como un parámetro de script a Publish-Orchestrator.ps1 .
|
|
Opcional.Define la ubicación real en la que se guardarán los medios de ejecución y los paquetes. Particularidades:
Aquí tiene más información sobre estos tipos de implementaciones. Si has invalidado el parámetro
UiPath.Orchestrator.dll.config Storage.Location en la sección Configuración de Azure App Service, al actualizar tendrás que traspasar este valor como un parámetro de script a Publish-Orchestrator.ps1 .
|
|
Opcional.Solo puede utilizarse en escenarios de actualización.Si se especifica, el script implementa Orchestrator en la ranura del App Service indicada en lugar de la de producción. Además, se realizará una ranura de intercambio con la ranura de producción, sin tiempo de inactividad. Prerrequisitos:
|
|
Opcional.Solo puede utilizarse si la ranura de la implementación de Orchestrator App Service es diferente a la ranura del servicio de aplicaciones predeterminada de producción establecida por Azure. |
|
Opcional. Pares de valores clave de la configuración de la aplicación que se insertan en la sección de la configuración de Azure App Service después de la implementación. Ten en cuenta que esto solo se aplica a la configuración en la sección Configuración de aplicaciones del archivo UiPath.Orchestrator.dll.config. Puedes utilizar este parámetro para cambiar la configuración específica que no se muestra a través del script
Publish-Orchestrator.ps1 . Para el resto, utiliza su parámetro dedicado al implementar el script.
Ten en cuenta que la configuración existente se combinará con la nueva. |
|
Opcional.Si está presente, detiene la aplicación antes de su implementación y la inicia después de que esta finalice. |
|
Opcional.Si está presente, la implementación continúa sin confirmación del usuario. |
|
Opcional.Una cadena que contiene una lista de proveedores de depósitos separados por comas que quieres habilitar.Si no se especifica, se establece el valor predeterminado en
Orchestrator,Amazon,Azure,Minio .También tienes la posibilidad de habilitar el proveedor FileSystem añadiéndolo a esa lista.
Precaución: si utilizas el proveedor FileSystem y actualizas a la versión 20.10.7 o posteriores, deberás traspasar un valor que incluya
FileSystem para este parámetro.Si no lo haces, este proveedor estará deshabilitado y ya no podrás utilizar esos depósitos.
|
|
Obligatorio solo cuando se selecciona FileSystem como proveedor de depósitos.La lista de ubicaciones en la que quieres permitir que se creen depósitos para el proveedor FileSystem. Si habilitas el proveedor FileSystem, también deberás traspasar un valor para este parámetro. Los valores son una lista de rutas de acceso UNC, separadas por el símbolo de la pleca
| (p. ej., \\mysharedstorage\mybyckets\|\\myotherserver\myotherbuckets ).
|
|
Opcional.Te permite publicar en el Servicio de aplicaciones de Azure confiando en tu propia identidad de usuario sin tener que crear un director de servicio. Si se usa este parámetro, el conjunto de parámetros
UseServicePrincipal (que incluye elementos como la ID de aplicación de Azure, la contraseña, la ID de suscripción y la ID de tenant) ya no es necesario.
|
|
Opcional Te permite incluir la URL externa del servicio de la aplicación Orchestrator en los casos en que se utiliza una URL personalizada. Si no se rellena este parámetro, se usa la URL predeterminada del servicio de aplicaciones. |
-azureUSGovernmentLogin | Opcional. Este parámetro solo se utiliza para las implementaciones del gobierno de los Estados Unidos. |
UiPath.Orchestrator.dll.config
migrarán automáticamente y persistirán al llevar a cabo una actualización. Para cambiarlos, suministra nuevos valores al llamar al script Publish-Orchestrator.ps1
.
-NuGet.Packages.ApiKey
-NuGet.Activities.ApiKey
-NuGet.Packages.Path
-NuGet.Activities.Path
-machineKey/@decryption
-machineKey/@decryptionKey
-machineKey/@validationKey
-EncryptionKey
-NuGet.Repository.Type
-Storage.Type
-Storage.Location
-LoadBalancer.Redis.ConnectionString
-LoadBalancer.UseRedis
-Scalability.AzureSignalR.ConnectionString
-nlog/targets/target/@name=robotElasticBuffer/@name=RobotElastic/@uri
-nlog/targets/target/@name=robotElasticBuffer/@name=RobotElastic/@username
-nlog/targets/target/@name=robotElasticBuffer/@name=RobotElastic/@password
-nlog/rules/logger/@name=Robot.*/@writeTo
-nlog/targets/target/@name=serverElasticBuffer/@name=serverElastic/@uri
-nlog/targets/target/@name=serverElasticBuffer/@name=serverElastic/@username
-nlog/targets/target/@name=serverElasticBuffer/@name=serverElastic/@password
-nlog/targets/target/@name=serverElasticBuffer/@name=serverElastic/@index
-nlog/rules/logger/@name=*/@writeTo
-NuGet.Packages.ApiKey
-NuGet.Activities.ApiKey
-NuGet.Packages.Path
-NuGet.Activities.Path
-machineKey/@decryption
-machineKey/@decryptionKey
-machineKey/@validationKey
-EncryptionKey
-NuGet.Repository.Type
-Storage.Type
-Storage.Location
-LoadBalancer.Redis.ConnectionString
-LoadBalancer.UseRedis
-Scalability.AzureSignalR.ConnectionString
-nlog/targets/target/@name=robotElasticBuffer/@name=RobotElastic/@uri
-nlog/targets/target/@name=robotElasticBuffer/@name=RobotElastic/@username
-nlog/targets/target/@name=robotElasticBuffer/@name=RobotElastic/@password
-nlog/rules/logger/@name=Robot.*/@writeTo
-nlog/targets/target/@name=serverElasticBuffer/@name=serverElastic/@uri
-nlog/targets/target/@name=serverElasticBuffer/@name=serverElastic/@username
-nlog/targets/target/@name=serverElasticBuffer/@name=serverElastic/@password
-nlog/targets/target/@name=serverElasticBuffer/@name=serverElastic/@index
-nlog/rules/logger/@name=*/@writeTo
-unattended
y registra sus pasos en el nivel -verbose
.
.\Publish-Orchestrator.ps1 `
-action "Deploy" `
-unattended `
-package "E:\Work\Orch\Setup\UiPath.Orchestrator.Web.zip" `
-stopApplicationBeforePublish `
-azureSubscriptionId "8e34be72-1937-4aa0-b70e-81bab19gbf0a" `
-azureAccountTenantId "f8350d2a-n153-4d17-8927-902c51f72797" `
-azureAccountApplicationId "$AzureApplicationId" `
-azureAccountPassword "$AzurePassword" `
-resourceGroupName "DocTest-Orch-RG" `
-appServiceName "DocTests123" `
-testAutomationFeatureEnabled
-updateServerFeatureEnabled
-storageType "Azure" `
-storageLocation "DefaultEndpointsProtocol=https;AccountName=usr;AccountKey=...;EndpointSuffix=core.windows.net" `
-robotsElasticSearchUrl "http://docelasticserver:9200" `
-verbose
.\Publish-Orchestrator.ps1 `
-action "Deploy" `
-unattended `
-package "E:\Work\Orch\Setup\UiPath.Orchestrator.Web.zip" `
-stopApplicationBeforePublish `
-azureSubscriptionId "8e34be72-1937-4aa0-b70e-81bab19gbf0a" `
-azureAccountTenantId "f8350d2a-n153-4d17-8927-902c51f72797" `
-azureAccountApplicationId "$AzureApplicationId" `
-azureAccountPassword "$AzurePassword" `
-resourceGroupName "DocTest-Orch-RG" `
-appServiceName "DocTests123" `
-testAutomationFeatureEnabled
-updateServerFeatureEnabled
-storageType "Azure" `
-storageLocation "DefaultEndpointsProtocol=https;AccountName=usr;AccountKey=...;EndpointSuffix=core.windows.net" `
-robotsElasticSearchUrl "http://docelasticserver:9200" `
-verbose
-unattended
y registra sus pasos en el nivel -verbose
.
.\Publish-Orchestrator.ps1 `
-action "Deploy" `
-unattended `
-package "E:\Work\Orch\Setup\UiPath.Orchestrator.Web.zip" `
-stopApplicationBeforePublish `
-azureSubscriptionId "8e34be72-1937-4aa0-b70e-81bab19gbf0a" `
-azureAccountTenantId "f8350d2a-n153-4d17-8927-902c51f72797" `
-azureAccountApplicationId "$AzureApplicationId" `
-azureAccountPassword "$AzurePassword" `
-resourceGroupName "DocTest-Orch-RG" `
-appServiceName "DocTests123" `
-redisConnectionString "docs123.redis.cache.windows.net:6380,passwprd=******,ssl=True" `
-azureSignalRConnectionString "Endpoint=https://doctest.signalr.net;AccessKey=*****;Version=1.0;" `
-robotsElasticSearchUrl "http://docelasticserver:9200" `
-storageType "Azure" `
-storageLocation "DefaultEndpointsProtocol=https;AccountName=usr;AccountKey=...;EndpointSuffix=core.windows.net" `
-verbose
.\Publish-Orchestrator.ps1 `
-action "Deploy" `
-unattended `
-package "E:\Work\Orch\Setup\UiPath.Orchestrator.Web.zip" `
-stopApplicationBeforePublish `
-azureSubscriptionId "8e34be72-1937-4aa0-b70e-81bab19gbf0a" `
-azureAccountTenantId "f8350d2a-n153-4d17-8927-902c51f72797" `
-azureAccountApplicationId "$AzureApplicationId" `
-azureAccountPassword "$AzurePassword" `
-resourceGroupName "DocTest-Orch-RG" `
-appServiceName "DocTests123" `
-redisConnectionString "docs123.redis.cache.windows.net:6380,passwprd=******,ssl=True" `
-azureSignalRConnectionString "Endpoint=https://doctest.signalr.net;AccessKey=*****;Version=1.0;" `
-robotsElasticSearchUrl "http://docelasticserver:9200" `
-storageType "Azure" `
-storageLocation "DefaultEndpointsProtocol=https;AccountName=usr;AccountKey=...;EndpointSuffix=core.windows.net" `
-verbose
-unattended
y registra sus pasos en el nivel -verbose
.
Publish-Orchestrator.ps1 `
-action Update `
-unattended `
-package "E:\Work\Orch\Setup\UiPath.Orchestrator.Web.zip" `
-stopApplicationBeforePublish `
-azureSubscriptionId "8e34be72-1937-4aa0-b70e-81bab19gbf0a" `
-azureAccountTenantId "f8350d2a-n153-4d17-8927-902c51f72797" `
-azureAccountApplicationId "$AzureApplicationId" `
-azureAccountPassword "$AzurePassword" `
-resourceGroupName "DocTest-Orch-RG" `
-appServiceName "DocTests123" `
-verbose
Publish-Orchestrator.ps1 `
-action Update `
-unattended `
-package "E:\Work\Orch\Setup\UiPath.Orchestrator.Web.zip" `
-stopApplicationBeforePublish `
-azureSubscriptionId "8e34be72-1937-4aa0-b70e-81bab19gbf0a" `
-azureAccountTenantId "f8350d2a-n153-4d17-8927-902c51f72797" `
-azureAccountApplicationId "$AzureApplicationId" `
-azureAccountPassword "$AzurePassword" `
-resourceGroupName "DocTest-Orch-RG" `
-appServiceName "DocTests123" `
-verbose
Webhooks.Enabled
y Telemetry.Enabled
a false
. El procedimiento tiene lugar de forma -unattended
y registra sus pasos en el nivel -verbose
.
Publish-Orchestrator.ps1 `
-action Update `
-unattended `
-package "E:\Work\Orch\Setup\UiPath.Orchestrator.Web.zip" `
-stopApplicationBeforePublish `
-azureSubscriptionId "8e34be72-1937-4aa0-b70e-81bab19gbf0a" `
-azureAccountTenantId "f8350d2a-n153-4d17-8927-902c51f72797" `
-azureAccountApplicationId "$AzureApplicationId" `
-azureAccountPassword "$AzurePassword" `
-resourceGroupName "DocTest-Orch-RG" `
-appServiceName "DocTests123" `
-appSettings @{"Webhooks.Enabled"="false"; "Telemetry.Enabled"="false"} `
-verbose
Publish-Orchestrator.ps1 `
-action Update `
-unattended `
-package "E:\Work\Orch\Setup\UiPath.Orchestrator.Web.zip" `
-stopApplicationBeforePublish `
-azureSubscriptionId "8e34be72-1937-4aa0-b70e-81bab19gbf0a" `
-azureAccountTenantId "f8350d2a-n153-4d17-8927-902c51f72797" `
-azureAccountApplicationId "$AzureApplicationId" `
-azureAccountPassword "$AzurePassword" `
-resourceGroupName "DocTest-Orch-RG" `
-appServiceName "DocTests123" `
-appSettings @{"Webhooks.Enabled"="false"; "Telemetry.Enabled"="false"} `
-verbose