#节点预处理

在安装 global 集群之前，所有节点（控制平面节点和工作节点）都必须完成预处理。

#支持的 OS 和内核版本

下表列出了受支持的操作系统、已验证版本以及对应的已测试内核版本。

平台对官方支持实施严格的版本匹配策略：

• OS 版本 (x.y.z)：补丁版本 (z) 可以不同，但主版本和次版本 (x 和 y) 必须与已验证版本严格一致。修改 x 或 y 不属于官方支持范围。
• 内核版本 (x.y.z-build)：构建后缀 (build) 可以不同，但内核核心版本 (x.y.z) 必须与已测试版本严格一致。修改 x.y.z 不属于官方支持范围。

#x86

#ARM

#执行快速配置脚本

安装包提供了一个用于快速配置节点的脚本。

解压安装包后，可以在 res 目录中获得 init.sh 脚本文件。将该脚本文件复制到各节点，并确保你拥有 root 权限。

执行脚本：

bash init.sh

#节点检查

以下列出了所有必须在节点上完成的检查。根据节点角色的不同，所需检查项会有所差异。例如，某些检查仅适用于控制平面节点。

检查分为两类：

• ✅ 表示该检查必须通过。
• ⚠️ 表示该检查仅在特定场景下必须满足。请根据说明判断是否满足对应条件；如果满足，则必须处理。

检查项如下：

• OS 和内核

  • ✅ 机器的 grub 启动配置必须包含 transparent_hugepage=never 参数。
  • ✅ CentOS 7.x 系统机器的 grub 启动配置必须包含 cgroup.memory=nokmem 参数。
  • ✅ 检查内核模块 ip_vs、ip_vs_rr、ip_vs_wrr 和 ip_vs_sh 是否已启用。
  • ⚠️ 当内核版本低于 4.19.0（或 RHEL 版本低于 4.18.0）时，检查内核模块 nf_conntrack_ipv4 和（对于 IPv6）nf_conntrack_ipv6 是否已启用。
  • ⚠️ 如果 global 集群计划使用 Kube-OVN CNI，则必须启用内核模块 geneve 和 openvswitch。
  • ✅ 禁用 apparmor/selinux 和防火墙。
  • ✅ 禁用 swap。

• 用户和权限

  • ✅ 节点的 SSH 用户必须拥有 root 权限，并且可以免密使用 sudo。
  • ✅ /etc/ssh/sshd_config 中的 UseDNS 参数必须设置为 no。
  • ✅ 在添加节点之前，将 /etc/ssh/sshd_config 中的 UsePAM 参数设置为 no，然后重启 sshd。否则，PAM 会话策略（例如强制修改密码、pam_access、faillock 或 pam_limits）可能会阻止基于 SSH 的节点加入。在节点进入 Ready 状态后，可以恢复为 UsePAM yes。在启用 SELinux 且使用密码认证的系统上，UsePAM no 本身可能会导致 SSH 登录失败；这种情况下请使用基于密钥的认证。
  • ✅ systemctl show --property=DefaultTasksMax 必须返回 infinity；较低的限制（例如 RHEL 7 / CentOS 7 上默认的 512）会导致繁忙的容器无法创建线程。如果不是 infinity，请在 /etc/systemd/system.conf 中设置 DefaultTasksMax=infinity，然后执行 systemctl daemon-reexec。

• 节点网络

  • ✅ hostname 必须符合以下规则：
    • 长度不超过 36 个字符。
    • 以字母或数字开头并结尾。
    • 仅包含小写字母、数字、- 和 .，且不能包含 .-、.. 或 -.。
  • ✅ /etc/hosts 中的 localhost 必须解析为 127.0.0.1。
  • ✅ /etc/resolv.conf 文件必须存在并包含 nameserver 配置，但不能包含以 172 开头的地址（禁用 systemd-resolved）。
  • ⚠️ /etc/resolv.conf 文件不应配置搜索域（如果必须配置，请参见 配置搜索域）。
  • ✅ 机器的 IP 地址不能是回环地址、多播地址、链路本地地址、全 0 地址或广播地址。
  • ✅ 执行 ip route 必须返回默认路由或指向 0.0.0.0 的路由。
  • ✅ 节点不得占用以下端口：
    • 控制平面节点： 2379、2380、6443、10249 ~ 10256
    • 安装程序所在节点： 8080、12080、12443、16443、2379、2380、6443、10249 ~ 10256
    • 工作节点： 10249 ~ 10256
  • ✅ 如果集群使用 Kube-OVN 或 Calico，请确保以下端口未被占用：
    • Kube-OVN： 6641、6642
    • Calico： 179
  • ⚠️ 确保 nerdctl 所需的 172.17.x.x ~ 172.18.x.x 网段中的 IP 地址未被占用。如果该网段中的 IP 已被占用且无法更改，请联系技术支持。

