安装 Automation Suite

此页面将引导您完成 Automation Suite 在 AKS 和 EKS 上的安装说明。

开始之前，请考虑以下事项：

• 在 AKS/EKS 上部署和管理 Automation Suite 时，需要具备 Kubernetes、AWS 和 Azure 云资源管理知识。如果您在 AKS/EKS 上安装和配置 Automation Suite 时遇到问题，请联系 UiPath™ 专业服务。

• 在选择部署配置文件之前，请参阅 部署方案。

• 安装流程会代表您生成自签名证书。 安装完成后，应立即将其替换为由受信任的证书颁发机构 (CA) 签名的证书。 有关说明，请参阅 管理证书。

• Automation Suite 支持在 AKS 节点上启用联邦信息处理标准 140-2 (FIPS 140-2)。有关详细信息，请参阅安全性与合规性。您无法在 EKS 节点上启用 FIPS 140-2。

步骤 1：配置基础架构先决条件

在安装 Automation Suite 之前，您必须在环境中配置云资源。 其中包括以下各项：

• AKS 或 EKS 集群
• 离线安装必需：符合 OCI 的外部注册表
• 对象存储 - Azure Blob 或 Amazon S3
• 块存储
• 文件存储
• 数据库
• 缓存
• 网络（例如 VNET/VPC、DNS、子网、NSG/安全组、NAT 网关、弹性 IP 和互联网网关）
• 网络策略
• 证书

有关先决条件的说明，请参阅先决条件预览。

可选：配置代理

如果对面向互联网的流量使用代理服务器，则在配置代理时必须允许列出 URL 并使用no_proxy设置。 有关如何配置代理的说明，请参阅代理。

步骤 2：配置符合 OCI 的外部注册表

在离线安装中，您需要一个符合 OCI（开放容器计划）的注册表来存储容器映像和部署 Helm 图表。

有两种方法可以将 Automation Suite 工件上传到外部符合 OCI 的注册表：

• 选项 A：通过使用 UiPath™ 注册表镜像符合 OCI 的注册表；
• 选项 B：通过使用离线捆绑包结合符合 OCI 的注册表。

步骤 3：在客户端计算机上下载软件

您必须在管理计算机上安装以下软件。管理计算机是指用于操作集群并且可以通过 kubeconfig 文件访问集群的计算机。您的管理计算机可以运行 Linux、Windows 或 MacOS。

要通过客户端计算机在集群上成功运行先决条件检查、安装和安装后步骤，需要以下工具。

工具	描述	下载
uipathctl	必需。uipathctl 是一个 UiPath™ 命令行工具，可用于对 Azure Kubernetes Service (AKS) 和 Amazon Elastic Kubernetes Service (EKS) 上托管的 Automation Suite Kubernetes 运行命令。 您可以使用uipathctl检查环境中的先决条件，安装 Automation Suite，使用单个统一 CLI 进行配置和管理。 有关更多信息，包括uipathctl操作的完整列表，请参阅此处。	下载 uipathctl 运行 uipathctl
versions.json	必需。需要执行先决条件检查和安装步骤。	下载 versions.json
kubectl	可选。确保 kubectl 与集群的版本相符	下载 kubectl

步骤 4：配置 input.json

您必须编辑 input.json 文件来为 uipathctl 安装程序提供所需的输入，并执行操作（例如配置 SQL 连接字符串和要启用的 UiPath™ 服务）。

我们为 AKS 和 EKS 提供不同的 input.json 模板文件。 有关如何配置 input.json的说明，请参阅 配置 input.json。

或者，您可以使用自己的 Automation Suite 堆栈组件。 有关组件的详细信息，请参阅 EKS/AKS 堆栈上的Automation Suite 。 有关如何配置您自带的组件的详细信息，请参阅 自带组件。

如果您执行离线安装，请确保配置符合 OCI 的外部注册表。

要在 EKS/AKS 上以离线模式安装 Automation Suite，您必须采取以下附加步骤：

• 在 input.json 文件中将 install_type 参数的值显式设置为 offline；

• 配置符合 OCI 的外部注册表。

步骤 5：使用 uipathctl 访问集群

uipathctl 需要访问 KubeAPI 服务器才能执行集群级别的操作，例如部署、创建资源等。 为了访问 KubeAPI 服务器， uipathctl 使用 kubeconfig 文件，该文件包含访问集群所需的管理员级别凭据。 此文件必须位于本地（管理）计算机的 ~/.kube/config 文件夹（默认位置）中。

（可选）如果您担心将 kubeconfig 文件存储在默认位置，则可以在每次执行 uipathctl期间借助 --kubeconfig 标志为其提供 标志。

例如，您可以使用 AWS CLI 或 Azure CLI 通过首选方法更新 ~/.kube/config 文件。

步骤 6：检查基础架构先决条件

先决条件检查可确保在开始安装 Automation Suite 之前正确配置了所需的 Cloud 基础架构，并且客户端计算机可以访问该基础架构。

安装程序可以代表您自动生成以下配置：

