自2021年4月29日KubeSphere开源社区宣布KubeSphere3.1.0正式发布以来，社区用户以各种方式途径获取部署升级到3.1.0来体验最新版本在强大功能，由于社区用户所处环境不同可能会遇到升级失败或需花大量时间去踩坑，为帮助大家更准确的进行部署升级，整理出以下全新部署及升级的教程，希望对大家有所帮助，如有不对的地方请指正

一、环境配置
1.准备三台linux干净的机器

IP	             操作系统	角色
192.168.174.133	centos7.6	k8s-master
192.168.174.134	centos7.6	k8s-node1
192.168.174.135	centos7.6	k8s-node2

2.查看内核版本

[root@localhost ~]# cat /etc/redhat-release
 CentOS Linux release 7.4.1708 (Core)

3.添加hosts文件（每台都要）

 [root@localhost ~]# cat >> /etc/hosts << EOF
 > 192.168.174.133 k8s-master
 > 192.168.174.134 k8s-node1
 > 192.168.174.135 k8s-node2
 > EOF

4.保证机器之间可以互相访问

 [root@localhost ~]# ping 192.168.174.134
 PING 192.168.174.134 (192.168.174.134) 56(84) bytes of data.
 64 bytes from 192.168.174.134: icmp_seq=1 ttl=64 time=0.624 ms
 64 bytes from 192.168.174.134: icmp_seq=2 ttl=64 time=0.400 ms

5.关闭防火墙 （每台都要）

 [root@localhost ~]# systemctl stop firewalld
 [root@localhost ~]# systemctl disable firewalld

6.关闭Selinux （每台都要）

 vi /etc/sysconfig/selinux
 SELINUX=disabled

7.替换阿里源 （每台都要）

 mv /etc/yum.repos.d/CentOS-Base.repo /etc/yum.repos.d/CentOS-     Base.repo.backup
 #备份
 #下载新的 CentOS-Base.repo 到 /etc/yum.repos.d/
 curl -o /etc/yum.repos.d/CentOS-Base.repo         https://mirrors.aliyun.com/repo/Centos-7.repo
 yum makecache
 yum update(可选)

8.安装常用软件 (每台都要）

 [root@localhost ~]# yum -y install epel-release.noarch conntrack   ipvsadm ipset jq sysstat curl iptables libseccomp vim lrzsz bash-   completion

9.关闭swap分区 (每台都要）

 [root@localhost ~]# swapoff -a
 [root@localhost ~]# sed -i '/ swap / s/^\(.*\)$/#\1/g' /etc/fstab

二、安装KubeSphere3.1
1.先执行以下命令以确保可以从正确的区域下载 KubeKey

 export KKZONE=cn

2.执行以下命令下载 KubeKey

 curl -sfL https://get-kk.kubesphere.io | VERSION=v1.1.0 sh -

备注：下载 KubeKey 后，如果您将其传输至访问 Googleapis 同样受限的新机器，请您在执行以下步骤之前务必再次执行 export KKZONE=cn 命令。

3.为 kk 添加可执行权限

 chmod +x kk

4、创建集群

对于多节点安装，需要通过指定配置文件来创建集群。

 ./kk create config --with-kubesphere v3.1.0 --with-kubernetes v1.17.9

备注：安装 KubeSphere v3.1.0 的建议 Kubernetes 版本：v1.17.9，v1.18.8，v1.19.8 以及 v1.20.4。如果不指定 Kubernetes 版本，KubeKey 将默认安装 Kubernetes v1.19.8

5.编辑配置文件

 spec:
  hosts:
   - {name: k8s-master, address: 192.168.174.133, internalAddress:      192.168.174.133, user: ubuntu, password: 123456}
   - {name: k8s-node1, address: 192.168.174.134, internalAddress:    192.168.174.134, user: ubuntu, password: 123456}
   - {name: k8s-node2, address: 192.168.174.135, internalAddress:    192.168.174.135, user: ubuntu, password: 123456}
  roleGroups:
    etcd:
     - k8s-master
    master:
     - k8s-master
    worker:
     - k8s-node1
     - k8s-node2
  controlPlaneEndpoint:
    domain: lb.kubesphere.local
    address: ""
    port: "6443"
    ```
6.使用配置文件创建集群
```bash
 ./kk create cluster -f config-sample.yaml

7.验证安装

 #####################################################
 ###             Welcome to KubeSphere!           ###
 #####################################################
 
 Console: http://192.168.174.133:30880
 Account: admin
 Password: P@88w0rd
 
 NOTES：
   1. After logging into the console, please check the
      monitoring status of service components in
      the "Cluster Management". If any service is not
      ready, please wait patiently until all components
      are ready.
   2. Please modify the default password after login.
 
 #####################################################
 https://kubesphere.io             2021-05-03 07:50:33
 #####################################################

8.登录平台

9.启用kubectl自动补全

 yum -y install bash-completion
 echo 'source <(kubectl completion bash)' >>~/.bashrc
 kubectl completion bash >/etc/bash_completion.d/kubectl

三、升级 Kubernetes及KubeSphere
方式一：使用 ks-installer 升级

说明：对于 Kubernetes 集群不是通过 KubeKey 部署而是由云厂商托管或自行搭建的用户，推荐使用 ks-installer 升级。集群运维员应负责提前升级 Kubernetes。

准备工作
1.需要有一个运行 KubeSphere v3.0.0 的集群。如果您的 KubeSphere 是 v2.1.1 或更早的版本，请先升级至 v3.0.0。

2.请仔细阅读 Release Notes for 3.1.0。

3.提前备份所有重要的组件。

4.KubeSphere v3.1.0 支持的 Kubernetes 版本：v1.17.x、v1.18.x、 v1.19.x 和 v1.20.x。

运行以下命令升级集群：

 kubectl apply -f https://github.com/kubesphere/ks-installer/releases/download/v3.1.0/kubesphere-installer.yaml

方式二:使用KubeKey 升级

说明：对于 KubeSphere 和 Kubernetes 都由 KubeKey 部署的用户，推荐使用 KubeKey 升级。如果您的 Kubernetes 集群由云厂商托管或自行配置，参考方式一

官网链接：https://kubesphere.io/zh/docs/upgrade/upgrade-with-kubekey/

FAQ：部署全新3.1及升级到3.1问题
1.如何升级至特定版本，怎么升级？

答：要将 Kubernetes 升级至特定版本，请在 --with-kubernetes 标志后明确指定版本号。以下是可用版本：

v1.17.0, v1.17.4, v1.17.5, v1.17.6, v1.17.7, v1.17.8, v1.17.9

v1.18.3, v1.18.5, v1.18.6, v1.18.8

v1.19.0, v1.19.8, v1.19.9

v1.20.4

2.kubernetes版本升级到1.20.4后为什么docker命令用不了？

答：kubernetes1.20正式版后将弃用docker，具体参考

kubernetes官网 http://kubernetes.io/

3.kubernetes低版本为什么不能直接升级到高版本？

答：kubernetes本身不支持跨大版本升级，小版本不用单独升级，只需升级大版本例如：1.16-.1.17-1.18

4.安装和升级过程中遇到如下报错？（免密登录的问题）：

1.先在本机生成密钥

 ssh-keygen   #三下回车即可

2.生成之后会在用户的根目录生成一个 “.ssh”的文件夹，进入“.ssh”会生成以下几个文件

 cd /root/.ssh

3.追加id_ras.pub信息

 cat id_rsa.pub >> authorized_keys

4.重新执行安装或升级命令即可

掏出手机微信扫一扫哦
​​​​​​