ADDC 7.3安装失败

大概率南向不通，可能网卡配置有问题或者配了南向vlan，具体得看环境，联系400处理下

在 ADDC 7.3 环境中，三节点容器化部署 DC 组件后，登录控制器却看不到组件信息，这通常属于“部署动作完成但服务未正常注册”的范畴。

一、5 分钟快速定位（核心步骤）

1. 先确认组件真实状态（最关键）

• 若 Pod 状态为Pending/Error/CrashLoopBackOff：容器启动失败，需解决资源不足、镜像异常、依赖缺失等问题。
• 若 Pod 为Running但控制器无组件：组件未注册或集群通信异常，进入下一步排查。

2. 验证集群网络连通性

3. 检查集群注册状态

• 若节点未全部就绪：节点未加入集群，需重新执行kubeadm join或重置集群网络。
• 若组件 CRD 为空：组件未成功注册，需重新部署组件 YAML 文件。

二、常见原因与对应解决方法

1. 组件容器启动失败（高频）

原因

• 虚拟机资源不足（CPU / 内存 / 磁盘未达标）
• 镜像下载不完整或版本不匹配
• 容器依赖缺失（如 DNS、存储插件异常）

解决

1. 扩容资源：确保每节点 CPU≥8 核、内存≥32G、磁盘≥200G（SSD 优先）。
2. 重新拉取镜像：
   bash

   运行

   # 删除异常镜像 crictl rmi <dc镜像ID> # 重新拉取指定版本镜像 crictl pull seer-dc:7.3.0 # 重启容器 kubectl rollout restart deployment <dc组件名称> -n <命名空间>
3. 修复存储插件：确保kubelet与csi-plugin正常运行，磁盘挂载无异常。

2. 集群注册异常（次高频）

原因

• 节点主机名重复或解析错误
• 集群 CA 证书未同步或过期
• 组件注册参数配置错误

解决

1. 统一主机名与解析：
   bash

   运行

   # 配置主机名 hostnamectl set-hostname dc-node-01/02/03 # 编辑hosts文件，添加三节点IP与主机名映射 vi /etc/hosts
2. 同步集群 CA 证书：
   bash

   运行

   # 复制主节点CA证书到其他节点 scp /etc/kubernetes/pki/ca.crt root@其他节点IP:/etc/kubernetes/pki/ # 重启kube-apiserver systemctl restart kube-apiserver
3. 重新注册组件：修改组件 YAML 文件的cluster-id与node-ip参数，重新应用。

3. 网络与端口拦截（常见）

原因

• 交换机端口隔离、VLAN 划分错误
• 防火墙 / 安全组未放行组件通信端口
• 容器网络插件（Calico/Flannel）异常

解决

1. 关闭端口隔离：交换机接口配置undo port-isolate，确保三节点间互通。
2. 放行核心端口：
   • 管理端口：80、443（Web 访问）
   • 集群通信端口：6443、2379-2380（K8s 核心）
   • 组件业务端口：8080、8443、10000-10010（DC 组件）。
3. 修复网络插件：
   bash

   运行

   # 查看Calico/Flannel状态 kubectl get pod -n kube-system | grep calico/flannel # 重启异常网络插件Pod kubectl delete pod <calico/flannel Pod名称> -n kube-system

4. 时间 / 证书不一致（隐性高频）

原因

• 三节点时间不同步（Kerberos 认证依赖时间一致性）
• 组件证书过期或未正确生成

解决

1. 配置 NTP 时间同步：
   bash

   运行

   # 安装NTP服务 yum install ntp -y # 配置NTP服务器（统一使用主节点或外部NTP） vi /etc/ntp.conf # 启动NTP服务并设置开机自启 systemctl start ntpd && systemctl enable ntpd # 同步时间 ntpdate -u 主节点IP
2. 重新生成组件证书：
   bash

   运行

   # 进入组件证书目录 cd /opt/seer-dc/cert # 删除旧证书 rm -rf * # 重新生成证书 ./generate-cert.sh --ip 节点IP --domain 集群域名 # 重启组件服务 systemctl restart seer-dc

三、终极排查流程（按顺序执行）

1. 查容器状态：kubectl get pod -A | grep dc → 解决启动异常。
2. 查网络互通：ping+telnet 三节点 IP 与端口 → 解决网络拦截。
3. 查集群注册：kubectl get nodes+kubectl get dc-cluster → 解决注册失败。
4. 查时间证书：date+ 证书文件有效期 → 解决时间 / 证书问题。
5. 查资源日志：kubectl logs+dmesg → 定位隐性异常。

四、注意事项

1. 三节点必须同版本镜像、同网络规划、同资源配置，避免版本或配置差异导致集群异常。
2. 部署前务必关闭 SELinux 与防火墙（生产环境需精准放行端口，而非直接关闭）。
3. 所有操作优先在主节点执行，再同步至其他节点，避免集群数据不一致。