在 Ubuntu 上安装多节点群集

我们将本指南中的此目录称为此目录 pa-download-dir 。

Paragon Automation 安装捆绑包包含以下脚本和 TAR 文件，用于安装每个组件模块：

• davinci.tar.gz，这是主安装程序文件。

• infra.tar，它安装 Kubernetes 基础架构组件，包括 Docker 和 Helm。

• ems.tar，用于安装基本平台组件。

• northstar.tar，用于安装 Paragon Pathfinder 和 Paragon Planner 组件。

• healthbot.tar，用于安装 Paragon Insights 组件。

• paragon_ui.tar，用于安装 Paragon Automation UI 组件。

• addons.tar，用于安装不属于基本 Kubernetes 安装的基础架构组件。基础架构组件包括IAM，Kafka，ZooKeeper，cert-manager，Ambassador，Postgres，Metrics，Kubernetes Dashboard，Open Distro for Elasticsearch，Fluentd，Reloader，ArangoDB和Argo。

• helm-charts.tar，其中包含安装所需的所有舵图。

• rke2-packages.tgz，用于安装基于 RKE2 的 Kubernetes 组件。
• 3rdparty.tar.gz，用于安装所需的第三方实用程序。

• rhel-84-airgap.tar.gz， 它仅在 基本操作系统为 Red Hat Enterprise Linux （RHEL） 的节点上使用气隙方法安装 Paragon Automation。如果您未在 RHEL 基础操作系统上使用气隙方法安装 Paragon Automation，则可以选择删除此文件。

• run 脚本，用于执行安装程序映像。

下载软件后，即可安装 Paragon Automation。

config-dir 是控制主机上的用户定义目录，其中包含特定安装的配置信息。如果目录不存在，该 init 命令会自动创建该目录。或者，您可以在执行 init 命令之前创建目录。

确保在命令中包含 run 点和斜杠 （./）。

如果您使用同一控制主机来管理 Paragon Automation 的多个安装，则可以使用不同名称的配置目录来区分安装。

将您在 配置 SSH 客户端身份验证 中生成的私钥复制到用户定义的 config-dir 目录。安装程序允许 Docker 容器访问 config-dir 目录。SSH 密钥必须在目录中可用，控制主机才能连接到群集节点。

确保在复制命令 （cp） 的末尾包含点 （.）。

1. 使用 inv 以下命令自定义清单文件：

   下表列出了命令提示您 inv 输入的配置选项。

   表 1： inv命令选项

   inv 命令提示	符说明
   Kubernetes 主节点	输入 Kubernetes 主节点的 IP 地址。
   Kubernetes 工作节点	输入 Kubernetes 工作器节点的 IP 地址。
   本地存储节点	定义具有可用于应用程序的磁盘空间的节点。本地存储节点预先填充了主节点和工作节点的 IP 地址。您可以编辑这些地址。输入要在其上运行需要本地存储的应用程序的节点的 IP 地址。 Postgres、ZooKeeper 和 Kafka 等服务使用 在导出/本地卷内分区的本地存储或磁盘空间。默认情况下，工作器节点具有可用的本地存储。如果不在此处添加主节点，则只能在主节点上运行不需要本地存储的应用程序。 注意： 本地存储不同于 Ceph 存储。
   Kubernetes 节点的用户名（例如，根）	配置用户帐户和身份验证方法，以使用群集节点对安装程序进行身份验证。用户帐户必须是 root，或者对于非 root 用户，该帐户必须具有超级用户 （sudo） 权限。
   SSH 私钥文件（可选）	如果选择ssh-key身份验证，则要使控制主机在安装过程中向节点进行身份验证，请将 ansible_ssh_private_key_file 所在的目录 （config-dir） 和id_rsa文件配置为 “{{ config-dir }}/id_rsa”。
   Kubernetes 节点的密码（可选）	如果在安装过程中为控制主机选择了密码认证以向节点进行身份验证，请直接输入认证密码。警告：密码以纯文本形式写入。 建议 不要 使用此选项进行身份验证。
   Kubernetes 群集名称（可选）	输入 Kubernetes 群集的名称。
   写入库存文件？	单击以 Yes 保存清单信息。

   例如：

2. 或者，您可以使用文本编辑器手动自定义库存文件。

   在 清单 文件中编辑以下组。

   1. 添加群集的 Kubernetes 主节点和工作节点的 IP 地址。

      该 master 组标识主节点， node 该组标识工作器节点。不能同时 master 在 和 node 组中使用相同的 IP 地址。

      要创建多主节点设置，请列出组下 master 将充当主节点的所有节点的地址或主机名。添加将在组下 node 充当辅助角色的节点的地址或主机名。

   2. 定义具有可用于组下 local_storage_nodes:children 应用程序的磁盘空间的节点。

   3. 配置用户帐户和身份验证方法，以使用 Ansible 控制主机中的安装程序与组 vars 下的群集节点进行身份验证。

   4. （可选）在组中指定 Kubernetes 群集 kubernetes_cluster_name 的名称。

