Skip to main content
Version: v25.03

FAQ

1. 使用其他操作系统安装openFuyao失败​

当前openFuyao仅支持ubuntu和openEuler操作系统，安装时检测到其他系统后默认报错停止安装。

2. 使用1.1.3版本runc安装openFuyao时失败​

当前openFuyao仅支持1.1.12版本的runc，安装时检测到其他runc版本后默认报错停止安装。

3. 在包管理页面添加包后未正常显示新加入包​

可能是网络波动等因素造成的同步失败，手动单击“同步”即可。

4. 添加远端仓库报错unable to find index.yaml, please provide correct ChartMuseum project url​

远端仓库链接填写不正确，需要确保url指定了harbor仓内具体的项目名，如openFuyao官方仓https://harbor.openfuyao.com/chartrepo/openfuyao-catalog指定了项目“openfuyao-catalog”。

5. 在集群内邀请平台管理员加入，对其设置cluster角色后对应权限不生效​

如果用户已经是platform admin角色，再对其设置cluster级角色后权限仍然是platform admin权限。platform admin角色权限优先级最高。

6. cluster admin用户无法邀请其他用户加入集群​

主要原因是该用户没有platform admin权限，需要先为该用户配置platform admin角色后才可以邀请其他用户。

7. 安装时报错open/root/.ssh/known_hosts: no such file or directory​

未配置免密登录或免密登录后未重新登录导致，具体步骤参考安装部署文档。

8. 应用卸载后再次部署时部署失败​

应用卸载需要一定的时间，立刻单击部署可能因未完全卸载完成导致部署失败，建议等待几分钟后再次部署。

9. 在线部署集群、添加节点或导出离线制品时拉取镜像失败​

为统一镜像获取途径，除离线安装外，其他场景所需镜像均从openFuyao官方harbor仓库获取，即https://harbor.openfuyao.com。因为当前openFuyao未全面开源，openFuyao官方harbor仓库有配置访问白名单，即只有在白名单内的IP地址方可访问官方harbor仓库。在线部署集群、添加节点或导出离线制品出现拉取镜像失败，且确认机器网络正常后，请联系openFuyao社区维护人员。

10. 在线部署集群、添加节点或导出离线制品时获取二进制文件失败​

为统一镜像获取途径，除离线安装外，其他场景所需二进制文件均从openFuyao官方OBS获取，即https://openfuyao.obs.cn-north-4.myhuaweicloud.com,openFuyao官方OBS存放的二进制文件均从对应官方渠道获取。若在安装过程中出现获取二进制文件失败，请联系openFuyao社区维护人员。

11. 使用火狐浏览器访问openFuyao平台日志模块时出现异常​

当使用火狐浏览器访问openFuyao平台日志模块，出现页面无法打开或者数据显示异常时，请手动清理浏览器缓存即可。

12. 浏览器与服务器的时间差异可能导致部分监控数据受到影响​

当前浏览器与服务器之间存在时间差异，可能会出现数据延迟或错位。为避免持续的影响，建议检查本地设备时间设置，并确保与服务器时间同步。调整浏览器时间后，变更生效可能需要一段时间。

13. 如何修改openFuyao管理面暴露端口​

当前openFuyao管理面默认端口号为31616，如果要修改默认端口号为其他端口，下面以25.03版本为例进行演示处理。

输入图片说明 说明：
此步骤以安装包fuyao-v25.03-openEuler-22.03-amd64为例，其他安装包处理步骤类似。

  • 操作步骤

    1. 下载openFuyao安装包完成后，解压安装包内asset目录下的shell脚本压缩包。
     cd asset
     tar -zxvf fuyao-openEuler-22.03-amd64.tar.gz
    1. 编辑fuyao-openEuler-22.03-amd64/ingress/ingress-nginx/resource/ingress-nginx.yaml文件，在372行左右找到nodePort: 31616字样，修改31616为其他端口号，修改处如下。
    367 - appProtocol: https
    368   name: https
    369   port: 443
    370   protocol: TCP
    371   targetPort: https
    372   nodePort:  31616 # 修改项
    1. 完成修改后删除原fuyao-openEuler-22.03-amd64.tar.gz，并压缩fuyao-openEuler-22.03-amd64为fuyao-openEuler-22.03-amd64.tar.gz。
    rm -f fuyao-openEuler-22.03-amd64.tar.gz
    tar -czvf fuyao-openEuler-22.03-amd64.tar.gz ./fuyao-openEuler-22.03-amd64/*
    1. 至此已经完成端口号修改，可继续按照《安装指导》安装集群，完成集群安装后需使用修改后的端口号访问openFuyao管理面。

14. Pod拉起失败，kubectl logs查看日志时出现failed to create fsnotify watcher: too many open files​

可能是因为系统默认的fs.inotify.max_user_instances太小，在pod所在节点重新设置此值即可。若为多节点集群安装部署，可为全部节点重新设置fs.inotify.max_user_instances，以避免报错。

方案一：临时设置fs.inotify.max_user_instances值。

sudo sysctl fs.inotify.max_user_instances=8192

输入图片说明说明： 重新进入控制台时需再次设置。

方案二：永久保存fs.inotify.max_user_instances值。

echo fs.inotify.max_user_instances=8192| tee -a /etc/sysctl.conf && sudo sysctl -p

15. yum/apt指令失效​

BKE安装部署过程中修改了系统文件，可能导致安装部署过程中或者安装完成后的环境中使用yum/apt指令失败，手动改回即可：

cd /etc/yum.repos.d/bak
cp ./openEuler.repo ..

16. 在集群生命周期管理中删除集群失败​

前台无法删除IP地址不通的集群，有此需求时，建议登录后台进行手动删除：

kubectl get bc -n <namespace>
kubectl delete bc <bc-name> -n <namespace>