离线多节点 HA 就绪生产安装

概述

重要提示：

在继续安装之前，您必须满足硬件和软件先决条件。 请参阅 硬件和软件要求。

您可以使用专用脚本来验证安装先决条件和基础架构就绪情况。 请参阅 验证先决条件。

为了获得流畅的安装体验，请确保遵循我们的最佳实践。请参阅 。

安装流程包含以下一般步骤：

步骤	描述
步骤 1：下载安装包	您必须从可以访问互联网的 Linux 或 Windows 计算机以及计划部署 Automation Suite 的离线计算机执行此步骤。安装包下载完成后，您可以继续执行后续步骤。 步骤 1.1：下载安装包 步骤 1.2：获取第一台计算机上所有下载的文件
步骤 2：配置安装	运行交互式安装程序以配置安装选项。 该工具收集大多数常见安装选项的输入，并生成您可以在安装过程中使用的配置文件。 （可选）配置高级安装选项。 交互式安装程序提供默认体验，配置选项数量有限。要自定义已安装的产品，请为特定产品设置单独的 SQL 服务器等，请编辑配置文件。 步骤 2.1：默认配置 步骤 2.2：（可选）高级配置
步骤 3：复制所有计算机上的安装文件	在第一台计算机上，将下载的文件复制到交互式安装程序在步骤 2 中创建的安装文件夹中。 在其他集群计算机上，将整个安装文件夹从第一台计算机复制到每台计算机上的相同文件夹路径。 步骤 3：复制所有计算机上的安装文件
步骤 4：运行安装	创建集群并加入所有计算机。从第一台计算机安装套件的其余部分。 步骤 4：运行安装
步骤 5：完成安装	步骤 5：您已成功完成安装，可以转到安装后步骤。 您现在可以访问新创建的集群和套件、更新证书、调整 PVC 大小等。 步骤 5：完成安装

重要提示：

RHEL 内核版本 kernel-4.18.0-477.10.1.el8_8 受到中断 Automation Suite 集群安装或管理的问题的影响。请确保在安装前或安装后，没有 Automation Suite 节点使用此内核版本。您可以通过运行以下命令来更新内核版本：

dnf install -y kernel kernel-tools kernel-tools-libs

步骤 1：下载安装包并在第一台计算机上获取所有文件

步骤 1.1：下载安装包

您必须在可访问互联网的计算机上以及要安装 Automation Suite 的离线环境中的计算机上执行此步骤。

备注：

此计算机可以是 Linux 或 Windows。本指南中的命令适用于基于 RHEL 的操作系统。对于 Windows 或其他操作系统，请调整特定于这些环境的等效命令。

Automation Suite 安装程序是多个包的包装器，它还使用 Red Hat 包管理器 (RPM) 安装一些依赖项。它提供交互式体验，可帮助您配置外部资源，例如 SQL 和其他安装选项。

在可访问互联网的单独计算机上

本节说明如何获取启动安装流程所需的文件。

1. 连接到可访问互联网的计算机并运行以下命令以获取交互式向导文件：

   ssh <user>@<dns_of_vm>

2. 如果您使用了 ssh 密钥，请运行以下命令：

   ssh -i <path/to/Key.pem> <user>@<dns_of_vm>

3. 下载以下包：
   • installUiPathAS.sh – 必需。 有关下载说明，请参阅 installUiPathAS.sh 。
   • as-installer.zip – 必需项。有关下载说明，请参阅 as-installer.zip。
   • as.tar.gz – 可选。仅在使用内部 Docker 注册表时需要在服务器节点上使用。有关下载说明，请参阅 as.tar.gz。
   • as-infra.tar.gz - 必需。有关下载说明，请参阅 as-infra.tar.gz。
   • du-ondemand.tar.gz – 可选。仅 Document Understanding 需要。有关下载说明，请参见 du-onDemand.tar.gz。
     备注：

     不遵循此可选步骤将限制 Document Understanding 服务的功能。

   • cv-ondemand.tar.gz – 可选。仅 Computer Vision 需要。有关下载说明，请参见 du-onDemand.tar.gz。
     备注：

     注意：不遵循此可选步骤将阻止访问 Computer Vision 服务。

   确保下载适合您的 Automation Suite 版本和操作系统的包。