• 如果在 input.json 文件中设置了 sql.create_db 键，则在 SQL Server 上安装所需的 SQL 数据库。
• Cloud 提供程序中所需的对象存储桶（如果在配置文件中设置了 external_object_storage.create_bucket 键）。

要允许安装程序生成这些配置，请运行以下命令：

uipathctl prereq create input.json --versions versions.json

重要提示：

uipathctl prereq create 命令不会创建 Process Mining 所需的 SQL 数据库。您必须按照使用自己的数据库中的说明手动创建它们。

要根据您在 input.json中配置的输入检查先决条件，请运行以下命令：

uipathctl prereq run input.json --versions versions.json

要检查安装的先决条件，请运行 。默认情况下，该命令会检查所有先决条件。但是，该命令也允许您严格运行与您相关的检查：

• 如果要从执行中排除组件，请使用 --excluded 标志。例如，如果您不想检查数据库连接字符串，请运行 uipathctl prereq --excluded SQL。该命令运行所有先决条件检查，与 SQL 相关的检查除外。
• 如果您只想在执行中包含某些组件，请使用 --included 标志。例如，如果您只想检查 DNS 和对象存储，请运行 uipathctl prereq --included DNS,OBJECTSTORAGE。

备注：

您可以在此处找到可以在先决条件检查中包含或排除的组件名称。在此示例中，每个缩进的行上的第一个单词表示组件名称。例如：SQL、对象存储、DNS 等。

重要提示： 由于客户端限制，而非优先级和公平性，您可能会收到来自 AKS 的限制消息，例如“等待 1.0447523 秒”。 在这种情况下，请等待命令完全完成，否则请尝试重新运行。

有关输出结果示例，请参阅 输出示例：先决条件检查。

先决条件检查

建议运行先决条件检查，以确保您正确配置了云基础架构，并在开始安装 Automation Suite 之前验证 input.json。

您可以使用命令运行先决条件检查。 默认情况下，该命令会验证所有先决条件。 可以使用以下标志：

• 如果要从执行中排除组件，请使用--excluded
• 如果要访问详细的先决条件检查输出，请使用--verbose 。 可以跳过此标志，以获得更加简明和简化的输出。

先决条件和运行状况检查/测试在 uipath-check 命名空间中运行。您必须允许创建 uipath-check 命名空间，或在运行检查/测试之前自行创建。除此之外，某些检查/测试要求您允许 uipath-check 和 uipath 命名空间之间的通信，或者允许使用 hostNetwork。

下表中的检查在每个节点上运行：

选中	描述
SQL 连接	验证 Automation Suite 是否可以使用 input.json 中提供的 SQL 连接字符串成功连接到 UiPath™ 产品和共享服务（例如身份、门户、组织管理等）的 SQL Server。这是成功安装所必需的一环。
SQL DB 角色	验证 UiPath™ 产品所需的必要角色和权限。这是成功安装所必需的一环。
SQL DB 兼容性	验证 SQL DB 兼容性要求。
FQDN 解析	验证 FQDN 和子域是否可成功解析。
对象存储 API	验证是否可根据 input.json 中提供的访问权限信息访问对象存储 API。这是成功安装 UiPath™ 服务的必要条件。
缓存/Redis	验证与 Cloud Redis 或 ElastiCache 的连接。 这是成功安装的必需项。
容量	根据 input.json中启用的产品，验证您具有最小工作程序节点的 CPU 和 RAM 容量。
存储类	验证是否已根据 Automation Suite Robot 的要求配置文件存储的存储类。
可选组件	验证集群是否具有您选择从 Automation Suite 安装中排除的组件。
入口	验证集群入口是否已正确配置，以及 FQDN URL 请求是否可以到达 UiPath™ 产品。
网络策略	检查 Automation Suite 中配置的网络策略是否与集群兼容。
注册表	验证 Automation Suite 是否可以访问 UiPath™ Docker 注册表。这是成功安装所必需的一环。
集群连接	验证集群通信是否配置正确： 在两个随机 Pod 之间完成 在 Pod 与多节点 ClusterIP 之间 在 Pod 与不带集群 IP 的多节点 ClusterIP 之间 使用主机网络在 Pod 到多节点 ClusterIP 之间 在 Pod 与使用主机网络设置的未设置 clusterIP 的多节点 ClusterIP 之间 通过 ClusterIP 在同一节点上并置的两个 Pod 之间

步骤 7：安装 Automation Suite

备注：

要查看 AKS/EKS 上的 Automation Suite 可用的部署方案，请参阅部署方案。

1. 成功验证先决条件后，您可以通过运行以下命令继续安装 Automation Suite ：

   uipathctl manifest apply input.json --versions versions.json

   有关输出示例，请参阅 输出示例：Automation Suite 安装。
   备注：

   如果在运行安装时遇到问题，请使用所有参数和标志重新运行安装命令。 有关您可能遇到的问题的详细信息，请参阅故障排除。

2. 要验证安装是否成功以及服务是否正常，请运行以下命令：

   uipathctl health check