automation-suite
2023.10
false
UiPath logo, featuring letters U and I in white
Linux 版 Automation Suite 安装指南
Last updated 2024年12月3日

步骤 3:部署后步骤

注意:使用 Azure Bastion 时,请记住,使用 \ 拆分为多行的复制粘贴命令可能无法按预期运行。为确保正确解释新行,请使用控制台的剪贴板微件。

验证安装

若要检查 Automation Suite 是否已成功安装,您必须转到 标志 容器内的存储帐户。 如果自动生成的名为 installResult 的文件(在容器中)的内容为 successful,则安装完成。 如果安装失败,则内容将为 failed

更新证书

安装流程会代表您生成自签名证书。这些证书符合 FIPS 140-2。您也可以通过 Azure 部署模板,选择在安装时提供由 CA 颁发的服务器证书,而不是使用自动生成的自签名证书。

自签名证书将在 90 天后过期,安装完成后,您必须将其替换为由受信任的 CA 签名的证书。如果不更新证书,安装将在 90 天后停止工作。

如果您在启用 FIPS 140-2 的主机上安装了 Automation Suite,并想要更新证书,请确保它们与 FIPS 140-2 兼容。

有关说明,请参阅管理证书

启用 FIPS 140-2

使用 Azure 部署模板完成 Automation Suite 安装后,您可以在计算机上启用 FIPS 140-2。有关说明,请参阅安全性与合规性

探索标志和日志

如果您需要有关 Automation Suite 安装流程或其他操作的更多信息,则可以从用于在集群部署和维护期间存储各种标志和日志的存储帐户入手。

若要找到存储帐户,请执行以下步骤:

  1. 导航到执行部署的资源组。
  2. 按资源类型“ 存储帐户”筛选。
  3. 找到名称以st结尾的存储帐户。 例如:


  4. 选择存储帐户,然后单击“ 容器” 。 您可以选择 flagslogs


标志容器

标志 容器存储编排所需的各种标志或文件,或者仅用于报告各种操作的状态。 在新集群上, 标志 容器内容通常如以下示例所示:



标志 容器中的文件用于编排各种操作,例如集群上的 Automation Suite 安装流程,或特定集群操作,例如实例刷新。 例如:

  • uipath-server-000000.success表示已在集群的该特定节点上成功完成基础架构安装;
  • 如果整体安装成功,则installResult将显示为success

日志容器

执行操作时,它通常会在 日志 容器中生成一个日志文件。 在新集群上, 日志 容器内容通常如以下示例所示:



日志 容器中的每个文件都代表安装过程中特定步骤的日志。 例如:

  • infra-uipath-server-000000.log存储基础架构安装日志;
  • fabric.log存储结构安装的日志;
  • services.log存储应用程序和服务安装的日志。

访问部署输出

安装完成后,您需要访问“输出”选项卡中的“部署输出”。

为此,请转到“资源组”,然后转到“部署”→“主模板”(或类似于 Microsoft. 模板 - DateTime)→“输出”。






部署输出

输出

描述

文档

文档链接。

URL

负载均衡器 URL。可用于直接访问。

如果启用了自定义域,则此域将用于真实名称绑定。

密钥保险库 URL

部署创建的密钥保险库的 Azure 门户 URL。它包含部署中使用的所有密码(凭据)。

ArgoCDURL

用于访问 ArgoCD 的 URL。这在 VNet 中可用。必须按照步骤 4:配置 DNS 中的说明设置对此 URL 的外部访问。

ArgoCD 密码

用于登录 ArgoCD 门户的密码。

主机管理员用户名和主机管理员密码

用于主机管理员的凭据。

集群管理 URL

DashboardMonitoringURL

仪表板 (Grafana) 监控工具的 URL:https://monitoring.<fqdn>/dashboard
确保将 <fqdn> 替换为您的 FQDN。

MetricsMonitoringURL

指标 (Prometheus) 监控工具的 URL:https://monitoring.<fqdn>/metrics
确保将 <fqdn> 替换为您的 FQDN。

AlertmanagerMonitoringURL

Alertmanager 监控工具的 URL:https://monitoring.<fqdn>/alertmanager
确保将 <fqdn> 替换为您的 FQDN。

部署中使用的所有凭据都作为密码存储在部署期间配置的密钥保险库中。要访问密码,请在“资源组”中筛选资源,搜索“保险库”,然后单击“密码”。