步骤 1.2：获取第一台计算机上所有下载的文件

请务必执行以下步骤：

• 检查所有文件是否已在可访问互联网的计算机上完成下载；
• 在计算机上创建目标文件夹；
• 将文件从联机计算机复制到目标计算机。

在集群中的所有计算机上

通过运行以下命令创建安装文件夹：

sudo su -
mkdir -p /opt/UiPathAutomationSuite/
chmod -R 777 /opt/UiPathAutomationSuite
mkdir -p /uipath/tmp
chmod -R 777 /uipath/tmp

重要提示： 如果使用 configureUiPathDisks.sh 脚本，则不需要运行 mkdir -p /opt/UiPathAutomationSuite/ 。

在可访问互联网的单独计算机上

通过执行以下步骤，将文件复制到第一个节点：

1. From the machine with internet access, copy the files to the installation folder on the target machine, and the offline bundle(s) to the /uipath/tmp folder:

   scp ~/installUiPathAS.sh ~/as-installer.zip ~/as-infra.tar.gz <username>@<node dns>:/uipath/tmp
   scp ~/as.tar.gz <username>@<node dns>:/uipath/tmp/

2. （可选）要使用 Document Understanding，请将以下捆绑包复制到/uipath/tmp文件夹：

   scp ~/du-ondemand.tar.gz <username>@<node dns>:/uipath/tmp/

   警告：不遵循此可选步骤将阻止访问 Document Understanding 服务。
3. （可选）要使用计算机视觉，请将以下捆绑包复制到 /uipath/tmp 文件夹：

   scp ~/cv-ondemand.tar.gz <username>@<node dns>:/uipath/tmp/

   警告：不遵循此可选步骤将阻止访问计算机实具视觉服务。

步骤 2：配置安装

步骤 2.1：默认配置

在集群的主计算机上

1. 将先决条件文件夹添加到当前路径。
   交互式安装程序需要 jq，已包含在我们的 Automation Suite 离线捆绑包中。运行以下命令将其添加到路径，确保您仍然是根用户：

   mv /uipath/tmp/installUiPathAS.sh /uipath/tmp/as-installer.zip /uipath/tmp/as-infra.tar.gz  /opt/UiPathAutomationSuite
   cd /opt/UiPathAutomationSuite
   unzip ./as-installer.zip -d .
   chmod +x ./bin/jq
   export PATH=${PATH}:/opt/UiPathAutomationSuite/bin

2. 提供安装程序文件夹的权限。
   需要为安装脚本所在且即将在此处执行的 /opt/UiPathAutomationSuite 文件夹提供足够的权限。安装程序还将在每个阶段执行后创建一些文件 (output.json)。要提供所需的权限，请运行以下命令：

   chmod -R 755 /opt/UiPathAutomationSuite

3. 运行交互式安装程序以配置安装选项。
   重要提示：

   交互式安装程序尝试下载 as-installer.zip，但在离线环境中失败。要绕过下载步骤并防止出现任何安装问题，请运行以下命令：

   export BUNDLE_FILE="/opt/UiPathAutomationSuite/as-installer.zip"

   要启动交互式安装程序，请运行以下脚本：

   chmod +x ./installUiPathAS.sh
   ./installUiPathAS.sh

   交互式安装程序会指导您完成配置步骤并生成配置，以便您在剩余的安装步骤中进行自定义。

在多节点离线模式下运行交互式安装程序

运行交互式安装程序以配置安装选项。 该工具会收集最常见安装选项的输入，并生成配置文件。 默认情况下启用高可用性，但您可以使用高级配置将其禁用。