• 软件和目录要求：

  • ✅ 必须已安装以下工具：ip、ss、tar、swapoff、modprobe、sysctl、md5sum，以及 scp 或 sftp。
  • ⚠️ 如果计划使用本地存储 TopoLVM 或 Rook，则需要安装 lvm2。
  • ✅ /etc/systemd/system/kubelet.service 文件不允许存在。
  • ✅ /tmp 挂载参数中不能包含 noexec。
  • ✅ 删除与 global 集群组件冲突的软件包（参见 删除冲突软件包）。
  • ✅ 如果存在以下文件，必须将其删除：
    • /var/lib/docker
    • /var/lib/nerdctl
    • /opt/nerdctl/
    • /var/lib/containerd
    • /var/log/pods
    • /var/lib/kubelet/pki

• 跨节点检查

  • ✅ global 集群各节点之间不能存在网络防火墙限制。
  • ✅ 集群中每个节点的 hostname 必须唯一。
  • ✅ 所有节点的时区必须统一，且时间同步误差必须 ≤ 10 秒。

#附录

#删除冲突软件包

在安装之前，节点上可能已经在 docker/nerdctl/containerd 环境中运行应用，或者已经安装了与 global 集群冲突的软件。因此，有必要检查并卸载冲突软件包。

可参考以下命令。

for x in \
    docker docker-client docker-common docker-latest \
    podman-docker podman \
    runc \
    containernetworking-plugins \
    apptainer \
    kubernetes kubernetes-master kubernetes-node kubernetes-client \
    ; do
    rpm -qa | grep -F "$x"
done

for x in \
    docker docker-client docker-common docker-latest \
    podman-docker podman \
    runc \
    containernetworking-plugins \
    apptainer \
    kubernetes kubernetes-master kubernetes-node kubernetes-client \
    ; do
    yum remove "$x"
done

for x in \
    docker.io \
    podman-docker \
    containerd \
    rootlesskit \
    rkt \
    containernetworking-plugins \
    kubernetes \
    ; do
    dpkg-query -l | grep -F "$x"
done

for x in \
    kubernetes-worker \
    kubectl kube-proxy kube-scheduler kube-controller-manager kube-apiserver \
    k8s microk8s \
    kubeadm kubelet \
    ; do
    snap list | grep -F "$x"
done

for x in \
    docker.io \
    podman-docker \
    containerd \
    rootlesskit \
    rkt \
    containernetworking-plugins \
    kubernetes \
    ; do
    apt-get purge "$x"
done

for x in \
    kubernetes-worker \
    kubectl kube-proxy kube-scheduler kube-controller-manager kube-apiserver \
    k8s microk8s \
    kubeadm kubelet \
    ; do
    snap remove --purge "$x"
done

for x in \
    docker docker-client docker-common \
    docker-engine docker-proxy docker-runc \
    podman-docker podman \
    containernetworking-plugins \
    apptainer \
    containerd \
    kubernetes kubernetes-master kubernetes-node kubernetes-client kubernetes-kubeadm \
    ; do
    rpm -qa | grep -F "$x"
done

for x in \
    docker docker-client docker-common \
    docker-engine docker-proxy docker-runc \
    podman-docker podman \
    containernetworking-plugins \
    apptainer \
    containerd \
    kubernetes kubernetes-master kubernetes-node kubernetes-client kubernetes-kubeadm \
    ; do
    yum remove "$x"
done

#配置搜索域

在 Linux OS 中，/etc/resolv.conf 文件用于配置 DNS 客户端的域名解析设置。search 行用于指定 DNS 查询的域搜索路径。

配置要求

• 域数量： search 行中的域数量应小于 domainCountLimit - 3（默认 domainCountLimit 为 32）。
• 单个域长度： 每个域名长度不得超过 253 个字符。
• 总字符长度： 所有域名及空格的总字符数不得超过 MaxDNSSearchListChar（默认值为 2048）。

示例

search domain1.com domain2.com domain3.com

• 域的总数为 3。
• 单个域名长度，例如 domain1.com，为 11。
• 总字符长度为 35，即 11 + 11 + 11 + 2（两个空格）。