当前位置：首页 > news >正文

kubesphere-v4.1.2离线安装

news 2026/8/15 20:43:06

kubesphere-v4.1.2离线安装

网上已经有很多安装部署kubesphere的安装部署教程了，我这主要是提供一套安装包，离线安装包链接我放到文章末尾了,安装包比较大。自己做的离线安装包，亲测有效。

1. 操作系统

操作系统：ubuntu22.04 、centos7.8、centos7.9

2.下载部署资料

需要的文件如下，上传到服务器：
" config-sample.yaml"
" create_project_harbor.sh"
" helm-v3.15.0-linux-amd64.tar.gz"
" kk"
" ks-core-1.1.3.tgz"
" kubesphere-v412-v1306-artifact.tar.gz"

3.根据实际情况修改配置文件

config-sample.yaml是安装配置文件，需要根据实际情况修改：

特别注意：etcd节点与registry节点不能是同一个节点，否则会报错 apiVersion: kubekey.kubesphere.io/v1alpha2 kind: Cluster metadata: name: sample spec: hosts: - {name: registry, address: 192.168.15.122, internalAddress: 192.168.15.122, user: root, password: "xxx"} - {name: master, address: 192.168.15.127, internalAddress: 192.168.15.127, user: root, password: "xxx"} - {name: node2, address: 192.168.15.137, internalAddress: 192.168.15.137, user: root, password: "xxx"} roleGroups: etcd: - master control-plane: - master worker: - node2 registry: - registry controlPlaneEndpoint: ## Internal loadbalancer for apiservers # internalLoadbalancer: haproxy domain: lb.kubesphere.local address: "" port: 6443 kubernetes: version: v1.26.12 containerManager: containerd #containerManager: docker #选择容器类型 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 registry: # 如需使用 kk 部署 harbor, 可将该参数设置为 harbor，不设置该参数且需使用 kk 创建容器镜像仓库，将默认使用 docker registry。 type: harbor # 如使用 kk 部署的 harbor 或其他需要登录的仓库，需设置对应仓库的 auths，如使用 kk 创建默认的 docker registry 仓库，则无需配置 auths 参数。 auths: "dockerhub.kubekey.local": username: admin password: Harbor12345 skipTLSVerify: true privateRegistry: "dockerhub.kubekey.local" namespaceOverride: "kubesphereio" registryMirrors: [] insecureRegistries: [] addons: []

修改host
- 要安装的机器列表配置在这里
修改group
- group中分了etcd、control panel、worker、registry等，根据实际情况修改
配置registry
- 要安装harbor的话，需要配置集群内部域名指向harbor，还有账号密码也需要配置

4.创建镜像仓库

需要registry节点上80端口未占用，然后执行如下命令

./kk init registry -f config-sample.yaml -a kubesphere-v412-v1306-artifact.tar.gz

如果显示如下信息，则表明镜像仓库创建成功。

Pipeline[InitRegistryPipeline] execute successfully

创建harbor项目

编辑create_project_harbor.sh，添加一个值kubesphereio

然后执行

./create_project_harbor.sh

5.安装Kubernetes

./kk create cluster -f config-sample.yaml -a kubesphere-v412-v1306-artifact.tar.gz --with-local-storage #安装的时候可能服务器会缺一些依赖，手动安装一下就OK了

1.指定 --with-local-storage 参数会默认部署 openebs localpv，如需对接其他存储，可在 Kubernetes 集群部署完成后自行安装。

2.如果显示如下信息，则表明 Kubernetes 集群创建成功。

Pipeline[CreateclusterPipeline] execute successfully
Installation is complete.

6.安装helm

tar -zxvf helm-v3.15.0-linux-amd64.tar.gz sudo mv linux-amd64/helm /usr/local/bin/helm

7. 安装KubeSphere

安装kubesphere需要在master节点操作。

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,redisHA.enabled=true \ --debug \ --wait ksExtensionRepository.image.tag 为之前获取到的 Extensions Museum 版本（即 https://get-images.kubesphere.io/ 上展示的最新扩展组件仓库版本）。 如需高可用部署 KubeSphere，可在命令中添加 --set ha.enabled=true,redisHA.enabled=true

如果显示如下信息，则表明 KubeSphere 安装成功：

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.6.6: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.

提示信息中包含了访问地址和账号、密码

如果安装后不小心关掉了ssh连接，可以使用如下命令查看：

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