• FAQ

  • v3.1.0 常见问题

Q：KubeSphere v3.0.0 升级 v3.1.0 报错的问题 原文链接

在 v3.0.0 升级到 v3.1.0 时，执行如下升级命令失败，错误信息如下:

# kk upgrade -f config-kubesphere.yaml –with-kubesphere v3.1.0
Failed to download cluster config: Unable to convert file to yaml: yaml: unmarshal errors:
  line 66: cannot unmarshal !!str nfsclie… into []string

config-kubesphere.yaml 的 addons 内容如下：

addons:
- name: nfs-client
   namespace: kube-system
   sources:
     chart:
       name: nfs-client-provisioner
       repo: https://charts.kubesphere.io/main
       values: nfs-client-provider.yaml

解决方法

出现这个问题原因是安装 charts 指定 values.yaml 时，需要使用 valuesFile ，上述配置改成如下

addons:
- name: nfs-client
   namespace: kube-system
   sources:
     chart:
       name: nfs-client-provisioner
       repo: https://charts.kubesphere.io/main
       valuesFile: nfs-client-provider.yaml

Q：更新时提示会先升级至 v1.19.9 或其他版本导致缺包的报错如何处理？原文链接

解决方法

由于 kubeadm 不支持跨版本升级 K8s , kk 在升级时会逐个版本进行升级，中间过渡版本会取用kk中支持的最新版本，kk支持的 v1.19 的最新版本是 v1.19.9，所以这里取用 v1.19.9 作为过渡版本。镜像列表里只是添加了几个安装时常用的 K8s 版本。缺的包可以手动进行添加。

Q：v3.1.0 的 openpitrix 跑哪去了？原文链接

解决方法

v3.1.0 中已将 openpitrix 集成到了 KubeSphere 中。

Q：v3.1.0 版本的多集群应用是否有 kubefed 的 RSP 功能，后面是否有支持的计划？ 原文链接

解决方法

v3.1.0 暂时不支持，v3.1.1 暂时也没有支持的计划会更关注于 bug 修复，目前可以通过 kubectl 使用 RSP，在更远期的计划中会支持 RSP。

Q：升级 v3.1.0 版本，原有的 KubeSphere 组件 etcd, redis, mysql，minio 还是存在，是否可以删除？原文链接

解决方法

etcd 和 mysql 可以删除，redis 和 minio 不要删，注意 kubesphere-config 里的配置要相应修改。

Q：怎么更换 jenkins 的版本?

解决方法

可以通过 Fork 仓库 https://github.com/kubesphere/ks-jenkins/blob/master/formula.yaml，并修改其中 Jenkins 的版本重新构建出新的镜像。在使用新版本之前，请确保阅读了 Jenkins 社区官方给出的升级指南，并在做好备份的情况下测试兼容性。没有兼容性问题后方可升级。

Q：KubeSphere v3.1.0 边缘节点的容器组 nodelocaldns, kube-proxy calico-node 一直在等待中。这三个组件 KubeEdge 的边缘节点需要吗？不安装有什么影响？原文链接

解决方法

如果边缘节点使用外网 ip 和端口通信，这些 daemonset 的容忍度比较强，需要给它们 patch 一下，避免调度到边缘端。

Q：请问使用 KubeSphere v3.1.0 镜像构建器构建的时候出现这种错误是什么原因？

报错信息：

InternalError

Internal error occurred: failed calling webhook “mutating-create-update-s2ibuilder.kubesphere.io”: Post https://webhook-server-service.kubesphere-devops-system.svc:443/mutating-create-update-s2ibuilder?timeout=30s: x509: certificate signed by unknown authority

解决方法

如果是从 v3.0.0 升级到 v3.1.0 版本会出现这个问题，参考：kubesphere/kubesphere#3827。

临时解决方案，换掉 webhook：

（1）保存以下 yaml 到文件 webhook.yaml 中

（2）并使用 kubectl replace -f webhook.yaml

Yaml详情链接

Q：升级到 v3.1.0 后选择代码仓库配置上 gitlab 后无法读取到项目列表? 参考配置链接

解决方法

默认只能列出公有仓库，如果想要列出私有仓库，则需要去 Jenkins 那边配置 Gitlab。

Q：KubeSphere v3.1.0 企业空间配额和项目配额是否支持存储容量参数？

回答

企业空间配额暂不支持存储容量，项目配额支持，但 3.1.0 控制台有 bug，可通过 yaml 方式支持。

Q：KubeSphere v3.1.0 使用 b2i 功能的时候，在上传完 jar 或者 war 文件并完成相关参数配置后，点击创建，提示报错"Required value not specified for ‘buildImage’"

解决方法

手动选择“环境构建”下拉框，选择所需的构建环境后再构建。

Jeff 更改标题为「v3.1.0 常见问题」
6 个月 后