orchestrator
2023.10
false
UiPath logo, featuring letters U and I in white

Orchestrator 安装指南

Automation CloudAutomation Cloud Public SectorAutomation SuiteStandalone
上次更新日期 2024年12月5日

Azure 应用程序服务安装

概述

Azure 安装脚本使您能够在一个或多个节点上安装 Orchestrator。

重要提示:

1. 在下面列出的安装过程中,所有步骤都是必需的。如果不安装 Identity Server,Orchestrator 将无法工作。

2. 在开始安装 Orchestrator 之前,请确保证书由 Azure 信任的证书颁发机构颁发,例如 DigiCert。

3. 不支持 Azure Stack,因为可能会发生 API 不兼容性。 请使用 Azure Cloud 进行部署。

单节点安装

要在 Azure 应用程序服务上安装 Orchestrator,请执行以下步骤:

Orchestrator 步骤

  1. 在 Azure 门户的“应用程序服务”下,使用自定义名称(例如 UiPathOrchestrator)创建新的应用程序服务。创建网页应用程序时,请确保选择堆栈 .NET 8 (LTS)。有关详细信息,请参阅 Microsoft 官方文档
  2. 在 Azure 门户中打开新创建的网页应用程序,然后在“配置”选项卡上选择“常规设置”,并更改以下配置:
    • 平台设置为“64 位”
    • WebSockets 设置为“启用”
    • 将“FTP 状态”设置为“全部允许”。
  3. 在网页应用程序的“配置”>“应用程序设置”>“连接字符串”中,设置数据库连接字符串,名称为 Default。例如 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
    重要提示:
    • 此处提供的 Azure Server 用户必须拥有服务器级别的访问权限,数据库级别的访问权限不足以执行成功安装。
    • 确保将数据库连接字符串中的 TrustServerCertificate 属性设为 True
    • 确保选择 SQL Azure 作为数据库连接字符串的类型。
    • 要为测试自动化模块设置数据库连接字符串,请遵循 Publish-Orchestrator.ps1 参数中适用于 -testAutomationFeatureEnabled 参数的说明步骤。
    • 要为“更新服务器”模块设置数据库连接字符串,请遵循 Publish-Orchestrator.ps1 参数中适用于 -updateServerFeatureEnabled 参数的说明步骤。
  4. 我们的脚本支持以下两种 Azure PowerShell 身份验证机制:
  • 通过您自己的用户身份 - 使用 Azure PowerShell 登录时,请使用 -noAzureAuthentication 参数。
  • 通过服务主体 - 创建可以访问 Orchestrator 应用程序服务和资源组的 Azure AD 应用程序和服务主体。或者,请让友好的 DevOps 团队为您提供 Azure 服务主体 ID 和密码,该 ID 和密码可以访问应用程序服务和相关资源组。

身份服务器步骤

  1. 在 Azure 门户的“应用程序服务”下,使用自定义名称(例如 UiPathIdentity)创建新的应用程序服务。创建网页应用程序时,请确保选择堆栈 .NET 8 (LTS)。有关详细信息,请参阅 Microsoft 官方文件
  2. 在网页应用程序的配置>连接字符串中设置数据库连接字符串,名称为 DefaultConnection。例如,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
    重要提示:确保将数据库连接字符串中的 TrustServerCertificate 属性设为 True
  3. 导航到“设置”>“配置”>“常规设置”选项卡,然后进行以下配置更改:
    • 平台设置为“64 位”
    • 将“FTP 状态”设置为“全部允许”。
  4. 我们的脚本支持以下两种 Azure PowerShell 身份验证机制:
  • 通过您自己的用户身份 - 使用 Azure PowerShell 登录 时,请使用-noAzureAuthentication参数。
  • 创建可以访问身份应用程序服务和资源组的 Azure AD 应用程序和服务主体。或者,请让友好的 DevOps 团队为您提供 Azure 服务主体 ID 和密码,该 ID 和密码可以访问应用程序服务和相关资源组。