备注:
如果您在“密码”选项卡下看到“The operation “List” is not enabled in the key vault’s access policy”警告,请执行以下步骤:
  1. 转到“访问策略”→“添加访问策略”→“配置模板”→“密码管理”→“选择主体”。
  2. 选择您的用户,然后单击“保存”。
  3. 导航回“密码”。警告应该消失,并且密码应该是可见的。


访问集群虚拟机

虚拟机需在私有 VNet 中加以配置。您可以按照以下步骤通过 Azure 堡垒对其加以访问:

  1. 导航到已部署 Automation Suite 的资源组。
  2. 由于代理、GPU 代理和服务器虚拟机位于规模集内,因此您必须转到包含所需实例的规模集。


  3. 转到“设置”选项卡中的“实例”部分。


  4. 单击要连接的虚拟机的名称。


  5. 单击“连接”按钮,然后从下拉菜单中选择“堡垒”。


  6. 输入部署中提供的凭据(“管理员用户名”和“管理员密码”参数,您可以在“密码”下的凭据密钥库中找到这些参数),然后单击“连接”。


DNS 要求

步骤 1:准备 Azure 部署中所述,Automation Suite Azure 部署将创建一个具有公共 IP 和关联的 DNS 标签的负载均衡器。此 DNS 标签归 Microsoft 所有。

该部署还在集群 VNet 内配置了一个私有 DNS 区域,并添加了在安装和配置流程中使用的几个记录。

如果您选择从外部计算机连接,则无法使用私有 DNS 区域来解析各种服务的 DNS,因此您需要将这些记录添加到主机文件中。

有关更多详细信息,请参阅步骤 4:配置 DNS

现在,您应该能够连接到集群上运行的各种服务。

访问集群管理门户

集群管理门户是一个集中位置,您可以在此找到完成 Automation Suite 安装和执行常见的安装后操作所需的所有资源。有关详细信息,请参阅集群管理门户入门

要访问“集群管理”门户,请执行以下步骤:

转到以下 URL:https://${CONFIG_CLUSTER_FQDN}/uipath-management
注意:您不需要使用任何凭据即可访问集群管理门户。

访问 Automation Suite 常规界面

通用的 Automation Suite 用户界面可用作组织管理员和组织用户的门户。它是常见的组织级别资源,每个人都可以从中访问 Automation Suite 的所有区域:管理页面、平台级别页面、特定于服务的页面和特定于用户的页面。

要访问 Automation Suite,请执行以下步骤:

  1. 转到以下 URL:https://${Loadbalancer_dns},其中 <loadbalancer_dns> 是负载均衡器的 DNS 标签,位于“输出”下。
  2. 切换到默认组织。
  3. 用户名是组织管理员
  4. 依次转到“ 密钥保管库”、“密码”和“ 主机管理员密码”,以检索密码

访问主机管理

主机门户是系统管理员配置 Automation Suite 实例的地方。从该门户配置的设置将由您的所有组织继承,有些设置可以在组织级别覆盖。

要访问主机管理,请执行以下步骤:

  1. 转到以下 URL:https://${Loadbalancer_dns},其中 <loadbalancer_dns> 是负载均衡器的 DNS 标签,位于“输出”下。
  2. 切换到主机组织。
  3. 输入您先前指定的用户名作为 UiPath 管理员用户 名参数的值。
  4. 输入先前指定的密码作为“UiPath 管理员密码”参数的值。转到“密钥保险库”>“密码”>“主机管理员密码”,检索密码。

访问 ArgoCD

您可以使用 ArgoCD 控制台来管理已安装的产品。

要访问 ArgoCD,请执行以下步骤:

  1. 转到以下 URL:https://alm.${Loadbalancer_dns},其中 <loadbalancer_dns> 是负载均衡器的 DNS 标签,位于“输出”下。请注意,您必须按照步骤 4:配置 DNS 中的说明配置对此 URL 的外部访问。
  2. 用户名是管理员
  3. 要访问密码,请转到“输出”选项卡或凭据密钥保险库。

访问监控工具

首次访问监控工具时,请使用以下默认凭据以管理员身份登录:

  • 用户名: admin
  • 密码:要检索密码,请运行以下命令:
    kubectl get secrets/dex-static-credential -n uipath -o "jsonpath={.data['password']}" | base64 -dkubectl get secrets/dex-static-credential -n uipath -o "jsonpath={.data['password']}" | base64 -d

