simonxlh/ks-installer

在现有 Kubernetes 集群上安装 KubeSphere

除了支持在虚拟机和裸机上部署外，KubeSphere 还支持在云托管和本地 Kubernetes 集群上安装。

前置条件

• Kubernetes 版本：1.13.x、1.14.x、1.15.x（beta2 版本支持 1.16.x）；
• Helm 版本：>= 2.10.0（不包括 2.16.0），详见 在 Kubernetes 中安装和配置 Helm；
• CPU > 1 核，内存 > 2G；
• Kubernetes 集群中已存在存储类（Storage Class）。

1. 确保 Kubernetes 版本高于 1.13.0，在集群节点中运行 kubectl version。输出示例如下：

bash
root@kubernetes:~# kubectl version
Client Version: version.Info{Major:"1", Minor:"15", GitVersion:"v1.15.1", GitCommit:"4485c6f18cee9a5d3c3b4e523bd27972b1b53892", GitTreeState:"clean", BuildDate:"2019-07-18T09:09:21Z", GoVersion:"go1.12.5", Compiler:"gc", Platform:"linux/amd64"}
Server Version: version.Info{Major:"1", Minor:"15", GitVersion:"v1.15.1", GitCommit:"4485c6f18cee9a5d3c3b4e523bd27972b1b53892", GitTreeState:"clean", BuildDate:"2019-07-18T09:09:21Z", GoVersion:"go1.12.5", Compiler:"gc", Platform:"linux/amd64"}

注意：关注 Server Version 行，若 GitVersion 大于 v1.13.0 则符合要求。否则需先升级 Kubernetes，可参考 https://v1-13.docs.kubernetes.io/docs/tasks/administer-cluster/kubeadm/kubeadm-upgrade-1-13/%E3%80%82

2. 确保已安装 Helm 且版本高于 2.10.0。运行 helm version 检查，输出示例如下：

bash
root@kubernetes:~# helm version
Client: &version.Version{SemVer:"v2.13.1", GitCommit:"618447cbf203d147601b4b9bd7f8c37a5d39fbb4", GitTreeState:"clean"}
Server: &version.Version{SemVer:"v2.13.1", GitCommit:"618447cbf203d147601b4b9bd7f8c37a5d39fbb4", GitTreeState:"clean"}

注意：若提示 helm: command not found，表示未安装 Helm，可参考 https://helm.sh/docs/using_helm/#from-the-binary-releases%EF%BC%8C%E5%AE%89%E8%A3%85%E5%90%8E%E9%9C%80%E5%85%88%E8%BF%90%E8%A1%8C helm init。若版本低于 2.10.0，需 https://github.com/helm/helm/blob/master/docs/install.md#upgrading-tiller%E3%80%82

3. 检查集群可用资源是否满足最低要求：

bash
root@kubernetes:~# free -g
              total        used        free      shared  buff/cache   available
Mem:              16          4          10           0           3           2
Swap:             0           0           0

4. 检查集群是否存在默认存储类，KubeSphere 安装需依赖现有存储类：

bash
root@kubernetes:~$ kubectl get sc
NAME                      PROVISIONER               AGE
glusterfs (default)       kubernetes.io/glusterfs   3d4h

若 Kubernetes 集群环境满足以上 4 项要求，即可开始安装。

开始部署 KubeSphere

最小化安装

注意：以下步骤默认仅用于最小化安装。KubeSphere v2.1.0 已解耦部分核心组件，如需安装更多可插拔组件，详见下文“启用可插拔组件”和“配置表”。

yaml
$ kubectl apply -f https://raw.githubusercontent.com/kubesphere/ks-installer/master/kubesphere-minimal.yaml

查看安装日志：

bash
$ kubectl logs -n kubesphere-system $(kubectl get pod -n kubesphere-system -l app=ks-install -o jsonpath='{.items[0].metadata.name}') -f

当 KubeSphere 所有 Pod 运行正常时，安装成功。可通过 http://IP:30880 访问控制台，默认账号 admin/P@88w0rd。

启用可插拔组件

注意：确保集群有足够的 CPU 和内存资源，详见下文“配置表”。

1. 创建 Kubernetes 集群 CA 证书 Secret。启用 DevOps 和 OpenPitrix 组件需依赖 CA 证书。

注意：根据集群 ca.crt 和 ca.key 的实际路径创建 Secret。通常，kubeadm 创建的集群证书路径为 /etc/kubernetes/pki。

bash
$ kubectl create ns kubesphere-system

$ kubectl -n kubesphere-system create secret generic kubesphere-ca  \
--from-file=ca.crt=/etc/kubernetes/pki/ca.crt  \
--from-file=ca.key=/etc/kubernetes/pki/ca.key

2. 创建 etcd 证书 Secret（仅启用 etcd 监控时需要）。

注意：根据集群 etcd 证书实际路径创建；若 etcd 未配置证书，需创建空 Secret。

• 若 etcd 已配置证书（以下为 kubeadm 创建集群的示例）：

bash
$ kubectl -n kubesphere-monitoring-system create secret generic kube-etcd-client-certs  \
--from-file=etcd-client-ca.crt=/etc/kubernetes/pki/etcd/ca.crt  \
--from-file=etcd-client.crt=/etc/kubernetes/pki/etcd/healthcheck-client.crt  \
--from-file=etcd-client.key=/etc/kubernetes/pki/etcd/healthcheck-client.key

• 若 etcd 未配置证书：

bash
$ kubectl -n kubesphere-monitoring-system create secret generic kube-etcd-client-certs

3. 编辑 ConfigMap 启用所需可插拔组件：

bash
$ kubectl edit cm ks-installer -n kubesphere-system

注意：编辑完成后退出，将自动触发安装。

4. 查看安装日志：

bash
$ kubectl logs -n kubesphere-system $(kubectl get pod -n kubesphere-system -l app=ks-install -o jsonpath='{.items[0].metadata.name}') -f

当 KubeSphere 所有 Pod 运行正常时，安装成功。可通过 http://IP:30880 访问控制台，默认账号 admin/P@88w0rd。

!KubeSphere 控制台

配置表

注意第一列的资源要求，启用日志、DevOps、Istio、Harbor 和 GitLab 等组件时，需确保集群有足够的 CPU 和内存资源。

支持、讨论和社区

如需 KubeSphere 相关帮助，请加入 Slack 频道。