重要提示：

执行 Automation Suite 2023.4.0 的交互式安装时，要求您对辅助节点运行下一个命令的消息包含空令牌。要继续安装，您必须通过运行 kubectl create token default 来生成新令牌，然后再对辅助节点执行该命令。

要安装 Automation Suite，请执行以下步骤：

1. 启动交互式安装程序。
2. 接受许可协议以继续安装。
3. 在“主菜单”中，选择您的部署模式。选择“单节点部署”（建议用于演示/评估目的）并确认您的选择。
   
4. 在“部署配置”中，选择您的环境类型。选择“离线”。
5. 选择您的产品选择。您的选项包括：
   • 完成（所有产品）
   • 选择产品

   有关产品选择选项的详细信息，请参阅硬件和软件要求。

6. 如果您在上一步中选择了“选择产品”，请指明要安装的产品。您的选项包括：
   • Action Center
   • AI Center
   • Apps
   • Automation Hub
   • Automation Ops
   • Automation Suite 机器人
   • Data Service
   • Document Understanding
   • Insights
   • Orchestrator
   • Process Mining
   • Task Mining
   • Test Manager

   备注：

   某些 Automation Suite 产品之间存在其他依赖项。选择要安装的产品时，请务必考虑跨产品依赖项。尝试安装不带依赖项的产品会导致错误。

   除此之外，某些 Automation Suite 产品需要专用代理节点。在继续之前，请确保您满足硬件要求。

7. 要安装 AI Center，您必须执行其他步骤：
   1. 指定 AI Center 是否需要外部 Orchestrator。
      • 如果 AI Center 需要外部 Orchestrator，请继续执行步骤 8。
      • 如果 AI Center 需要外部 Orchestrator，请继续执行步骤 7.b。
   2. 将 Orchestrator 证书复制到虚拟机。有关这方面的更多信息，请查看复制 Orhcestrator 证书页面。
   3. 指定 AI Center 的 Orchestrator URL。示例：https://orchestrator.example.com。
   4. 指定 AI Center 的身份 URL。示例：https://orchestrator.example.com/identity。
   5. 指定 Orchestrator 证书文件的路径。示例：/opt/UiPathAutomationSuite/UiPath_Installer/orch.cer。
   6. 指定身份证书文件的路径。示例：/opt/UiPathAutomationSuite/UiPath_Installer/identity.cer。
   注意：在离线安装中，您不需要指定计量 API 密钥。要完成 AI Center 安装，请按照“完成 AI Center 安装”部分中的步骤操作。
8. 确认您的产品选择，以确定最低硬件和软件要求。
9. 输入 Automation Suite FQDN。
10. 指定是否要为所选产品引入自己的对象存储。如果选择“否”，则表示选择默认对象存储。如果选择“是”，请选择以下选项之一：
    • Azure 存储帐户 – 指明是否要将基于托管身份的托管标识与 Azure 存储帐户一起使用，提供与您的选择相对应的以下详细信息，然后指定是否要为所有选定产品自动配置容器：
      • 如果为“是”，请提供 Azure 存储帐户名称和端点后缀，以及您的客户端 ID；
      • 如果为“否”，请提供 Azure 存储帐户名称和端点后缀，以及您的 Azure 帐户密钥；
    • AWS S3 – 提供存储桶名称的前缀和后缀、托管存储桶的 AWS 区域、S3 帐户的访问密钥和密钥，并指定是否要为所有选定产品自动配置存储桶。
    • 其他与 S3 兼容的存储 – 指定存储桶名称的前缀和后缀、S3 服务器 FQDN、S3 端口、访问密钥和 S3 帐户的密钥，并指定是否要为所有选定的产品自动配置存储桶。

    备注：

    许多 S3 对象存储要求将 CORS 设置为来自 Automation Suite 集群的所有流量。您必须在对象存储级别配置 CORS 策略，以允许使用集群的 FQDN。