要在访问监控工具时更新用于 Dex 身份验证的默认密码,请执行以下步骤:

  1. 通过将 newpassword 替换为您的新密码来运行以下命令:
    password="newpassword"
    password=$(echo -n $password | base64)
    kubectl patch secret dex-static-credential -n uipath --type='json' -p="[{'op': 'replace', 'path': '/data/password', 'value': '$password'}]"password="newpassword"
    password=$(echo -n $password | base64)
    kubectl patch secret dex-static-credential -n uipath --type='json' -p="[{'op': 'replace', 'path': '/data/password', 'value': '$password'}]"
  2. 运行以下命令以更新密码:

    ./install-uipath.sh -i /opt/UiPathAutomationSuite/cluster_config.json -o ./output.json -f --accept-license-agreement./install-uipath.sh -i /opt/UiPathAutomationSuite/cluster_config.json -o ./output.json -f --accept-license-agreement

扩展集群

从部署中配置的计算资源由 Azure 规模集组成,可轻松实现扩展。

您可以手动将其他资源添加到特定的规模集,包括添加服务器节点、代理节点或专用代理节点(例如 GPU 节点)。

您可以通过识别特定的规模集并直接添加资源来执行手动扩展。

为此,请执行以下步骤:

  1. 转到 Azure 门户并筛选特定的规模集:


  2. 选择合适的规模集,然后单击“缩放比例”。


  3. 使用滑块或旁边的输入字段修改“实例计数”字段,然后单击“保存”。
    注意:对于服务器规模集,实例计数需要为奇数。
  4. 缩放操作应在后台启动,完成后即有新资源可用。

完成升级

执行 Automation Suite 集群升级后,Azure 模板部署需要进行一些更改,以确保新节点正确加入集群。 要自动执行更改,我们建议使用专用脚本。 有关说明,请参阅 Azure 部署模板文档

Azure 虚拟机生命周期操作

提示:

Azure 最多允许 15 分钟的窗口 准备关闭,而 Automation Suite 节点的正常终止从 20 分钟(对于代理和 GPU 代理节点)到几小时(对于服务器节点)不等。

为避免数据丢失,服务器的 VMSS 升级策略 设置为手动,并且服务器虚拟机已启用 对规模集操作的保护 。 因此,我们建议通过提供的 Runbook 管理服务器生命周期。

仅多节点 HA 就绪生产部署支持“实例刷新”、“删除节点”、“移除服务器”和“检查服务器区域恢复能力”Runbook。

运行任何 Runbook 后的服务器数量必须为奇数,且必须大于三(例如,如果有 4 台服务器,则无法执行实例刷新;如果总共有 5 台服务器,则无法删除服务器)。

VMSS 中的所有虚拟机都应处于Running状态。

一次只能运行一个 Runbook。

重要提示:

如果您使用 Azure for US Government,则 InstanceRefreshRemoveNodesRemoveServers Runbook 会受到一个问题的影响,该问题会导致节点删除操作失败。

混合工作器

我们所有的存储帐户和 SQL Server 都有私有端点。 混合工作者组运行现有的自动化操作,以便它们正常工作。

混合工作器是位于 VNET 中的虚拟机,将在其上运行各种自动化。

虚拟机通常是 Standard_D2s_v3Standard_F2s_v2,具体取决于您为服务器虚拟机选择的虚拟机以及是否允许配额。 部署完成后,虚拟机将关闭,以最大程度地降低成本。

Runbook 分为两类:常规 Runbook 和混合 Runbook。 您可以使用常规 runbook 启动操作并收集所有数据。 然后,常规 Runbook 启动混合工作者虚拟机和混合 Runbook,后者完成操作。

操作完成后,您可以关闭混合工作者虚拟机以限制成本。

下表描述了 runbook 细分:

常规 runbook

混合 runbook

AddGpuNodeHybridAddGpuNode
BackupClusterHybridBackupCluster
GetAllBackupsHybridGetAllBackups
InstanceRefreshHybridInstanceRefresh (+HybridCheckServerZoneRezilience)
RegisterAiCenterExternalOrchestratorHybridRegisterAiCenterExternalOrchestrator
RemoveNodesHybridRemoveNodes
RemoveServersHybridRemoveServers
RestoreClusterInitializeHybridRestoreClusterInitialize + HybridRestoreClusterSnapshot
ValidateFullInstall在部署结束时运行以验证完整安装。

InstanceRefresh

描述

实例刷新 Runbook 具有以下用例:

  • 更新服务器、代理和 GPU 规模集上的 VMSS 操作系统 SKU。
  • 为一个/多个 VMSS 执行节点轮换操作。
  • 预先应用于 VMSS 的其他 VMSS 配置更改。

