使用EKS Anywhere在CentOS7创建集群出现etcd等待超时错误如何解决

报错信息：Error: failed to create cluster: error waiting for external etcd for workload cluster to be ready: error executing wait: error: timed out waiting for the condition on clusters/dev-cluster

常见遗漏配置项 #

• 系统内核配置：CentOS7默认内核版本为3.10，EKS Anywhere要求最低内核版本为4.18+，未升级内核会导致etcd进程无法正常启动
• 端口放行配置：未放开etcd所需的2379（客户端通信）、2380（节点间通信）、2381（健康检查）端口，节点间通信被阻断导致etcd集群选举失败
• 时间同步配置：所有节点未配置NTP时间同步，节点间时间差超过1s会直接导致etcd集群启动失败
• 资源配额配置：etcd节点的CPU、内存配额未达到最低要求（单节点最低2C4G，生产环境建议4C8G），资源不足导致etcd进程启动后被系统终止
• 安全规则配置：未关闭SELinux或者firewalld未配置正确的放行规则，阻断集群内部组件通信
• 镜像拉取配置：未配置正确的镜像源地址或者镜像拉取凭证，导致etcd相关镜像拉取失败，进程无法启动

排查解决步骤 #

1. 执行eksctl anywhere generate clusterconfig dev-cluster --provider <你的部署提供商，如baremetal/docker> > standard.yaml生成官方标准配置模板，和你当前使用的配置文件逐项比对，确认etcd相关的节点规格、镜像地址、端点配置没有拼写错误
2. 在所有etcd节点执行uname -r确认内核版本不低于4.18，低于该版本的话先升级内核，重启节点后再重试集群创建
3. 在所有节点执行timedatectl检查时间同步状态，确保NTP服务处于活跃运行状态，节点间时间差不超过500ms
4. 临时关闭所有节点的firewalld和SELinux验证是否为安全规则阻断：

systemctl stop firewalld
setenforce 0

如果关闭后集群可以正常创建，再按需配置对应的端口放行规则即可
5. 登录管理节点执行docker ps -a | grep etcd查看etcd容器的运行状态，如果容器处于退出状态，执行docker logs <etcd容器ID>查看具体报错信息，针对性处理
6. 如果是离线环境部署，确认所有etcd相关镜像已经提前导入到本地镜像仓库，配置文件中的镜像仓库地址填写正确

内容的提问来源于stack exchange，提问作者bomsabado