--- title: 单节点模式部署 description: "单节点模式是指在单个节点上部署KubeSphere，是针对刚接触KubeSphere并希望快速上手KubeSphere系统的用户而准备的，它能帮助您零配置快速部署KubeSphere和Kubernetes。" url: https://www.hikunpeng.com/document/detail/zh/kunpengcpfs/ecosystemEnable/KubeSphere/kunpengkubesphere_03_0010.html sourcePath: /source/zh/kunpengcpfs/ecosystemEnable/KubeSphere/kunpengkubesphere_03_0010.html indexId: ec43a196dbce77e85f1db6b1d61abdbef77e5650d82bdbc2dac33b39b682f53080 --- # 单节点模式部署 单节点模式是指在单个节点上部署KubeSphere，是针对刚接触KubeSphere并希望快速上手KubeSphere系统的用户而准备的，它能帮助您零配置快速部署KubeSphere和Kubernetes。 1. 安装依赖。 ``` yum install -y curl socat conntrack openssl ipset ipvsadm ``` 2. 下载安装工具KubeKey。 - 方式一：使用脚本获取KubeKey。 ``` cd /home curl -sfL https://get-kk.kubesphere.io | VERSION=v3.0.13 sh - ``` - 方式二：下载 KubeKey可执行文件的压缩包(https://kubernetes.pek3b.qingstor.com/kubekey/releases/download/v3.0.13/kubekey-v3.0.13-linux-arm64.tar.gz) 并上传到“/home”目录下，解压压缩包后可直接使用。 下载链接： 3. 预下载容器镜像包。 默认拉取的defaultbackend容器镜像不支持ARM架构，为了确保容器能够在ARM架构上正常运行，需要拉取支持ARM架构的容器镜像包到本地，并替换为默认的镜像tag。操作如下： ``` docker pull mirrorgooglecontainers/defaultbackend-arm64:1.4 docker tag mirrorgooglecontainers/defaultbackend-arm64:1.4 mirrorgooglecontainers/defaultbackend-amd64:1.4 ``` 如果在其他场景中遇到类似拉取的镜像不支持ARM架构的情况，都可以参考本步骤拉取支持ARM架构的容器镜像包到本地，并替换为默认的镜像tag，解决镜像的兼容性问题。 容器镜像tag修改命令参考如下： docker tag SOURCE_IMAGE:TAG1 TARGET_IMAGE:TAG2 SOURCE_IMAGE:TAG1为修改前tag，TARGET_IMAGE:TAG2为修改后tag。 如果您无法从dockerhub.io成功拉取镜像，强烈推荐您预先配置Docker镜像加速器，并尝试使用其他镜像源来下载所需版本的Docker镜像。更换镜像源的详细操作步骤请参见如何更换镜像源(https://www.hikunpeng.com/document/detail/zh/kunpengcpfs/ecosystemEnable/Kubernetes/kunpengk8s_04_0015.html)。 4. 同时安装Kubernetes和KubeSphere。 本文中以指定Kubernetes v1.23.10和KubeSphere v3.4.1版本为例进行说明。 ``` cd /home ./kk create cluster --with-kubernetes v1.23.10 --with-kubesphere v3.4.1 ``` “--with-kubernetes version”参数用于指定安装的Kubernetes（支持的Kubernetes版本请参见KubernetesVersions(https://github.com/kubesphere/kubekey/blob/master/README_zh-CN.md#KubernetesVersions)）。如果不添加“--with-kubernetes”或不指定“version”的版本号，则将默认安装v1.23.10版本。 “--with-kubesphere version”参数用于指定安装的KubeSphere版本。如果不添加“--with-kubesphere”则不安装KubeSphere，如果不指定“version”的版本号则默认安装最新版本的KubeSphere。 执行本步骤命令后，KubeKey将检查您的安装环境，结果显示为一张表格，并提示“Continue this installation? [yes/no]:”。请检查依赖项是否都满足，然后输入“yes”，再按回车继续。 安装过程中会联网下载相关组件包。 安装完成后输出信息中会显示Web控制台的IP地址和端口号，默认的端口号是“30880”。现在，您可以使用默认用户（admin）和密码（P@88w0rd）并通过:30880（本例中为“http://192.168.1.102:30880”）访问KubeSphere的Web控制台。