今天，我们将一起探索如何在离线环境中部署
K8s v1.30.6
和
KubeSphere v4.1.2
高可用集群。对于离线环境的镜像仓库管理，官方推荐使用 Harbor 作为镜像仓库管理工具，它为企业级用户提供了高效、安全的镜像存储方案。而在本指南中，我们将以 Docker Registry 作为镜像仓库示例，展示如何实现离线部署。
如果您更倾向于使用 Harbor，请参考官方文档
KubeSphere 离线安装文档
[1]
获取具体的 Harbor 部署方式。
通过本文的指导，您将掌握以下关键技能：
离线环境部署 K8s 和 KubeSphere v4.1.2 高可用集群
离线环境安装配置 KubeSphere v4 的扩展组件
1. 部署方案规划
1.1 实战架构图
1.2 实战服务器规划
实战服务器配置 (架构 1:1 复刻小规模生产环境，配置略有不同)
主机名
IP
CPU
内存
系统盘
数据盘
用途
ksp-control-1
192.168.9.91
4
8
40
100
离线环境 k8s-control-plane
ksp-control-2
192.168.9.92
4
8
40
100
离线环境 k8s-control-plane
ksp-control-3
192.168.9.93
4
8
40
100
离线环境 k8s-control-plane
ksp-registry
192.168.9.90
4
8
40
100
离线环境部署节点和镜像仓库节点
ksp-artifact
192.168.2.89/192.168.9.89
4
8
40
100
联网主机用于制作离线包
合计
5
20
40
200
500
1.3 实战环境涉及软件版本信息
操作系统：
openEuler 24.03 LTS SP1 x86_64
2. 获取 KubeSphere 版本信息及镜像列表
KubeSphere 官方 从 v4 版本开始，提供了获取部署 KubeSphere 和扩展组件需要的所有镜像列表的官方网站，并且能根据需求选择不同组件组合生成。
打开浏览器，访问
https://get-images.kubesphere.io/
，访问页面如图所示：
本文出于演示目的仅选择常用的
「WhizardTelemetry 平台服务」
、
「WhizardTelemetry 监控」
和
「DevOps」
，请根据实际需求选择相应的扩展组件。
查看填写的邮箱，获取 KubeSphere 最新的版本信息以及镜像列表文件。
镜像列表文件如下：
文件名
描述
kubesphere-images.txt
包含 KubeSphere 及扩展组件涉及的所有镜像，以及在华为云的镜像地址，可根据该文件中的列表将镜像同步至离线仓库中。
kk-manifest.yaml
包含 KubeSphere 及扩展组件涉及的所有镜像，可使用 kk 快速构建离线包。
kk-manifest-mirror.yaml
包含华为云镜像仓库中 KubeSphere 及扩展组件涉及的所有镜像。访问 DockerHub 受限时可使用该 manifest 文件构建离线包。
3. 构建离线安装包
本文增加一台能联网的节点，在该节点下载 KubeKey 最新版（
v3.1.7
），用来构建离线安装包。
3.1 安装 KubeKey
执行以下命令下载
KubeKey
，下载完成后当前目录下将生成 KubeKey 二进制文件
kk
。
# 执行下载命令，获取最新版的 kk（受限于网络，有时需要执行多次）
3.2 创建
manifests
模板文件
KubeKey v3.1.0 之前，
manifests
文件需要根据模板手动编写， 现在可以通过 Kubekey 的
create manifest
命令自动生成
manifests
模板。
create manifest
支持的参数如下：
$ ./kk create manifest --help help help for manifestwhich reported error and force to continue "sample" )"kubekey-system" )
官方示例（支持多集群、多架构）：
# 示例：创建包含 kubernetes v1.24.17，v1.25.16，且 cpu 架构为 amd64、arm64 的 manifests 文件。
❝
注意：若只需要使用
KubeKey
打包 KubeSphere 镜像至离线环境中，可直接使用邮件中收到的 manifest 文件构建离线包。无需另外创建或编辑 manifest 文件。
若需要使用 kk 离线部署 K8s 以及镜像仓库，可参考以下步骤：
# 访问 DockerHub 受限，执行以下命令将 Kubernetes 镜像地址替换为阿里云仓库。 export KKZONE=cn"docker registry"
❝
参数说明：
--with-kubernetes： 指定 k8s 版本
--with-registry：使用 docker 作为镜像仓库
上面的命令将创建一个
manifest-sample.yaml
文件，具体内容如下：
apiVersion: kubekey.kubesphere.io/v1alpha2 kind: Manifest metadata: name: sample spec: arches: - amd64 operatingSystems: [] kubernetesDistributions: - type: kubernetes version:
v1.30.6 components: helm: version: v3.14.3 cni: version: v1.2.0 etcd: version: v3.5.13 containerRuntimes: - type: docker version: 24.0 .9 - type: containerd version: 1.7 .13 calicoctl: version: v3.27.4 crictl: version: v1.29.0 docker-registry: version: "2" harbor: version: v2.10.1 docker-compose: version: v2.26.1 images: - registry.cn-beijing.aliyuncs.com/kubesphereio/pause:3.9 - registry.cn-beijing.aliyuncs.com/kubesphereio/kube-apiserver:v1.30.6 - registry.cn-beijing.aliyuncs.com/kubesphereio/kube-controller-manager:v1.30.6 - registry.cn-beijing.aliyuncs.com/kubesphereio/kube-scheduler:v1.30.6 - registry.cn-beijing.aliyuncs.com/kubesphereio/kube-proxy:v1.30.6 - registry.cn-beijing.aliyuncs.com/kubesphereio/coredns:1.9.3 - registry.cn-beijing.aliyuncs.com/kubesphereio/k8s-dns-node-cache:1.22.20 - registry.cn-beijing.aliyuncs.com/kubesphereio/kube-controllers:v3.27.4 - registry.cn-beijing.aliyuncs.com/kubesphereio/cni:v3.27.4 - registry.cn-beijing.aliyuncs.com/kubesphereio/node:v3.27.4 - registry.cn-beijing.aliyuncs.com/kubesphereio/pod2daemon-flexvol:v3.27.4 - registry.cn-beijing.aliyuncs.com/kubesphereio/typha:v3.27.4 - registry.cn-beijing.aliyuncs.com/kubesphereio/flannel:v0.21.3 - registry.cn-beijing.aliyuncs.com/kubesphereio/flannel-cni-plugin:v1.1.2 - registry.cn-beijing.aliyuncs.com/kubesphereio/cilium:v1.15.3 - registry.cn-beijing.aliyuncs.com/kubesphereio/operator-generic:v1.15.3 - registry.cn-beijing.aliyuncs.com/kubesphereio/hybridnet:v0.8.6 - registry.cn-beijing.aliyuncs.com/kubesphereio/kube-ovn:v1.10.10 - registry.cn-beijing.aliyuncs.com/kubesphereio/multus-cni:v3.8 - registry.cn-beijing.aliyuncs.com/kubesphereio/provisioner-localpv:3.3.0 - registry.cn-beijing.aliyuncs.com/kubesphereio/linux-utils:3.3.0 - registry.cn-beijing.aliyuncs.com/kubesphereio/haproxy:2.9.6-alpine - registry.cn-beijing.aliyuncs.com/kubesphereio/kube-vip:v0.7.2 - registry.cn-beijing.aliyuncs.com/kubesphereio/kata-deploy:stable - registry.cn-beijing.aliyuncs.com/kubesphereio/node-feature-discovery:v0.10.0 registry: auths: {}
3.3 编辑
manifest
文件
KubeKey v3.1.7 生成的
manifest-sample.yaml
文件适用于部署 Kubernetes 集群以及镜像仓库。我们需要结合从邮件中获取到的 KubeSphere 镜像列表，生成一份新的
manifest
文件。
主要修改说明如下：
operatingSystems 配置默认为空，
新增 openEuler 配置
，以适配
openEuler 24.03 LTS SP1
，
openEuler-24.03-amd64.iso
是自己制作的适用于 openEuler 24.03 的离线系统安装包 ISO。
复制
kk-manifest-mirror.yaml
中的镜像列表，添加到新创建的
manifest-sample.yaml
文件中。
最终的
manifest
文件内容如下：
apiVersion: kubekey.kubesphere.io/v1alpha2 kind: Manifest metadata: name: sample spec: arches: - amd64 operatingSystems: - arch: amd64 type: linux id: openEuler version: "24.03" osImage: openEuler 24.03 (LTS) repository: iso: localPath: "/data/kubekey/openEuler-24.03-amd64.iso" url: kubernetesDistributions: - type: kubernetes version: v1.30.6 components: helm: version: v3.14.3 cni: version: v1.2.0 etcd: version: v3.5.13 containerRuntimes: - type: docker version: 24.0 .9 - type: containerd version: 1.7 .13 calicoctl: version: v3.27.4 crictl: version: v1.29.0 docker-registry: version: "2" harbor: version: v2.10.1 docker-compose: version: v2.26.1 images: ## kubernetes(跟默认比，删了几个没用的镜像) - registry.cn-beijing.aliyuncs.com/kubesphereio/pause:3.9 - registry.cn-beijing.aliyuncs.com/kubesphereio/kube-apiserver:v1.30.6 - registry.cn-beijing.aliyuncs.com/kubesphereio/kube-controller-manager:v1.30.6 - registry.cn-beijing.aliyuncs.com/kubesphereio/kube-scheduler:v1.30.6 - registry.cn-beijing.aliyuncs.com/kubesphereio/kube-proxy:v1.30.6 - registry.cn-beijing.aliyuncs.com/kubesphereio/coredns:1.9.3 - registry.cn-beijing.aliyuncs.com/kubesphereio/k8s-dns-node-cache:1.22.20 - registry.cn-beijing.aliyuncs.com/kubesphereio/kube-controllers:v3.27.4 - registry.cn-beijing.aliyuncs.com/kubesphereio/cni:v3.27.4 - registry.cn-beijing.aliyuncs.com/kubesphereio/node:v3.27.4 - registry.cn-beijing.aliyuncs.com/kubesphereio/pod2daemon-flexvol:v3.27.4 - registry.cn-beijing.aliyuncs.com/kubesphereio/typha:v3.27.4 - registry.cn-beijing.aliyuncs.com/kubesphereio/operator-generic:v1.15.3
- registry.cn-beijing.aliyuncs.com/kubesphereio/hybridnet:v0.8.6 - registry.cn-beijing.aliyuncs.com/kubesphereio/kube-ovn:v1.10.10 - registry.cn-beijing.aliyuncs.com/kubesphereio/multus-cni:v3.8 - registry.cn-beijing.aliyuncs.com/kubesphereio/provisioner-localpv:3.3.0 - registry.cn-beijing.aliyuncs.com/kubesphereio/linux-utils:3.3.0 - registry.cn-beijing.aliyuncs.com/kubesphereio/haproxy:2.9.6-alpine - registry.cn-beijing.aliyuncs.com/kubesphereio/kube-vip:v0.7.2 - registry.cn-beijing.aliyuncs.com/kubesphereio/node-feature-discovery:v0.10.0 ## ks-core - swr.cn-southwest-2.myhuaweicloud.com/ks/kubesphere/ks-apiserver:v4.1.2 - swr.cn-southwest-2.myhuaweicloud.com/ks/kubesphere/ks-console:v4.1.2 - swr.cn-southwest-2.myhuaweicloud.com/ks/kubesphere/ks-controller-manager:v4.1.2 - swr.cn-southwest-2.myhuaweicloud.com/ks/kubesphere/kubectl:v1.27.16 - swr.cn-southwest-2.myhuaweicloud.com/ks/kubesphere/redis:7.2.4-alpine - swr.cn-southwest-2.myhuaweicloud.com/ks/kubesphere/haproxy:2.9.6-alpine - swr.cn-southwest-2.myhuaweicloud.com/ks/kubesphere/ks-extensions-museum:v1.1.2 ## devops - swr.cn-southwest-2.myhuaweicloud.com/ks/kubesphere/devops-apiserver:v4.1.2 - swr.cn-southwest-2.myhuaweicloud.com/ks/kubesphere/devops-controller:v4.1.2 - swr.cn-southwest-2.myhuaweicloud.com/ks/kubesphere/devops-tools:v4.1.2 - swr.cn-southwest-2.myhuaweicloud.com/ks/kubesphere/devops-jenkins:v4.1.2-2.346.3 - swr.cn-southwest-2.myhuaweicloud.com/ks/jenkins/inbound-agent:4.10-2 - swr.cn-southwest-2.myhuaweicloud.com/ks/kubesphere/builder-base:v3.2.2 - swr.cn-southwest-2.myhuaweicloud.com/ks/kubesphere/builder-nodejs:v3.2.0 - swr.cn-southwest-2.myhuaweicloud.com/ks/kubesphere/builder-maven:v3.2.0 - swr.cn-southwest-2.myhuaweicloud.com/ks/kubesphere/builder-maven:v3.2.1-jdk11 - swr.cn-southwest-2.myhuaweicloud.com/ks/kubesphere/builder-python:v3.2.0 - swr.cn-southwest-2.myhuaweicloud.com/ks/kubesphere/builder-go:v3.2.0 - swr.cn-southwest-2.myhuaweicloud.com/ks/kubesphere/builder-go:v3.2.2-1.16 - swr.cn-southwest-2.myhuaweicloud.com/ks/kubesphere/builder-go:v3.2.2-1.17 - swr.cn-southwest-2.myhuaweicloud.com/ks/kubesphere/builder-go:v3.2.2-1.18 - swr.cn-southwest-2.myhuaweicloud.com/ks/kubesphere/builder-base:v3.2.2-podman - swr.cn-southwest-2.myhuaweicloud.com/ks/kubesphere/builder-nodejs:v3.2.0-podman - swr.cn-southwest-2.myhuaweicloud.com/ks/kubesphere/builder-maven:v3.2.0-podman - swr.cn-southwest-2.myhuaweicloud.com/ks/kubesphere/builder-maven:v3.2.1-jdk11-podman - swr.cn-southwest-2.myhuaweicloud.com/ks/kubesphere/builder-python:v3.2.0-podman - swr.cn-southwest-2.myhuaweicloud.com/ks/kubesphere/builder-go:v3.2.0-podman - swr.cn-southwest-2.myhuaweicloud.com/ks/kubesphere/builder-go:v3.2.2-1.16-podman - swr.cn-southwest-2.myhuaweicloud.com/ks/kubesphere/builder-go:v3.2.2-1.17-podman - swr.cn-southwest-2.myhuaweicloud.com/ks/kubesphere/builder-go:v3.2.2-1.18-podman - swr.cn-southwest-2.myhuaweicloud.com/ks/argoproj/argocd:v2.3.3 - swr.cn-southwest-2.myhuaweicloud.com/ks/argoproj/argocd-applicationset:v0.4.1 - swr.cn-southwest-2.myhuaweicloud.com/ks/dexidp/dex:v2.30.2 - swr.cn-southwest-2.myhuaweicloud.com/ks/library/redis:6.2.6-alpine ## whizard-monitoring - swr.cn-southwest-2.myhuaweicloud.com/ks/kubesphere/kubectl:v1.27.12 - swr.cn-southwest-2.myhuaweicloud.com/ks/kubesphere/kube-state-metrics:v2.12.0 - swr.cn-southwest-2.myhuaweicloud.com/ks/kubespheredev/kube-webhook-certgen:v20221220-controller-v1.5.1-58-g787ea74b6 - swr.cn-southwest-2.myhuaweicloud.com/ks/thanosio/thanos:v0.36.1 - swr.cn-southwest-2.myhuaweicloud.com/ks/brancz/kube-rbac-proxy:v0.18.0 - swr.cn-southwest-2.myhuaweicloud.com/ks/prometheus-operator/prometheus-config-reloader:v0.75.1 - swr.cn-southwest-2.myhuaweicloud.com/ks/prometheus-operator/prometheus-operator:v0.75.1 - swr.cn-southwest-2.myhuaweicloud.com/ks/prometheus/node-exporter:v1.8.1 - swr.cn-southwest-2.myhuaweicloud.com/ks/prometheus/prometheus:v2.51.2 - swr.cn-southwest-2.myhuaweicloud.com/ks/kubesphere/dcgm-exporter:3.3.5-3.4.0-ubuntu22.04 - swr.cn-southwest-2.myhuaweicloud.com/ks/kubesphere/process-exporter:0.5.0 - swr.cn-southwest-2.myhuaweicloud.com/ks/nginxinc/nginx-unprivileged:1.24 - swr.cn-southwest-2.myhuaweicloud.com/ks/kubesphere/calico-exporter:v0.3.0 - swr.cn-southwest-2.myhuaweicloud.com/ks/kubesphere/whizard-monitoring-helm-init:v0.1.0 ## whizard-telemetry - swr.cn-southwest-2.myhuaweicloud.com/ks/kubesphere/whizard-telemetry-apiserver:v1.2.2 registry: auths: {}
3.4 导出制品
artifact
mv openEuler-24.03-amd64.iso /data/kukekey/
根据生成的
manifest
，执行下面的命令制作制品（artifact）。
export KKZONE=cn
正确执行后，输出结果如下 :（
受限于篇幅，仅展示最终结果
）
$ ./kk artifact export -m manifest-sample.yaml -o kubesphere-v412-v1306-artifact.tar.gz'_ \ / _ \ \ / _ \ | | |
制品制作完成后，查看制品大小。
$ ls -lh kubesphere-v412-v1306-artifact.tar.gz
3.5 下载 KubeSphere Core Helm Chart
wget -qO- https://get.helm.sh/helm-v3.16.4-linux-amd64.tar.gz | tar -zxvf -local
/bin/# 清理残留
下载 KubeSphere Core Helm Chart。
helm fetch https://charts.kubesphere.io/main/ks-core-1.1.3.tgz
❝
说明：
此处为当前版本，请访问
KubeSphere 镜像列表官网
[2]
或
KubeSphere GitHub 仓库
[3]
查看最新 Chart 版本。
4. 准备离线部署的前置数据
注意：本文使用镜像仓库节点复用为部署节点，以下操作无特殊说明，均在（Registry）节点上执行。
4.1 上传离线部署资源包到部署节点
将以下离线部署资源包，上传至离线环境部署（Registry） 节点的
/srv/kubekey
目录（
可根据实际情况修改
）。
KubeSphere-v412-v1306-artifact.tar.gz
4.2 创建离线 K8s 集群配置文件
cd /srv/kubekey
命令执行成功后，在当前目录会生成文件名为
config-sample.yaml
的配置文件。
4.3 修改配置文件
执行命令：
vi config-sample.yaml
，修改离线集群配置文件
config-sample.yaml
。
修改
kind: Cluster
小节中 hosts 和 roleGroups 等信息，修改说明如下。
hosts：指定节点的 IP、ssh 用户、ssh 密码。同时，新增一个 Registry 节点的配置
roleGroups：指定 3 个 etcd、control-plane 节点，复用相同的机器作为 3 个 worker 节点
必须指定主机组
registry
作为仓库部署节点
internalLoadbalancer： 启用内置的 HAProxy 负载均衡器
system.rpms：
新增配置
，部署时安装 rpm 包（openEuler 系统默认没有安装 tar 包，必须提前安装）
containerManager：使用
containerd
storage.openebs.basePath：
新增配置
，指定 openebs 默认存储路径为
/data/openebs/local
registry：不指定
type
类型，默认安装 docker registry。同时设置相关参数
修改后的完整示例如下：
apiVersion: kubekey.kubesphere.io/v1alpha2 kind: Cluster metadata: name: sample spec: hosts: - {name: ksp-control-1, address: 192.168 .9 .91 , internalAddress: 192.168 .9 .91 , user: root, password: "OpsXlab2025!" } - {name: ksp-control-2, address: 192.168 .9 .92 , internalAddress: 192.168 .9 .92 , user: root, password: "OpsXlab2025!" } - {name: ksp-control-3, address: 192.168 .9 .93 , internalAddress: 192.168 .9 .93 , user: root, password: "OpsXlab2025!" } - {name: ksp-registry, address: 192.168 .9 .90 , internalAddress: 192.168 .9 .90 , user: root, password: "OpsXlab2025!" } roleGroups: etcd: - ksp-control-1 - ksp-control-2 - ksp-control-3 control-plane: - ksp-control-1 - ksp-control-2 - ksp-control-3 worker: - ksp-control-1 - ksp-control-2 - ksp-control-3 registry: - ksp-registry controlPlaneEndpoint: ## Internal loadbalancer for apiservers internalLoadbalancer: haproxy domain: lb.kubesphere.local address: ""
port: 6443 system: rpms: - tar kubernetes: version: v1.30.6 clusterName: cluster.local autoRenewCerts: true containerManager: containerd etcd: type: kubekey network: plugin: calico kubePodsCIDR: 10.233 .64 .0 /18 kubeServiceCIDR: 10.233 .0 .0 /18 ## multus support. https://github.com/k8snetworkplumbingwg/multus-cni multusCNI: enabled: false storage: openebs: basePath: /data/openebs/local # 默认没有的新增配置，base path of the local PV provisioner registry: auths: "dockerhub.kubekey.local": skipTLSVerify: true privateRegistry: "dockerhub.kubekey.local" # 如果构建离线包时 Kubernetes 镜像使用的是阿里云仓库镜像，需配置该参数，且不能改变名字。如果使用 dockerhub 镜像，则无需配置此参数。 namespaceOverride: "kubesphereio" registryMirrors: [] insecureRegistries: [] addons: []
4.4 配置 hosts 文件解析
在所有离线节点
配置 Registry 服务的域名解析，本文使用默认自定义域名
dockerhub.kubekey.local
。
echo "192.168.9.90 dockerhub.kubekey.local" >> /etc/hosts
5. 部署离线镜像仓库
小规模生产环境没必要使用 Harbor
，本文采用 Kubekey 部署
Docker Registry
作为镜像仓库。如果需要使用 Harbor，请参考
KubeSphere 离线安装文档
[4]
。
请注意，以下操作无特殊说明，均在离线环境
部署（Registry）节点
上执行。
5.1 安装 Docker Registry
❝
说明：如果您已有可用的镜像仓库，可跳过此步骤。
# openEuler 默认不安装 tar
执行以下命令安装镜像仓库
Docker Registry
：
./kk init registry -f config-sample.yaml -a kubesphere-v412-v1306-artifact.tar.gz
正确执行后，如果显示如下信息，则表明镜像仓库创建成功。
08:41:51 CST [InitRegistryModule] Fetch registry certs
建议，集群中的每个节点都执行，
确保使用了自定义域名及证书
。
$ ls /etc/docker/certs.d/dockerhub.kubekey.local/
5.2 推送离线镜像到镜像仓库
将提前准备好的离线镜像推送到镜像仓库。这一步为
可选项
，因为创建集群时默认会推送镜像（本文使用参数忽略了）。为了提高部署成功率，建议先推送。
./kk artifact image push -f config-sample.yaml -a kubesphere-v412-v1306-artifact.tar.gz
正确执行后，如果显示如下信息，则表明镜像推送成功。
......# 方案一： 找个 Docker 环境，拉取镜像 # 方案二：在 Registry 节点查看目录
❝
说明：如果你的实战环境跟我文档中的一致，你会发现一个问题。目前阶段没有 Docker 环境能执行方案一，只能采用方案二。
6. 部署 K8s 集群
请注意，以下操作无特殊说明，均在离线环境
部署（Registry）节点
上执行。
6.1 离线部署 K8s 集群
执行以下命令，部署 K8s 集群。
cd /srv/kubekey
❝
参数说明
--with-packages
：安装操作系统依赖
--skip-push-images：
忽略推送镜像，前面已经完成了推送镜像到私有仓库的任务
**--with-local-storage：**使用 openEBS 作为 local 存储卷
部署完成后，您应该会在终端上看到类似于下面的输出：
......command :
6.2 kubectl 命令行验证集群状态
在
control-1
节点运行
kubectl
命令获取 K8s 集群资源信息。
kubectl get nodes -o wide
在输出结果中可以看到，当前的 K8s 集群有 3 个节点，并详细展示每个节点的名字、状态、角色、存活时间、K8s 版本号、内部 IP、操作系统类型、内核版本和容器运行时等信息。
$ kubectl get nodes -o wide openEuler 24.03 (LTS) 6.6.0-28.0.0.34.oe2403.x86_64 containerd://1.7.13 openEuler 24.03 (LTS) 6.6.0-28.0.0.34.oe2403.x86_64 containerd://1.7.13 openEuler 24.03 (LTS) 6.6.0-28.0.0.34.oe2403.x86_64 containerd://1.7.13
输入以下命令，获取在 K8s 集群上运行的 Pod 列表，确保所有的容器状态都是
Running
。
$ kubectl get pods -o wide -A
至此，我们部署完成了一套 Control-plane 和 Worker 复用，3 节点的 K8s 集群。
7. 安装 KubeSphere
7.1 前提条件
将 ks-core-1.1.3.tgz 传到 Control 节点
7.2 安装 KubeSphere
helm upgrade --install -n kubesphere-system --create-namespace ks-core ks-core-1.1.3.tgz \set global.imageRegistry=dockerhub.kubekey.local/ks \set extension.imageRegistry=dockerhub.kubekey.local/ks \set ksExtensionRepository.image.tag=v1.1.2 \set ha.enabled=true \set redisHA.enabled=true \set hostClusterName=opsxlabs-main \wait
❝
说明：
ksExtensionRepository.image.tag
为之前获取到的 Extensions Museum 版本（即 https://get-images.kubesphere.io/ 上展示的最新扩展组件仓库版本）。
设置 ha.enabled 和 redisHA.enabled，启用高可用部署 KubeSphere
hostClusterName： 修改主集群的名字，默认为 host
两个 imageRegistry：修改组件镜像仓库地址
部署过程需要大约 5 分钟，具体看网速和机器配置（
redisha-server 创建过程比较耗时
）。
安装命令执行完成后，如果显示如下信息，则表明
KubeSphere Core
安装成功，输出信息会显示 KubeSphere Web 控制台的 IP 地址、管理员用户名和管理员密码。
NOTES: Thank you for choosing KubeSphere Helm Chart. Please be patient and wait for several seconds for the KubeSphere deployment to complete. 1 . Wait for Deployment Completion Confirm that all KubeSphere components are running by executing the following command: kubectl get pods -n kubesphere-system 2 . Access the KubeSphere Console Once the deployment is complete, you can access the KubeSphere console using the following URL: http://192.168.9.91:30880 3 . Login to KubeSphere Console Use the following credentials to log in: Account: admin Password: P@88w0rd NOTE: It is highly recommended to change the default password immediately after the first login. For additional information and details, please visit https://kubesphere.io.
7.3 命令行验证 KubeSphere Core 状态
kubectl get pods -n kubesphere-system
正确执行后，输出结果如下 :
$ kubectl get pods -n kubesphere-system
7.4 图形化查看集群状态
我们打开浏览器，访问
Control-1
节点的 IP 地址和端口
30880
，打开 KubeSphere 管理控制台，查看「集群节点」。
8. 安装扩展组件
本文以最常用的监控（WhizardTelemetry）组件为例，演示离线安装扩展组件的功能是否正常。
KubeSphere v4 将原有的监控功能拆解成了 8 个 新版的监控组件并新增了 2 个额外的组件。
ksp-extensions-marketplace-observability-v412
8.1 安装 WhizardTelemetry 平台服务组件
版本选择：
选择扩展组件版本。
扩展组件安装：
在「扩展组件配置」页，无需修改
imageRegistry
为 离线镜像仓库地址。
点击「开始安装」，
安装过程可视化
，安装完成后
显示成功
的图标。
8.2 安装 WhizardTelemetry 监控组件
版本选择：
选择推荐的最新版，必装组件检测也发现了「WhizardTelemetry 平台服务」组件。
扩展组件安装：
在扩展组件配置页，修改
imageRegistry
为 KubeSphere 官方提供的华为云镜像仓库地址。