11. 指定是否要加入自己的与 OCI 兼容的外部 Docker 注册表。

    • 如果选择“否”，则默认选择内部 Docker 注册表。

    • 如果选择“是”，则必须提供有关要使用的注册表的以下详细信息：包含端口、用户名、密码和拉取密码的注册表 URL。

12. 指定是否要对 SQL 连接使用 Kerberos 身份验证。
13. 输入 SQL Server FQDN。 按照提示输入连接端口、用户名和密码。
    备注：

    Process Mining requires a second SQL Server. If you install Process Mining, make sure to provide the warehouse SQL Server URL, connection prompt, username, and password.

    有关第二个 SQL Server 必须满足的硬件要求的详细信息，请参阅 Process Mining 的 SQL 要求。

14. 指定是否要让安装程序自动创建必要的数据库。
15. 为需要安全 TLS 通信的任何外部服务器软件提供 CA 证书，否则安装将失败。 如果未启用 TLS 通信，则可以在安装后配置证书。
    备注：

    安装程序仅接受 PEM 格式的 Base64 编码 DER 证书。如果外部服务器具有不同的 CA，则可以将所有公共证书连接到一个文件中。
16. 定义配置参数后，安装程序会自动生成配置文件。您可以直接在终端中编辑配置参数。
    备注：

    现在，您可以直接在 UiPathAutomationSuite 文件夹中编辑高级配置设置的 cluster_config.json。

    编辑配置文件后，您必须重新运行交互式安装程序以完成安装或手动完成安装。

    对于 Disaster recovery - 主动/被动部署，您现在必须执行以下步骤：

    1. 安装并配置主集群。有关更多详细信息，请参阅高级安装体验。

    2. 安装并配置辅助集群。有关详细信息，请参阅 Disaster recovery - 安装辅助集群。

    3. 按照此页面上的说明继续安装。

注意：安装流程结束时，系统会提示您提供部署摘要，您因此可以访问集群管理门户、主机门户、组织管理界面、Rancher、ArgoCD 等。

步骤 2.2：（可选）高级配置

此步骤是可选的。

您可以配置文件以进行更高级的配置。您可以启用其他产品、禁用任何默认产品、配置 SQL DB 及其各自的连接字符串以及证书。对于多节点 HA 就绪生产模式，我们默认启用高可用性，您可以根据需要将其禁用。

对于高级配置，您可以按照以下说明进行操作：高级安装体验。

注意：如果退出交互式安装程序并执行高级配置，则需要重新运行交互式安装程序以完成该流程。

步骤 3：复制所有其他集群计算机上的安装文件

从执行配置的集群中的第一台计算机，将安装程序、证书和 cluster_config.json 复制到所有其他计算机。

在集群中的第一台计算机上

1. 通过运行以下命令，将 /opt/UiPathAutomationSuite 文件夹复制到所有其他节点：

   scp -r /opt/UiPathAutomationSuite <username>@<node dns>:/opt

   重要提示：由于我们处于离线环境中，因此您可能需要使用目标节点的私有 IP。
2. 如果使用证书登录，请添加 -i <cert.pem>。如果您将.pem内容复制到本地文件，则新文件需要具有正确的权限。您可以执行 chmod 400 <cert.pem> 授予权限。

上述步骤可确保在所有计算机上复制相同的配置以及安装捆绑包的所有下载包。

步骤 4：运行安装

有两种类型的计算机：服务器和代理。

• 服务器 - 运行 Kubernetes 基础架构（即 apiserver、etcd）的计算机。这些组件管理整个集群。
• 代理- 用于运行工作负载的计算机原始版本

多节点 HA 就绪生产模式至少需要 3 台服务器计算机。安装 Task Mining 需要添加一台额外的计算机作为代理。

备注：

