Linux 版 Automation Suite 安装指南

上次更新日期 2025年10月17日

手动：安装 Automation Suite

下表列出了必须执行 Automation Suite 安装的步骤：

步骤	单节点安装	多节点安装	精简模式
先决条件
步骤 1：接受许可协议
步骤 2：在第一台服务器计算机上安装基础架构
步骤 3：在其他服务器计算机上安装基础架构
步骤 4：在所有代理计算机上安装基础架构
步骤 5：结合使用集群内注册表以进行离线安装
步骤 6：完成安装

先决条件

使用以下导出命令，将KUBECONFIG环境变量配置为指向 RKE2 Kubernetes 配置文件，并更新PATH环境变量以包含 RKE2 工具目录：

export KUBECONFIG=/etc/rancher/rke2/rke2.yaml 
export PATH=$PATH:/var/lib/rancher/rke2/binexport KUBECONFIG=/etc/rancher/rke2/rke2.yaml 
export PATH=$PATH:/var/lib/rancher/rke2/bin

步骤 1：接受许可协议

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

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

选项 1（环境变量） - 通过运行以下命令将 LICENSE_AGREEMENT 环境变量设置为 accept：
```
export LICENSE_AGREEMENT=acceptexport LICENSE_AGREEMENT=accept
```

选项 2（内联参数） - 将 --accept-license-agreement 附加到 uipathctl 的每次执行中。

步骤 2：在第一台服务器计算机上安装基础架构

要在第一台服务器计算机上安装基础架构，请导航到安装程序文件夹并运行以下命令：

cd /opt/UiPathAutomationSuite/<version>/installer

./bin/uipathctl rke2 install -i /opt/UiPathAutomationSuite/cluster_config.json -o ./output.json -k --accept-license-agreementcd /opt/UiPathAutomationSuite/<version>/installer

./bin/uipathctl rke2 install -i /opt/UiPathAutomationSuite/cluster_config.json -o ./output.json -k --accept-license-agreement

备注：

-k 参数会在第一台服务器计算机上安装基础架构。
安装基础架构后，服务器计算机将成为 Automation Suite 集群中的节点。

步骤 3：在其他服务器计算机上安装基础架构

要扩展 Automation Suite 集群，请在其他服务器计算机上安装基础架构。

为此，请在所有其他服务器计算机上运行以下命令：

cd /opt/UiPathAutomationSuite/<version>/installer
 
./bin/uipathctl rke2 install -i /opt/UiPathAutomationSuite/cluster_config.json -o ./output.json -k -j server --accept-license-agreementcd /opt/UiPathAutomationSuite/<version>/installer
 
./bin/uipathctl rke2 install -i /opt/UiPathAutomationSuite/cluster_config.json -o ./output.json -k -j server --accept-license-agreement

注意：-j server 参数将计算机作为服务器节点添加到现有的 Automation Suite 集群。cluster_config.json 文件中的 fixed_rke_address 标志已与现有的 Automation Suite 集群相连。

步骤 4：在所有代理计算机上安装基础架构

如果您有其他代理计算机，则必须在这些计算机上安装基础架构，并将其作为代理节点添加到 Automation Suite 集群。

为此，请在所有代理计算机上运行以下命令：

cd /opt/UiPathAutomationSuite/<version>/installer

./bin/uipathctl rke2 install -i /opt/UiPathAutomationSuite/cluster_config.json -o ./output.json -k -j agent --accept-license-agreementcd /opt/UiPathAutomationSuite/<version>/installer

./bin/uipathctl rke2 install -i /opt/UiPathAutomationSuite/cluster_config.json -o ./output.json -k -j agent --accept-license-agreement

备注：

-j服务器参数将计算机作为服务器节点添加到现有的 Automation Suite 集群。 cluster_config.json文件中的fixed_rke_address标志已与现有的 Automation Suite 集群相连。

步骤 5：结合使用集群内注册表以进行离线安装

仅当您使用集群内注册表进行离线安装时，才需要执行此步骤。

要从临时注册表为集群内注册表设定种子，请运行以下命令：

cd /opt/UiPathAutomationSuite/<version>/installer
./bin/uipathctl rke2 registry hydrate-registry /opt/UiPathAutomationSuite/cluster_config.jsoncd /opt/UiPathAutomationSuite/<version>/installer
./bin/uipathctl rke2 registry hydrate-registry /opt/UiPathAutomationSuite/cluster_config.json

如果要在启用了 Document Understanding 的新式项目的情况下设置 Automation Suite，请将--serial选项和 validate-registry 命令一起使用，以防止出现内存不足问题：

./bin/uipathctl rke2 registry hydrate-registry /opt/UiPathAutomationSuite/cluster_config.json --serial./bin/uipathctl rke2 registry hydrate-registry /opt/UiPathAutomationSuite/cluster_config.json --serial

步骤 6：完成安装

此时，所有节点都应互连，以建立用于安装 Automation Suite 的基础架构。

要完成安装，请执行以下步骤：

通过运行以下命令，验证所有节点在第一个服务器节点上是否可用：
```
kubectl get nodeskubectl get nodes
```
上述命令的输出应与下图所示的输出类似。请注意，节点总数必须与服务器节点和代理节点的总数相等。
通过运行以下命令，创建安装共享组件所需的先决条件：
```
./bin/uipathctl prereq create /opt/UiPathAutomationSuite/cluster_config.json --versions versions/helm-charts.json./bin/uipathctl prereq create /opt/UiPathAutomationSuite/cluster_config.json --versions versions/helm-charts.json
```
这些主要是对象存储桶和 SQL 数据库。如果在配置文件中设置了sql.create_db key ，则在 SQL Server 上创建安装所需的 SQL 数据库。如果在配置文件中设置了object_storage.create_bucket键，则系统会在云提供程序中创建对象存储存储桶。

通过运行以下命令，验证共享组件安装所需的先决条件：

./bin/uipathctl prereq run /opt/UiPathAutomationSuite/cluster_config.json --versions versions/helm-charts.json./bin/uipathctl prereq run /opt/UiPathAutomationSuite/cluster_config.json --versions versions/helm-charts.json

验证基础架构后，通过运行以下命令安装共享组件和服务：

./bin/uipathctl manifest apply /opt/UiPathAutomationSuite/cluster_config.json --versions ./versions/helm-charts.json./bin/uipathctl manifest apply /opt/UiPathAutomationSuite/cluster_config.json --versions ./versions/helm-charts.json