Webhook 步骤

  1. Azure 门户中,创建一个包含自定义名称的新网页应用程序,例如:UiPathWebhookService.
  2. 在“发布”字段中,选择“代码”
  3. 对于运行时堆栈,请选择“.NET Core 8 (LTS)”。
  4. 打开新的网页应用程序并导航到“设置”>“配置”>“常规设置”,然后进行以下配置更改:
    • 平台设置为“64 位”
    • 将“FTP 状态”设置为“全部允许”。
  5. 选择“保存”
    如果您以前没有通过 Azure 上的 Orchestrator 安装创建 Azure AD 应用程序和服务主体,请立即创建它们。您必须配置它们才能访问您的 UiPathWebhookService 和资源组。

资源目录步骤

  1. 在 Azure 门户的“应用程序服务”下,使用自定义名称(例如 UiPathResourceCatalogService)创建新的应用程序服务。创建网页应用程序时,请确保选择堆栈 .NET 8 (LTS)。有关详细信息,请参阅 Microsoft 官方文件
  2. 导航到“设置”>“配置”>“常规设置”选项卡,然后进行以下配置更改:
    • 平台设置为“64 位”
    • 将“FTP 状态”设置为“全部允许”。
  3. 在网页应用程序的配置>连接字符串中设置数据库连接字符串,名称为 DefaultConnection。例如,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. 我们的脚本支持以下两种 Azure PowerShell 身份验证机制:
  • 通过您自己的用户身份 - 使用 Azure PowerShell 登录 时,请使用-noAzureAuthentication参数。
  • 通过服务主体 - 创建可以访问资源目录应用程序服务和资源组的 Azure AD 应用程序和服务主体。或者,请让友好的 DevOps 团队为您提供 Azure 服务主体 ID 和密码,该 ID 和密码可以访问应用程序服务和相关资源组。

常规步骤

  1. UiPathOrchestrator.zip 存档下载到本地计算机。其中包含安装 Orchestrator、身份服务器、资源目录和 Webhook 服务所需的所有脚本。UiPath 可应要求提供 UiPathOrchestrator.zip 存档。请联系我们以获取详细信息。
  2. UiPathOrchestrator.zip 文件的内容提取到计算机上的文件夹中。这将显示 UiPath.Orchestrator.Web.zip 文件。
    备注:
    • 以下步骤需要运行 PowerShell 脚本。要禁用任何中断这些任务的提示,请在上一步选择的目录中运行 Get-ChildItem *.ps1 -Recurse | Unblock-File 命令。
    • 解压缩 UiPathOrchestrator.zip 存档以提取 UiPath.Orchestrator.Web.zip 存档。
  3. 使用此处描述的参数,在 PowerShell 中运行 Publish-Orchestrator.ps1 脚本。
    重要提示:
    • 在运行 Publish-Orchestrator.ps1 脚本之前,请确保卸载 AzureRM PowerShell 模块。我们建议使用 Az PowerShell 模块作为替代方案。不支持同时安装 AzureRM 和 Az 模块。
    • 如果未检测到所需的 Az 版本,并且在运行脚本时存在 AzureRM,则即使在无人值守的安装上,系统也会提示您确认是否删除 AzureRM。
    • 如果在使用任何先前版本的模块时升级到 Az v6.0.0,则系统会弹出以下消息:WARNING: The version 'x.x.x' of module 'Az.<Name>' is currently in use. Retry the operation after closing the applications.。为了解决此问题,请确保在新的 PowerShell 会话中执行 Publish-Orchestrator.ps1
    • 如果您使用的是 Microsoft 托管的代理,则 Publish-Orchestrator.ps1 问题将导致无法运行正确的 Az 版本。您将继续使用版本 4.7.0,而不是版本 5.4.0 或 6.0.0。要解决此问题,请确保删除 C:\Modules\az_4.7.0 文件夹。
  4. 使用此处描述的参数,在 PowerShell 中运行 Publish-IdentityServer.ps1 脚本。
    重要提示:确保执行发布到 Identity Server 页面中所述的步骤以完成上述过程。
  5. 使用此处描述的参数,在 PowerShell 中运行 MigrateTo-IdentityServer.ps1 脚本。
  6. 使用此处描述的参数,在 PowerShell 中运行 Publish-ResourceCatalog.ps1 脚本。
  7. 使用此处描述的参数,在 PowerShell 中运行 MigrateTo-ResourceCatalog.ps1 脚本。
  8. 使用此处描述的参数,在 PowerShell 中运行 Publish-Webhooks.ps1 脚本。
  9. 使用此处描述的参数,在 PowerShell 中运行 MigrateTo-Webhooks.ps1 脚本。
  10. 启动业务流程和身份应用程序服务。享受在 Azure 门户上使用 Orchestrator。