• 对于多节点 HA 就绪生产安装，您需要负载均衡器。请确保已创建一个节点，并且已在节点之间分配流量。需要在 cluster_config.json 文件中使用负载均衡器的域名。
• 您至少需要一个服务器节点，而对于 HA，您至少需要 3 个服务器节点。服务器节点的数量需为奇数。

步骤 4.1：接受许可协议

在运行安装之前，请务必阅读许可证协议。

要接受许可证协议，请选择以下方法之一：

• 选项 1（环境变量）- 通过执行以下命令将 LICENSE_AGREEMENT 环境变量设置为“accept”：export LICENSE_AGREEMENT=accept
• 选项 2（内联参数）- 或者，将 --accept-license-agreement 附加到每次执行 install-uipath.sh 后。

步骤 4.2：创建所有计算机并将其加入集群

1. 设置第一台计算机。
   在第一台服务器上执行以下命令：

   cd /opt/UiPathAutomationSuite
   ./install-uipath.sh -i ./cluster_config.json -o ./output.json -k --offline-bundle ./as-infra.tar.gz --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement

2. 将其余服务器加入集群。
   在其余服务器节点上依次执行以下命令：

   cd /opt/UiPathAutomationSuite
   sudo chmod -R 755 /opt/UiPathAutomationSuite
   sudo ./install-uipath.sh -i ./cluster_config.json -o ./output.json -k -j server --offline-bundle ./as-infra.tar.gz --offline-tmp-folder /opt/UiPathAutomationSuite/tmp --install-offline-prereqs --accept-license-agreement

3. 将其余代理加入集群。
   按顺序在其余代理节点上执行以下命令：

   cd /opt/UiPathAutomationSuite
   sudo chmod -R 755 /opt/UiPathAutomationSuite
   sudo ./install-uipath.sh -i ./cluster_config.json -o ./output.json -k -j agent --offline-bundle ./as-infra.tar.gz --offline-tmp-folder /opt/UiPathAutomationSuite/tmp --install-offline-prereqs --accept-license-agreement

步骤 4.3：完成套件安装

使用内部 Docker 注册表时上传离线捆绑包

加入所有节点后，如果您使用内部 Docker 注册表，请通过在第一个节点上运行以下命令来上传离线捆绑包：

./configureUiPathAS.sh registry upload --offline-bundle /opt/UiPathAutomationSuite/as.tar.gz --offline-tmp-folder /uipath/tmp

完成第一个节点上的安装

加入所有节点后，切换到第一台服务器以完成 Automation Suite 安装：

1. 通过运行以下命令检查是否已正确添加节点：

   sudo su 
   export KUBECONFIG=/etc/rancher/rke2/rke2.yaml PATH=$PATH:/var/lib/rancher/rke2/bin 
   kubectl get nodes

2. 如果一切正常，您应该会在列表中看到多个节点。

3. 通过执行以下命令完成安装：

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

警告：

这是最耗时的操作。预计大约需要 2 小时。

加载可选捆绑包

备注：

仅当您未选择外部 Docker 注册表时，才需要执行此步骤。

• 要加载可选的 Document Understanding 捆绑包，请执行以下命令：

  ./configureUiPathAS.sh registry upload --optional-offline-bundle "/uipath/tmp/du-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp"

• 要加载可选的计算机视觉捆绑包，请执行以下命令：

  ./configureUiPathAS.sh registry upload --optional-offline-bundle "/uipath/tmp/cv-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp"

完成 AI Center 安装

如果 AI Center 需要外部 Orchestrator，请运行以下命令以完成安装：

./configureUiPathAS.sh aicenter configure --installation-token <identity token>

有关如何配置 AI Center 的 Orchestrator 的更多信息，请查看 AI Center 指南中的“配置 Orchestrator”页面。

步骤 5：完成安装

注意：您已成功完成安装，现在可以转到安装后步骤。

更新证书

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

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

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

有关说明，请参阅管理证书。

访问 Automation Suite

要访问新创建的集群和套件，请参阅访问 Automation Suite。