用法

  1. 转到 Azure 门户并搜索名为“实例刷新”的资源。
  2. 单击“开始” 按钮以打开参数列表。 考虑以下因素,完成参数:
    • 仅当参数REFRESH<node_type>设置为True时,才会对 VMSS 执行节点轮换操作。 如果将多个REFRESH<node_type>参数设置为True ,则 VMSS 节点轮换顺序将为服务器 -> 代理 -> GPU 代理。
    • 您必须提供NEWOSVERSION参数才能更新 VMSS 操作系统 SKU。 您可以使用az vm image list-skus --location <deployment_location> --offer RHEL --publisher RedHat --output table找到可用的 Azure 市场虚拟机映像 SKU。 当前的虚拟机不会自动更新为最新模型(为此需要执行节点轮换操作)。

      单击“确定”按钮以启动 Runbook。



实施细节

实例刷新”Runbook 是“删除节点”Runbook 的包装器。因此,系统会在运行“删除节点”时追踪状态。它会更新所有 VMSS 操作系统版本(如果需要),并根据收到的参数提取节点轮换操作的主机名,并将其转发到“删除节点”。如果集群正好有三台服务器,则“实例刷新”Runbook 将创建三台新服务器;否则,“删除节点”将处理纵向扩展,以始终在每个可用区中至少存在一台服务器。

RemoveNodes

描述

删除节点”Runbook 具有以下用例:

  • 从 Automation Suite 集群中删除指定节点。
  • 为一个/两个虚拟机执行节点轮换操作。

用法

  1. 搜索要删除的节点的计算机名称。 为此,请转到 VMSS,然后单击Settings部分中的Instances


  2. 转到 Azure 门户并搜索名为“删除节点”的资源。
  3. 单击“开始” 按钮以打开参数列表。 请考虑以下因素,完成参数:
  • NODESTOBEREMOVEDCOMPUTERNAME是以逗号分隔的要删除的虚拟机的计算机名称列表(例如pxlqw-agent-000009,pxlqw-agent-00000A ),并且是唯一的必需参数。 我们建议一次从单个 VMSS 中删除节点。
  • ISINSTANCEREFRESHTHREESERVERSSCENARIO 是由“实例刷新”包装器填充的标志。

    单击“确定”按钮以启动 Runbook。



实施细节

删除节点”Runbook 使用递归方法来克服 3 小时超长超时。该 Runbook 从接收到的列表中删除或重新铺设前两个节点(选择数量是为了满足服务器的奇数限制),并使用剩余的列表重新运行 Runbook 的另一个实例。

节点的节点重新铺设操作需要执行以下步骤:

  1. 根据要删除的节点数量,使用一个或两个虚拟机横向扩展 VMSS。
  2. 对旧实例执行节点删除。

节点的节点删除操作需要执行以下步骤:

  1. 封锁并排空实例。 对于代理,此操作将在 20 分钟后超时,对于服务器,此操作将在number_of_instances * 60分钟后超时。
  2. 停止实例上的 rke 服务。 操作将在 5 分钟后超时。
  3. 从 Automation Suite 集群中删除节点并删除虚拟机。 对于代理,此操作将在 20 分钟后超时,对于服务器,此操作将在number_of_instances * 60分钟后超时。

RemoveServers

描述

移除服务器 Runbook 具有以下用例:

  • 从 Automation Suite 集群中删除服务器。

用法

  1. 转到 Azure 门户并搜索名为“移除服务器”的资源。
  2. 单击“开始” 按钮以打开参数列表。 请考虑以下因素,完成参数:
  • REMOVEDSERVERSCOUNT 是要删除的服务器数量。 我们建议一次删除的服务器不超过 2 台,以免达到 公平共享 超时。


实施细节

删除服务器”Runbook 将从具有最多虚拟机的可用区中删除作为参数接收的服务器数量。

CheckServerZoneResilience

描述

检查服务器区域恢复能力” Runbook 可扩展服务器 VMSS,并使用“移除服务器”Runbook 跨可用区平衡服务器。这是“实例刷新”流程的一部分,不应手动运行。

AddGpuNode

描述

在没有 GPU 节点的情况下创建初始部署的场景中,我们会创建虚拟机规模集,但要使用不同的 SKU,以防止出现区域/SKU 可用性问题。 此 Runbook 会将 SKU 更改为 GPU SKU,并添加一个节点。