多节点安装

注意:多节点安装需要设置。

要在 Azure 应用程序服务的多个节点上安装 Orchestrator,请执行以下步骤:

Orchestrator 步骤

  1. 在 Azure 门户的“应用程序服务”下,使用自定义名称(例如 UiPathOrchestrator)创建新的应用程序服务。创建网页应用程序时,请确保选择堆栈 .NET 8 (LTS)。有关详细信息,请参阅 Microsoft 官方文档
  2. 在 Azure 门户中打开新创建的网页应用程序,然后在“配置”选项卡上选择“常规设置”,并更改以下配置:
    • 平台设置为“64 位”
    • WebSockets 设置为“启用”
  3. 在网页应用程序的“配置”>“应用程序设置”>“连接字符串”中设置数据库连接字符串,名称为“默认”。例如 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
    重要提示:
    • 此处提供的 Azure Server 用户必须拥有服务器级别的访问权限,数据库级别的访问权限不足以执行成功安装。
    • 确保将数据库连接字符串中的 TrustServerCertificate 属性设为 True
    • 确保选择 SQL Azure 作为数据库连接字符串的类型。
    • 不保留 Nlog 配置。
  4. 我们的脚本支持以下两种 Azure PowerShell 身份验证机制:
    • 通过您自己的用户身份 - 使用 Azure PowerShell 登录时,请使用 -noAzureAuthentication 参数。
    • 通过服务主体 - 创建可以访问 Orchestrator 应用程序服务和资源组的 Azure AD 应用程序和服务主体。或者,请让友好的 DevOps 团队为您提供 Azure 服务主体 ID 和密码,该 ID 和密码可以访问应用程序服务和相关资源组。
  5. 在“ 扩展(应用服务计划) ” 选项卡中,选择“ 扩展到特定的实例计数 ” 选项,并提供所需的“ 实例计数”。

身份服务器步骤

  1. 在 Azure 门户的“应用程序服务”下,使用自定义名称(例如 UiPathIdentity)创建新的应用程序服务。创建网页应用程序时,请确保选择堆栈 .NET 8 (LTS)。有关详细信息,请参阅 Microsoft 官方文件
  2. 在网页应用程序的配置>连接字符串中设置数据库连接字符串,名称为 DefaultConnection。例如,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
    重要提示:确保将数据库连接字符串中的 TrustServerCertificate 属性设为 True
  3. 导航到“设置”>“配置”>“常规设置”选项卡,然后为平台选择“64 位”
  4. 我们的脚本支持以下两种 Azure PowerShell 身份验证机制:
  • 通过您自己的用户身份 - 使用 Azure PowerShell 登录 时,请使用-noAzureAuthentication参数。
  • 创建可以访问身份应用程序服务和资源组的 Azure AD 应用程序和服务主体。或者,请让友好的 DevOps 团队为您提供 Azure 服务主体 ID 和密码,该 ID 和密码可以访问应用程序服务和相关资源组。

Webhook 步骤

  1. Azure 门户中,创建一个包含自定义名称的新网页应用程序,例如:UiPathWebhookService.
  2. 在“发布”字段中,选择“代码”
  3. 对于运行时堆栈,请选择“.NET 8 (LTS)”
  4. 打开新的网页应用程序并导航到“设置”>“配置”
  5. 在“常规设置”选项卡中,为平台选择“64 位”
  6. 选择“保存”
    如果您以前没有通过 Azure 上的 Orchestrator 安装创建 Azure AD 应用程序和服务主体,请立即创建它们。您必须配置它们才能访问您的 UiPathWebhookService 和资源组。

