**《KubeSphere平台安装系列》**

【Kubernetes上安装KubeSphere（亲测–实操完整版）】（1/3）

【Linux单节点部署KubeSphere】（2/3）

【Linux多节点部署KubeSphere】（3/3）

**《KubeSphere平台安装系列》**

（kubekey一键安装docker+k8s和kubesphere）
网络要好，必须稳定！
网络要好，必须稳定！
网络要好，必须稳定！

1、准备一台 Linux 机器

硬件推荐配置

操作系统	最低配置
Ubuntu 16.04, 18.04, 20.04, 22.04	2 核 CPU，4 GB 内存，40 GB 磁盘空间
Debian Buster, Stretch	2 核 CPU，4 GB 内存，40 GB 磁盘空间
CentOS 7.x	2 核 CPU，4 GB 内存，40 GB 磁盘空间
Red Hat Enterprise Linux 7	2 核 CPU，4 GB 内存，40 GB 磁盘空间
SUSE Linux Enterprise Server 15/openSUSE Leap 15.2	2 核 CPU，4 GB 内存，40 GB 磁盘空间

以上的系统要求和以下的教程适用于没有启用任何可选组件的默认最小化安装。如果您的机器至少有 8 核 CPU 和 16 GB 内存，则建议启用所有组件。

本文采用下面的机子配置：

• 4核8g；centos7.9；防火墙放行k8s所有端口 30000~32767；

指定hostname

hostnamectl set-hostname k8s-single-node01

使用Xshell连接主机：

关闭防火墙（放行所有端口）

systemctl stop firewalld
systemctl disable firewalld

查看防火墙状态：

firewall-cmd --state

2、安装

一键安装kubesphere

2.1、准备KubeKey

先执行以下命令以确保您从正确的区域下载 KubeKey。

# 导出kk的环境变量
export KKZONE=cn

执行以下命令下载 KubeKey。

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

为 kk 添加可执行权限：

chmod +x kk

其中kk就是可执行安装文件。

2.2、使用KubeKey引导安装集群

执行一个命令即可进行安装 Kubernetes 和 KubeSphere，如以下示例命令：

./kk create cluster --with-kubernetes v1.20.4 --with-kubesphere v3.1.1

上述问题是有两个环境没有安装，执行下列命令进行安装：

yum install -y conntrack
yum install -y socat

安装完毕后，继续执行上述kk安装命令开始安装k8s和kubesphere

输入 yes 继续安装流程。

2.3、验证安装结果

首先，查看pod的运行状态：

kubectl get pod -A

等待所有pod状态变为running。

输入以下命令以检查安装结果。

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

输出信息会显示 Web 控制台的 IP 地址和端口号，默认的 NodePort 是 30880。

注意：安装 KubeSphere 3.4 的建议 Kubernetes 版本：v1.20.x、v1.21.x、v1.22.x、v1.23.x、* v1.24.x、* v1.25.x 和 * v1.26.x。带星号的版本可能出现边缘节点部分功能不可用的情况。因此，如需使用边缘节点，推荐安装 v1.23.x。

安装完成后，您会看到如下内容：

现在，您可以通过 <NodeIP:30880 使用默认帐户和密码 (admin/P@88w0rd) 访问 KubeSphere 的 Web 控制台。

注意：若要访问控制台，您可能需要根据您的环境配置端口转发规则。还请确保在您的安全组中打开了端口 30880。

3、安装后开启功能

3.1、可开启的所有组件

• KubeSphere 应用商店
  一个可以在内部实现数据和应用共享、并制定应用交付流程的行业标准的组件。

• KubeSphere DevOps
  启用 DevOps 系统来进一步解放您的开发人员，专注于代码编写。

• KubeSphere 日志系统
  启用日志，利用基于租户的系统进行日志收集、查询和管理。

• KubeSphere 事件系统
  了解如何启用 KubeSphere 事件模块来跟踪平台上发生的所有事件。

• KubeSphere 告警系统
  了解如何启用告警功能，以便在潜在问题对您的业务造成影响之前提前识别这些问题。

• KubeSphere 审计日志
  了解如何启用审计来记录平台事件和活动。

• KubeSphere 服务网格
  了解如何启用服务网格，从而提供不同的流量管理策略进行微服务治理。

• 网络策略
  了解如何启用网络策略来控制 IP 地址或端口级别的流量。

• Metrics Server
  了解如何启用 Metrics Server 以使用 HPA 对部署进行自动伸缩。

• 服务拓扑图
  了解如何启用服务拓扑图，以基于 Weave Scope 查看容器组的上下文详情。

• 容器组 IP 池
  了解如何启用容器组 IP 池，为您的容器组分配一个特定的容器组 IP 池。

• KubeEdge
  了解如何启用 KubeEdge 为您的集群添加边缘节点。

3.2、开启devops组件的详细步骤

1. 以 admin 用户登录控制台，点击左上角的平台管理，选择集群管理。

2. 点击定制资源定义，在搜索栏中输入 clusterconfiguration，点击搜索结果查看其详细页面。

    定制资源定义（CRD）允许用户在不新增 API 服务器的情况下创建一种新的资源类型，用户可以像使用其他 Kubernetes 原生对象一样使用这些定制资源。
   

3. 在自定义资源中，点击 ks-installer 右侧的 ，选择编辑 YAML。

4. 在该 YAML 文件中，搜索 devops，将 enabled 的 false 改为 true。完成后，点击右下角的确定，保存配置。

devops:
  enabled: true # 将“false”更改为“true”。

5. 在 kubectl 中执行以下命令检查安装过程：

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

3.3、验证组件的安装

执行以下命令来检查容器组的状态：

kubectl get pod -n kubesphere-devops-system

如果组件运行成功，输出结果如下：

NAME                          READY   STATUS    RESTARTS   AGE
ks-jenkins-8957dc768-75mvk   1/1     Running   0          7m16s
s2ioperator-0                1/1     Running   0          7m33s

---

当你觉得自己很难的时候，说明你在走上坡路，别急，美好正在马不停蹄地赶来的路上。

---