集群导入预检FAQ

本文介绍在EDAS控制台导入Kubernetes集群时可能遇到的常见问题,并提供对应的解决方案。

索引

预检项目失败一定会导入失败吗?

预检项目失败时,可能会导致集群导入失败,或导入成功后无法正常使用。建议查明检查项目失败的原因后再进行下一步操作。

预检项目结果为告警,需要关注吗?

预检结果为告警的项目,只影响特定部分功能。若无需使用该部分功能,可忽略影响,继续导入。

预检项目结果为检测中断,该怎么办?

表示遇到一些非预期情况,请加入钉群(钉群号:23197114)咨询产品技术专家或新建集群导入。

集群版本检查不通过,该怎么办?

如果您使用的是最新版本的K8s集群,EDAS可能还未完成集群适配,此时会提示集群版本检查不通过。当集群版本检查不通过时,目前无法导入集群。建议先使用较低版本的集群,待EDAS完成版本适配后,再将集群更新至较新版本。

集群可用资源检查异常,该怎么办?

集群可用资源检查通过,但提示以下信息

提示信息

解决方案

Some nodes not ready

表示当前集群存在未就绪的节点。该情况不影响导入集群操作,但建议在容器服务管理控制台对该节点进行异常情况排查。

集群可用资源检查不通过,提示以下信息

提示信息

解决方案

资源Pod余量不足

请扩容集群节点。

  • 当集群网络插件为Flannel时,需在容器服务管理控制台创建集群页面,配置节点IP数量处,预留约12个Pod IP用于安装EDAS管控组件。

  • 当集群网络插件为Terway时,节点允许创建的Pod数量依赖于ECS实例规格所提供的弹性网卡数量,建议选择较高规格和较新类型的ECS。

    关于Terway网络插件,请参见使用Terway网络插件

资源Memory Max

请扩容集群节点。当前集群中,至少需要一个节点预留约1.5 GB可用内存,用于安装Prometheus组件。

No node availableNo node ready

请扩容集群节点。当前集群无可用Worker节点,请在容器服务管理控制台检查节点情况并扩容有效节点。

资源Memory total余量不足

请扩容集群节点。当前集群中,所有节点共需预留约3 GB可用内存,用于安装EDAS管控组件。

资源CPU Max

请扩容集群节点。当前集群中,至少需要一个节点预留约1.5核可用CPU,用于安装Prometheus组件。

资源CPU Total余量不足

请扩容集群节点。当前集群中,所有节点一共需要预留约2核可用CPU,用于安装EDAS管控组件。

集群安全组检查不通过,该怎么办?

提示信息

解决方案

Worker not in Cluster SecurityGroup

检查这些ECS实例是否位于K8s集群安全组中。若不存在,需手动添加。

安全组规则禁止Port:6443

该配置会影响弹性组件访问集群API-Server。若需限制6443端口的访问,请将集群中edas-oam-system空间下Pod调度到特定Worker节点中,并将该节点加入白名单,以便EDAS组件通过6443端口访问API-Server。

安全组规则未找到,规则:XXX

确认是否已手动修改集群安全组配置,需评估该情况下是否影响集群中网络的正常访问。若确认无影响,可忽略该检查项目。

集群API-Server SLB检查不通过,该怎么办?

提示信息

解决方案

ApiServerSLB modified

需检查当前集群API-Server SLB配置是否被修改或删除。

ApiServerSLB inactive

需检查当前集群API-Server SLB配置是否被修改。

集群RAM角色检查不通过,该怎么办?

提示信息

解决方案

RAM检查失败,原因是:node: xxx not attached to cluster RamRole: yyy

需检查xxx节点是否关联至集群RamRole中。

  1. 登录容器服务管理控制台

  2. 在左侧导航栏,单击集群

  3. 集群页面,单击集群操作列的详情,跳转至集群信息页面。

  4. 集群信息页面,单击集群资源页签,找到Worker RAM 角色

  5. 获取RAM角色名后,登录ECS管理控制台,找到对应ECS实例,查询是否绑定相应RAM角色。

集群镜像免密插件检查告警,该怎么办?

提示信息

解决方案

当前集群未安装镜像免密组件

该组件影响使用镜像仓库企业版相关功能。

  • 如无需使用镜像仓库企业版,可忽略该提示。

  • 如需使用镜像仓库企业版,请安装免密组件,无需进行免密相关配置。应用变更时,EDAS自动配置免密组件相关信息。安装免密组件,请参见使用免密组件拉取容器镜像

集群网络资源检查不通过,该怎么办?

提示信息

解决方案

Pod CIDR可用IP数量

当前集群中的Pod CIDR地址需至少预留两个可用IP,用于接入EDAS管控组件。若无可用IP,请重新规划VPC网络。

集群CRD资源检查告警,该怎么办?

提示信息

解决方案

Found CRD

  • 若您已安装开源OAM相关组件,可能造成CRD文件冲突,从而影响功能正常使用。请手动卸载所有开源OAM相关CRD资源。

  • 如果您未安装开源OAM相关组件,仅需重新导入EDAS,可忽略该提示。