该 conf 命令运行交互式安装向导，使您能够选择要安装的组件并配置基本的 Paragon Automation 设置。该命令使用您的输入配置填充 config.yml 文件。对于高级配置，您必须手动编辑 config.yml 文件。

按照向导提示输入信息。使用光标键移动光标，使用空格键选择一个选项，并使用 or i 键切换a选择或清除所有选项。按 Enter 转到下一个配置选项。您可以通过输入句点 （.） 来跳过配置选项。您可以通过退出向导并从头开始重新输入所有选择。安装程序允许您在保存已做出的选择后退出向导或从头开始重新启动。如果不完全退出并重新启动向导，则无法返回并重做已在当前工作流中所做的选择。

下表列出了命令提示您 conf 输入的配置选项：

[edit groups northstar]
root@system# show protocols bgp group northstar
type internal;
family traffic-engineering {
    unicast;
}
export TE;
allow 10.xx.43.0/24;

[edit groups northstar]
root@system# show policy-options policy-statement TE
from family traffic-engineering;
then accept;

[edit protocols bgp group BGP-LS]
root@vmx101# show | display set 
set protocols bgp group BGP-LS family traffic-engineering unicast
set protocols bgp group BGP-LS peer-as 11
set protocols bgp group BGP-LS allow 10.x.43.1
set protocols bgp group BGP-LS allow 10.x.43.2
set protocols bgp group BGP-LS allow 10.x.43.3
set protocols bgp group BGP-LS export TE

[edit protocols bgp group BGP-LS]
root@vmx101# show | display set
set protocols bgp group BGP-LS family traffic-engineering unicast
set protocols bgp group BGP-LS peer-as 11
set protocols bgp group BGP-LS neighbor 10.xx.43.1
set protocols bgp group BGP-LS neighbor 10.xx.43.2
set protocols bgp group BGP-LS neighbor 10.xx.43.3
set protocols bgp group BGP-LS passive
set protocols bgp group BGP-LS export TE

set protocols rsvp interface interface.unit

set protocols isis interface interface.unit
set protocols isis traffic-engineering igp-topology
Or
set protocols ospf area area interface interface.unit
set protocols ospf traffic-engineering igp-topology

set protocols mpls interface interface.unit
set protocols mpls traffic-engineering database import igp-topology

config.yml文件由文件开头的基本部分组成，该部分对应于安装向导提示您输入的配置选项。该文件在基本部分下还有一个广泛的部分列表，允许您直接在文件中输入复杂的配置值。

您可以配置以下选项：

• （可选） grafana_admin_password 设置密码以登录 Grafana 应用程序。Grafana 是一种可视化工具，通常用于可视化和分析来自各种来源（包括日志）的数据。

  默认情况下，用户名在 中 # grafana_admin_user: admin预配置为 admin。使用 admin 作为用户名和密码，您配置登录 Grafana 。

  如果未配置密码， grafana_admin_password 安装程序将生成一个随机密码。您可以使用以下命令检索密码：

  # kubectl get secret -n kube-system grafana -o jsonpath={..grafana-password} | base64 -d

• iam_skip_mail_verification对于没有 SMTP 的用户管理，通过身份和访问管理 （IAM） 将配置选项设置为 true。默认情况下，对于使用 SMTP 进行的用户管理，此选项设置为 false。您必须在 Paragon Automation 中配置 SMTP，以便在创建、激活或锁定 Paragon Automation 用户帐户或更改帐户密码时通知用户。

• callback_vip使用不同于入口控制器的虚拟 IP （VIP） 地址的 IP 地址配置选项。您可以使用 MetalLB VIP 地址池中的 IP 地址。您可以配置此 IP 地址，以便将管理和数据流量与南向和北向接口隔离。默认情况下，callback_vip分配了入口控制器的相同地址或地址之一。

完成编辑后保存并退出文件。

默认情况下，大使使用由 Kubernetes 群集内部 CA 签名的本地生成的证书。

安装已配置群集的安装时间取决于群集的复杂性。基本安装至少需要 45 分钟才能完成。

安装程序会在安装开始时检查 NTP 同步。如果时钟不同步，安装将失败。

仅对于 多主节点 部署，安装程序会检查单个服务器的 CPU 和内存以及每个群集的总可用 CPU 和内存。如果不满足以下要求，安装将失败。

• 每个群集的最小 CPU：20 个 CPU

• 每个群集的最小内存：32-GB

• 每个节点的最小 CPU 数：4 个 CPU

• 每个节点的最小内存：6 GB

若要禁用 CPU 和内存检查，请使用以下命令并重新运行部署。

# ./run -c config-dir deploy -e ignore_iops_check=yes

使用文本编辑器在 limits.conf 和 sysctl.conf 文件中为 Paragon Insights 配置以下推荐信息。这些值为流入数据库内存要求设置软内存和硬内存限制。如果未设置这些限制，由于默认系统限制，您可能会看到“内存不足”或“打开的文件过多”等错误。

对所有工作器节点重复此步骤。