重要提示:如果初始部署在没有 GPU 节点的情况下创建,则请勿缩放在运行此 Runbook 之前创建的初始 GPU VMSS。

用法

要使用此 Runbook,请执行以下步骤:

  1. 导航到已部署 Automation Suite 的资源组,然后识别并单击“自动化帐户”
  2. 单击“Runbook”,然后单击“添加 GPU 节点 Runbook”
  3. 为您想要的 SKU 命名,然后单击“开始”

参数:

skuName – GPU 节点 VMSS 的 SKU。

支持以下值:

  • Standard_NC8as_T4_v3
  • Standard_NC12s_v3
  • Standard_NC24s_v3

RegisterAiCenterExternalOrchestrator

描述

Runbook 会将 AI Center 注册到部署时提供的外部 Orchestrator。

用法

该文档公开了一个必需参数 IdentityToken,这是由外部身份服务生成的安装访问令牌。由于令牌的可用时间很短(大约 1-2 小时),我们建议在运行 Runbook 之前生成该令牌。有关说明,请参阅安装密钥

BackupCluster

描述

集群备份”Runbook 可帮助您备份集群。

用法

  1. 导航到已部署 Automation Suite 的资源组,然后识别并单击“自动化帐户”


  2. 单击“Runbook”,然后单击“备份集群 Runbook”


  3. 为要创建的备份提供名称。


  4. 要启动 Automation Suite 集群的备份操作,请单击页面顶部的“开始”按钮。


  5. 当 Runbook 作业的状态为Completed时,备份操作即告完成。 如果 Runbook 作业的状态为Failed ,则可以查看存储帐户中的日志以获取更多信息。


GetAllBackups

描述

获取所有备份”Runbook 可帮助您查看所有可用备份的列表,包括计划备份和手动备份。



还原集群初始化,还原快照

描述

这些 Runbook 可帮助您执行集群还原。

用法

注意:开启还原过程时,我们会将集群置于维护模式。还原过程成功后,我们会将集群退出维护模式。

要执行还原操作,请执行以下步骤:

  1. 确定要使用的还原文件。为此,请导航到您的 Automation Suite 部署自动化帐户,然后运行“获取全部备份”Runbook。




  2. Runbook 作业完成后,查看“输出”选项卡底部的可用备份列表。选择要在还原操作中使用的文件,然后将其复制。
  3. 导航回“自动化帐户”并运行“集群还原初始化”Runbook。对于参数,粘贴先前复制的备份文件的名称。此时,还原过程已启动。


  4. 还原快照”作业将自动启动。作业完成后,还原过程即告完成。
    注意:日志存在于 restores/<backup-name>/ 文件夹下,备份容器中的存储帐户(以 st 结尾)中,其中 backup-name 是用于执行还原的备份名称。
  5. 还原后,您应该确认集群处于良好状态(请参阅验证安装或任何 ArgoCD 故障排除链接)。之后,您可以选择在集群上启用备份,方法是使用与上一步中相同的参数运行“完成还原集群”Runbook。该操作将为集群启用备份。

故障排除

  • 如果虚拟机无法加入 Automation Suite 集群,系统将尝试回滚。 新创建的虚拟机将遵循与通常的节点删除相同的步骤(封锁、排出、停止 rke 服务、从集群中删除节点以及删除虚拟机)。 您可以在存储帐户中的 日志 容器内的 infra-<hostname>.log等 Blob 中找到加入节点过程的日志。
  • 如果删除节点时失败,任何 Runbook 都将停止并显示失败步骤的日志。要修复此问题,请手动或使用“删除节点”Runbook 完成该流程。您可以在“日志”容器内找到存储帐户中的所有日志,如下所示:

    • 警戒线和排水管 – <timestamp>-<runbook_abreviation>-drain_nodes.log
    • 停止 rke 服务 – <timestamp>-<runbook_abreviation>-stop_rke.log
    • 从集群中删除节点 – <timestamp>-<runbook_abreviation>-remove_nodes.log
  • 如果发生超时,您应该等待步骤完成执行,检查日志,然后手动或使用“删除节点”Runbook 完成流程。所有 Runbook 都使用 Azure 运行命令功能在虚拟机的上下文中执行代码。此方法的一个限制是它不返回执行状态。因此,封锁、排出和停止 rke 服务的步骤将异步运行,并且状态将使用以下格式的 Blob 保存:<timestamp>-<runbook_abreviation>-<step_name>.<success/fail>

此页面有帮助吗?

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