- 概述
- 要求
- 安装
- 安装后
- 集群管理
- 监控和警示
- 迁移和升级
- 特定于产品的配置
- 最佳实践和维护
- 故障排除
Automation Suite 安装指南
配置计算机
- 为防止数据丢失,请确保您使用的基础架构不会在集群重新启动或关闭时自动删除集群磁盘。如果启用了此功能,请确保将其禁用。
- 为确保 SSH 会话顺利不间断,我们强烈建议您在配置磁盘和安装 Automation Suite 之前按照安装最佳实践中的步骤操作。
configureUiPathDisks.sh
脚本配置磁盘并对其进行分区。 有关详细信息,请参阅以下部分。
在安装之前,您必须使用 LVM 对磁盘进行分区和配置,以便可以轻松地更改其大小,而不会发生任何数据迁移或数据丢失。
磁盘分区
/var
分区下。默认情况下,var
分区仅分配有 8 GiB 的空间。
ext4
或 xfs
。
必须使用 LVM 创建所有分区。这是为了确保集群数据可以驻留在不同的磁盘上,但仍然能够以一致的方式查看。这也有助于将来扩展分区大小,而无需担心数据迁移或数据丢失。
对于 RHEL 操作系统,您需要确保计算机上的装载点不小于以下数据。
在线
磁盘标签 |
分区 |
大小 |
用途 |
---|---|---|---|
集群磁盘 |
|
190 GiB |
Rancher 文件夹用于存储容器映像和图层 |
|
56 GiB |
Kubelet 文件夹存储运行时 Kubernetes 配置,例如密码、配置映射和 emptyDir | |
|
10 GiB |
安装程序二进制文件 | |
etcd 磁盘 |
|
16GB |
Kubernetes 的分布式数据库 |
数据磁盘 |
|
512 GiB(基本安装) |
块存储抽象 |
2 TiB(完整安装) |
我们建议您不要将操作系统磁盘用于上述任何目的,以确保流程获得其应有的资源份额。
离线
离线要求与在线要求相同,不同之处在于运行安装的第一台计算机,它需要满足以下要求。
解压离线捆绑包需要额外的空间。
磁盘标签 |
分区 |
大小 |
用途 |
---|---|---|---|
集群磁盘 |
|
190 GiB |
Rancher 文件夹用于存储容器映像和图层 |
|
56 GiB |
Kubelet 文件夹存储运行时 Kubernetes 配置,例如密码、配置映射和 emptyDir | |
|
10 GiB |
安装程序二进制文件 | |
etcd 磁盘 |
|
16GB |
Kubernetes 的分布式数据库 |
数据磁盘 |
|
512 GiB(基本安装) |
块存储抽象 |
2 TiB(完整安装) | |||
UiPath 捆绑包磁盘 |
|
512 GiB |
离线捆绑包 |
我们建议您不要将操作系统磁盘用于上述任何目的,以确保流程获得其应有的资源份额。
数据磁盘和 etcd 磁盘应为单独的物理磁盘。这将数据磁盘和 etcd 磁盘与其他集群工作负载和活动物理隔离,同时还增强了集群的性能和稳定性。
有关在安装前如何使用示例脚本对磁盘进行分区和配置的详细信息,请参阅以下部分。
下载脚本
configureUiPathDisks.sh
脚本对磁盘进行配置和分区。
有关下载说明,请参阅“ configureUiPathDisks.sh”。
运行脚本
configureUiPathDisks.sh
脚本用于以下目的:
- 为新的 Automation Suite 集群安装配置磁盘和装载点;
- 安装后调整数据磁盘的大小。
要使脚本可执行,请运行:
chmod +x ./configureUiPathDisks.sh
chmod +x ./configureUiPathDisks.sh
有关脚本用法的更多详细信息,请运行以下命令:
sudo ./configureUiPathDisks.sh --help
sudo ./configureUiPathDisks.sh --help
***************************************************************************************
Utility to configure the disk for UiPath Automation Suite Installation.
Run this script to configure the disks on new machine or to extend the size of datadisk
Arguments
-n|--node-type NodeType, Possible values: agent, server. Default to server
-i|--install-type Installation mode, Possible values: online, offline. Default to online
-c|--cluster-disk-name Device to host rancher and kubelet. Ex: /dev/sdb
-e|--etcd-disk-name Device to host etcd, Not required for agent node. Ex: /dev/sdb
-l|--data-disk-name Device to host datadisk, Not required for agent node. Ex: /dev/sdc
-b|--bundle-disk-name Device to host the uipath bundle.
Only required for offline installation on 1st server node
-f|--complete-suite Installing complete product suite or any of these products:
aicenter, apps, taskmining, documentunderstanding.
This will configure the datadisk volume to be 2TiB instead of 512Gi.
-p|--primary-server Is this machine is first server machine? Applicable only for airgap install.
This is the machine on which UiPath AutomationSuite bundle will be installed.
Default to false
-x|--extend-data-disk Extend the datadisk. Either attach new disk or resize the exiting datadisk
-r|--resize Used in conjunction of with --extend-data-disk to resize the exiting volume,
instead of adding new volume
-d|--debug Run in debug
-h|--help Display help
ExampleUsage:
configureUiPathDisks.sh --node-type server --install-type online \
--cluster-disk-name /dev/sdb --etcd-disk-name /dev/sdc \
--data-disk-name /dev/sdd
configureUiPathDisks.sh --data-disk-name /dev/sdh --extend-data-disk
***************************************************************************************
***************************************************************************************
Utility to configure the disk for UiPath Automation Suite Installation.
Run this script to configure the disks on new machine or to extend the size of datadisk
Arguments
-n|--node-type NodeType, Possible values: agent, server. Default to server
-i|--install-type Installation mode, Possible values: online, offline. Default to online
-c|--cluster-disk-name Device to host rancher and kubelet. Ex: /dev/sdb
-e|--etcd-disk-name Device to host etcd, Not required for agent node. Ex: /dev/sdb
-l|--data-disk-name Device to host datadisk, Not required for agent node. Ex: /dev/sdc
-b|--bundle-disk-name Device to host the uipath bundle.
Only required for offline installation on 1st server node
-f|--complete-suite Installing complete product suite or any of these products:
aicenter, apps, taskmining, documentunderstanding.
This will configure the datadisk volume to be 2TiB instead of 512Gi.
-p|--primary-server Is this machine is first server machine? Applicable only for airgap install.
This is the machine on which UiPath AutomationSuite bundle will be installed.
Default to false
-x|--extend-data-disk Extend the datadisk. Either attach new disk or resize the exiting datadisk
-r|--resize Used in conjunction of with --extend-data-disk to resize the exiting volume,
instead of adding new volume
-d|--debug Run in debug
-h|--help Display help
ExampleUsage:
configureUiPathDisks.sh --node-type server --install-type online \
--cluster-disk-name /dev/sdb --etcd-disk-name /dev/sdc \
--data-disk-name /dev/sdd
configureUiPathDisks.sh --data-disk-name /dev/sdh --extend-data-disk
***************************************************************************************
在线
要在在线单节点评估设置中配置磁盘,请在计算机上运行以下命令:
./configureUiPathDisks.sh --cluster-disk-name name_of_cluster_disk \
--etcd-disk-name name_of_etcd_disk \
--data-disk-name name_of_data_disk
./configureUiPathDisks.sh --cluster-disk-name name_of_cluster_disk \
--etcd-disk-name name_of_etcd_disk \
--data-disk-name name_of_data_disk
离线
在离线安装中,您必须在 Docker 注册表中加载产品的映像。为此,需要以单独的磁盘形式提供额外的存储空间来托管 UiPath 产品捆绑包。
要在离线单节点评估设置中配置磁盘,请在计算机上运行以下命令:
./configureUiPathDisks.sh --cluster-disk-name name_of_cluster_disk \
--etcd-disk-name name_of_etcd_disk \
--data-disk-name name_of_data_disk \
--bundle-disk-name name_of_uipath_bundle_disk \
--primary-server \
--install-type offline
./configureUiPathDisks.sh --cluster-disk-name name_of_cluster_disk \
--etcd-disk-name name_of_etcd_disk \
--data-disk-name name_of_data_disk \
--bundle-disk-name name_of_uipath_bundle_disk \
--primary-server \
--install-type offline
要扩展数据磁盘,您可以附加新的物理磁盘或调整现有磁盘的大小。
添加新磁盘
要使用新附加的磁盘扩展数据磁盘,请在服务器计算机上运行以下命令:
./configureUiPathDisks.sh --data-disk-name name_of_data_disk \
--extend-data-disk
./configureUiPathDisks.sh --data-disk-name name_of_data_disk \
--extend-data-disk
调整现有磁盘的大小
要通过调整现有磁盘大小来扩展数据磁盘,请在服务器计算机上运行以下命令:
./configureUiPathDisks.sh --extend-data-disk --resize
./configureUiPathDisks.sh --extend-data-disk --resize
以下页面可帮助 Linux 管理员在执行 Automation Suite 安装之前管理操作系统和内核级别设置。
通常,这些设置由专用的管理配置工具(例如 Puppet)管理。确保您所做的更改符合您环境的控制流程,以保持一致性并记录在案。
请确保在开始安装前完成以下步骤,因为操作系统和内核级别的错误配置可能会导致不直观的错误。检查这些特定设置通常可以避免此类错误。
sysctl
设置在计算机中是必要项:
-
启用 IP 转发
-
禁用反向路径筛选
您可以通过运行以下命令来执行此操作:
cat <<EOF >>"/etc/sysctl.d/99-sysctl.conf"
net.bridge.bridge-nf-call-iptables = 1
net.ipv4.ip_forward = 1
net.bridge.bridge-nf-call-ip6tables = 1
net.ipv4.conf.all.rp_filter=0
EOF
cat <<EOF >>"/etc/sysctl.d/99-sysctl.conf"
net.bridge.bridge-nf-call-iptables = 1
net.ipv4.ip_forward = 1
net.bridge.bridge-nf-call-ip6tables = 1
net.ipv4.conf.all.rp_filter=0
EOF
nf-call-iptables
。Kubernetes 在集群内部创建虚拟网络。在这种情况下,每个 Pod 都可以拥有自己的 IP 地址,通过结合使用该地址与内部名称服务,可促进服务间的通信。如果未启用 nf-call-iptables
,集群将无法工作。有关详细信息,请参阅官方 Kubernetes 文档。
要应用设置,请运行以下命令:
sysctl --system
sysctl --system
如果使用 fapolicy,则需要特定于 RKE2 的策略。要生成此策略,请使用以下命令:
cat <<-EOF >>"/etc/fapolicyd/rules.d/69-rke2.rules"
allow perm=any all : dir=/var/lib/rancher/
allow perm=any all : dir=/opt/cni/
allow perm=any all : dir=/run/k3s/
allow perm=any all : dir=/var/lib/kubelet/
allow perm=any all : dir=/root/.local/share/helm
EOF
cat <<-EOF >>"/etc/fapolicyd/rules.d/69-rke2.rules"
allow perm=any all : dir=/var/lib/rancher/
allow perm=any all : dir=/opt/cni/
allow perm=any all : dir=/run/k3s/
allow perm=any all : dir=/var/lib/kubelet/
allow perm=any all : dir=/root/.local/share/helm
EOF
确保将变更传达给您的 Linux 团队,并采取适当的配置管理流程。
/var/lib/rancher
装载的磁盘不得设置 noexec
或 nosuid
。磁盘工具将在没有这些属性的情况下自动创建这些安装。
如果 Linux 管理员手动设置这些属性,则实例将无法运行。
有关磁盘配置的更多详细信息,请参阅磁盘要求。
确保在防火墙上为每个来源启用了以下端口。
端口 |
协议 |
来源 |
用途 |
要求 |
---|---|---|---|---|
|
TCP |
跳转服务器/客户端计算机 |
对于 SSH(安装、集群管理调试) |
不要打开此互联网端口。允许访问客户端计算机或跳转服务器。 |
|
TCP |
仅离线安装:发送系统电子邮件通知所需。 | ||
|
TCP |
集群中的所有节点 + 负载均衡器 |
对于 HTTPS(访问 Automation Suite)。 |
此端口应具有来自集群中所有节点和负载均衡器的入站和出站连接。 |
|
TCP |
仅离线安装:发送系统电子邮件通知所需。 |
如果您启用了 Task Mining 并配置了专用 Task Mining 节点和/或配置了具有 GPU 支持的专用节点,请确保除上述端口外,您的防火墙还启用了以下端口:
端口 |
协议 |
来源 |
用途 |
要求 |
---|---|---|---|---|
|
TCP |
集群中的所有节点 |
etcd 客户端端口 |
不得公开于互联网。节点之间通过私有 IP 地址进行访问就足够了。 |
|
TCP |
集群中的所有节点 |
etcd 对等端口 |
不得公开于互联网。节点之间通过私有 IP 地址进行访问就足够了。 |
|
TCP |
集群中的所有节点 |
用于使用 HTTPS 访问 Kube API;加入节点时需要。 |
此端口应具有来自集群中所有节点的入站和出站连接。 |
|
UDP |
集群中的所有节点 |
Flannel 需要 (VXLAN) |
不得公开于互联网。节点之间通过私有 IP 地址进行访问就足够了。 |
|
TCP |
集群中的所有节点 + 负载均衡器 |
用于使用 HTTP 访问 Kube API;加入节点时需要 |
此端口应具有来自集群中所有节点和负载均衡器的入站和出站连接。 |
|
TCP |
集群中的所有节点 |
kubelet/指标服务器 |
不得公开于互联网。节点之间通过私有 IP 地址进行访问就足够了。 |
|
TCP |
集群中的所有节点 |
用于集群中节点之间内部通信的 NodePort 端口 |
不得公开于互联网。节点之间通过私有 IP 地址进行访问就足够了。 |
6443
。
9345
由节点用于发现现有节点并加入多节点部署中的集群。为了保持高可用性发现机制运行,我们建议通过负载均衡器公开该端口与运行状况检查。
还要确保从所有节点连接到 SQL Server。
不要在其中一个 Istio 保留端口上公开 SQL Server,因为这可能会导致连接失败。
如果您在网络上设置了防火墙,请确保根据上述要求打开这些端口并允许流量。
要配置代理,您需要在使用先决条件设置环境时以及在安装的高级配置阶段执行其他配置步骤。
设置环境时需要执行以下步骤。
我们目前不支持具有自签名证书的 HTTPS 代理。如果要配置代理,请确保使用公共受信任证书。
确保在给定虚拟网络的网络安全组上启用以下规则。
来源 |
目标 |
通过代理路由 |
端口 |
描述 |
---|---|---|---|---|
虚拟网络 |
SQL |
否 |
SQL 服务器端口 |
SQL Server 所需。 |
虚拟网络 |
Load balancer |
否 |
|
将新节点添加到集群时所需。 |
虚拟网络 |
集群(子网) |
否 |
所有端口 |
通过私有 IP 范围进行通信时所需。 |
虚拟网络 |
|
否 |
|
在部署期间登录和使用 ArgoCD 客户端时所需。 |
虚拟网络 |
代理服务器 |
是 |
所有端口 |
将流量路由到代理服务器时所需。 |
虚拟网络 |
名称服务器 |
否 |
所有端口 |
大多数云服务(例如 Azure 和 AWS)都使用它来获取虚拟机元数据,并将其视为私有 IP。 |
虚拟网络 |
元数据服务器 |
否 |
所有端口 |
大多数云服务(例如 Azure 和 AWS)使用 IP 地址
169.254.169.254 来获取计算机元数据。
|
配置节点时,您需要将代理配置添加到属于集群的每个节点。若要通过代理服务器从节点路由出站流量,则需要执行此步骤。
-
在
/etc/environment
中添加以下配置:http_proxy=http://<PROXY-SERVER-IP>:<PROXY-PORT> https_proxy=http://<PROXY-SERVER-IP>:<PROXY-PORT> no_proxy=alm.<fqdn>,<fixed_rke2_address>,<named server address>,<metadata server address>,<private_subnet_ip>,localhost,<Comma separated list of ips that should not got though proxy server>
http_proxy=http://<PROXY-SERVER-IP>:<PROXY-PORT> https_proxy=http://<PROXY-SERVER-IP>:<PROXY-PORT> no_proxy=alm.<fqdn>,<fixed_rke2_address>,<named server address>,<metadata server address>,<private_subnet_ip>,localhost,<Comma separated list of ips that should not got though proxy server> -
在
/etc/wgetrc
中添加以下配置:http_proxy=http://<PROXY-SERVER-IP>:<PROXY-PORT> https_proxy=http://<PROXY-SERVER-IP>:<PROXY-PORT> no_proxy=alm.<fqdn>,<fixed_rke2_address>,<named server address>,<metadata server address>,<private_subnet_ip>,localhost,<Comma separated list of ips that should not got though proxy server>
http_proxy=http://<PROXY-SERVER-IP>:<PROXY-PORT> https_proxy=http://<PROXY-SERVER-IP>:<PROXY-PORT> no_proxy=alm.<fqdn>,<fixed_rke2_address>,<named server address>,<metadata server address>,<private_subnet_ip>,localhost,<Comma separated list of ips that should not got though proxy server>必填参数
描述
http_proxy
用于路由来自节点的 HTTP 出站请求。这应该是代理服务器 FQDN 和端口。
https_proxy
用于路由来自节点的 HTTPS 出站请求。这应该是代理服务器 FQDN 和端口。
no_proxy
不希望通过代理服务器路由的主机和 IP 地址的逗号分隔列表。 这应该是私有子网、SQL Server 主机、命名服务器地址、元数据服务器地址:alm.<fqdn>,<fixed_rke2_address>,<named server address>,<metadata server address>
named server address
– 大多数云服务(例如 Azure 和 AWS)都使用它来解析 DNS 查询。metadata server address
– 大多数云服务(例如 Azure 和 AWS)使用 IP 地址169.254.169.254
来获取计算机元数据。
-
通过运行以下命令验证代理设置是否已正确配置:
curl -v $HTTP_PROXY curl -v <fixed_rke_address>:9345
curl -v $HTTP_PROXY curl -v <fixed_rke_address>:9345重要提示:满足代理服务器要求后,请确保在安装过程中继续进行代理配置。请按照可选:配置代理服务器中的步骤操作,以确保正确设置代理服务器。