- Primeros pasos
- Requisitos
- Mejores prácticas
- Instalación
- Actualizando
- Servidor de identidad
- Solución de problemas de errores de inicio
Publicar en Orchestrator
La siguiente tabla describe todos los parámetros que se pueden utilizar con Publish-Orchestrator.ps1.
| Parámetro | Descripción |
|---|---|
|
|
Obligatorio. Indica el tipo de escenario que quieres iniciar. Las siguientes opciones están disponibles:
|
|
|
Mandatory. The Azure service principal ID. Please note that the used service principal needs to be assigned the Contributor role to the app service at the subscription scope. |
|
|
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 |
|
|
Opcional. Especifica la ruta completa del archivo |
|
|
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 Configure the following settings for your App Service before running the
:fa-exclamation-circle: Asegúrate de marcar esta configuración como 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 Actualizar Orchestrator Si actualizas tu instancia de Orchestrator, añade el parámetro For more details about upgrading Orchestrator, see Publish-Orchestrator.ps1 Update. |
|
|
Opcional. Este parámetro habilita el módulo y la característica de Insights. 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 Servicio de aplicaciones antes de ejecutar el script
Habilitación de Insights tras la instalación de Orchestrator Si ya has implementado Orchestrator sin habilitar el módulo de Insights, ejecuta el script Actualizar Orchestrator Si actualizas tu instancia de Orchestrator, añade el parámetro For more details about upgrading Orchestrator, see Publish-Orchestrator.ps1 Update. |
|
|
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 Configure the following settings for your App Service before running the
Habilitar Actualizar servidor tras la instalación de Orchestrator Si ya has implementado Orchestrator sin habilitar el módulo Actualizar servidor, ejecuta el script Actualizar Orchestrator Si actualizas tu instancia de Orchestrator, añade el parámetro For more details about upgrading Orchestrator, see Publish-Orchestrator.ps1 Update. |
|
|
Opcional. Esto solo se debe utilizar si quieres utilizar Elasticsearch para los registros. Facilita la URL de Elasticsearch como el valor, por ejemplo |
|
|
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 |
|
|
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 |
|
|
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 |
|
|
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 |
|
|
Optional. It can only be used if 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: |
|
|
Opcional. Define el destino en el que se guardarán los medios de ejecución y los paquetes. Puede completarse con los siguientes destinos:
Si has invalidado el parámetro |
|
|
Opcional. Define la ubicación real en la que se guardarán los medios de ejecución y los paquetes. Particularidades:
More information on these deployments types is available here. Si has invalidado el parámetro |
|
|
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. |
|
|
Optional. Key-value pairs of application settings that are pushed to the Azure App Service Configuration section after deployment. Keep in mind that this only applies to settings from the App Settings section of the UiPath.Orchestrator.dll.config file. You can use this parameter to change specific settings that are not exposed through the 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 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 |
|
|
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 |
|
|
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 |
|
|
Optional. Allows you to include the external URL of the Orchestrator app service in cases where a custom URL is used. If this parameter is not populated, the app service default URL is used instead. |
-azureUSGovernmentLogin | Opcional. Este parámetro solo se utiliza para las implementaciones del gobierno de EE. UU. |
Parámetros que persisten en la actualización
Los siguientes valores del parámetro 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
Ejemplos
Instalación de nodo único
El siguiente ejemplo te permite llevar a cabo una instalación limpia de Orchestrator en un nodo, utilizar Elasticsearch para los registros y guardar paquetes en Azure Blob Storage y sus metadatos en la base de datos SQL. El procedimiento tiene lugar de forma -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
Instalación multinodo
El siguiente ejemplo te permite llevar a cabo una instalación limpia de Orchestrator en múltiples nodos y utilizar Elasticsearch para los registros y Redis para la distribución de mensajes y la caché. Los paquetes se guardan en Azure Blob Storage y sus metadatos en la base de datos SQL. El procedimiento tiene lugar de forma -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
Actualización multinodo
El siguiente ejemplo te permite actualizar un Orchestrator multinodo existente a la versión más reciente disponible sin cambiar ninguna configuración preexistente. 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" `
-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
El siguiente ejemplo te permite actualizar un Orchestrator multinodo existente a la versión más reciente disponible y cambiar solo el valor de los parámetros 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