资源目录步骤

  1. 在 Azure 门户的“应用程序服务”下,使用自定义名称(例如 UiPathResourceCatalogService)创建新的应用程序服务。创建网页应用程序时,请确保选择堆栈 .NET 8 (LTS)。有关详细信息,请参阅 Microsoft 官方文件
  2. 导航到“设置”>“配置”>“常规设置”选项卡,然后为平台选择“64 位”
  3. 在网页应用程序的配置>连接字符串中设置数据库连接字符串,名称为 DefaultConnection。例如,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. 我们的脚本支持以下两种 Azure PowerShell 身份验证机制:
  • 通过您自己的用户身份 - 使用 Azure PowerShell 登录 时,请使用-noAzureAuthentication参数。
  • 通过服务主体 - 创建可以访问资源目录应用程序服务和资源组的 Azure AD 应用程序和服务主体。或者,请让友好的 DevOps 团队为您提供 Azure 服务主体 ID 和密码,该 ID 和密码可以访问应用程序服务和相关资源组。

常规步骤

  1. UiPathOrchestrator.zip 存档下载到本地计算机。其中包含安装 Orchestrator、身份服务器、资源目录和 Webhook 服务所需的所有脚本。UiPath 可应要求提供 UiPathOrchestrator.zip 存档。请联系我们以获取详细信息。
  2. 将 zip 文件的内容提取到计算机上的文件夹中。
    注意:以下步骤需要运行 PowerShell 脚本。要禁用任何中断这些任务的提示,请在上一步选择的目录中运行 Get-ChildItem *.ps1 -Recurse | Unblock-File 命令。
  3. 使用此处描述的参数,在 PowerShell 中运行 Publish-Orchestrator.ps1 脚本。
    重要提示:
    • 在运行 Publish-Orchestrator.ps1 脚本之前,请确保卸载 AzureRM PowerShell 模块。我们建议使用 Az PowerShell 模块作为替代方案。不支持同时安装 AzureRM 和 Az 模块。
    • 如果未检测到所需的 Az 版本,并且在运行脚本时存在 AzureRM,则即使在无人值守的安装上,系统也会提示您确认是否删除 AzureRM。
    • 如果在使用任何先前版本的模块时升级到 Az v6.0.0,则系统会弹出以下消息:WARNING: The version 'x.x.x' of module 'Az.<Name>' is currently in use. Retry the operation after closing the applications.。为了解决此问题,请确保在新的 PowerShell 会话中执行 Publish-Orchestrator.ps1
    • 如果您使用的是 Microsoft 托管的代理,则 Publish-Orchestrator.ps1 问题将导致无法运行正确的 Az 版本。您将继续使用版本 4.7.0,而不是版本 5.4.0 或 6.0.0。要解决此问题,请确保删除 C:\Modules\az_4.7.0 文件夹。
  4. 使用此处描述的参数,在 PowerShell 中运行 Publish-IdentityServer.ps1 脚本。
    注意:确保执行发布到 Identity Server 页面中所述的步骤以完成上述过程。
  5. 使用此处描述的参数,在 PowerShell 中运行 MigrateTo-IdentityServer.ps1 脚本。
  6. 使用此处描述的参数,在 PowerShell 中运行 Publish-ResourceCatalog.ps1 脚本。
  7. 使用此处描述的参数,在 PowerShell 中运行 MigrateTo-ResourceCatalog.ps1 脚本。
  8. 使用此处描述的参数,在 PowerShell 中运行 Publish-Webhooks.ps1 脚本。
  9. 使用此处描述的参数,在 PowerShell 中运行 MigrateTo-Webhooks.ps1 脚本。
  10. 启动业务流程和身份应用程序服务。享受在 Azure 门户上使用 Orchestrator。

此页面有帮助吗?

获取您需要的帮助
了解 RPA - 自动化课程
UiPath Community 论坛
Uipath Logo White
信任与安全
© 2005-2024 UiPath。保留所有权利。