KubeKey 是由 KubeSphere 社区开发的开源集群管理工具，用于一键安装、升级和管理 Kubernetes 集群及其依赖组件。它支持在多种操作系统上快速部署高可用或单节点 Kubernetes 集群，自动完成环境初始化、容器运行时安装、网络配置及系统依赖检测等任务。通过简单的配置文件，用户可自定义节点角色、Kubernetes 版本、网络插件和存储方案。KubeKey 还支持同时安装 KubeSphere 平台，实现从基础集群到应用管理的统一部署，是构建云原生基础设施的高效工具。

所有节点上安装kubekey所需的依赖：

apt install socat conntrack ebtables ipset ipvsadm

安装kubekey：

发布版本 · kubesphere/kubekey --- Releases · kubesphere/kubekey
官网下载，解压即可得到kubekey二进制可执行文件：

生成指定kubernetes版本的默认配置文件：

kk create config --with-kubernetes v1.31.12

修改配置文件，将hosts中的name、address、password等改为你自己的内容

按需配置roleGraoups中的节点名

apiVersion: kubekey.kubesphere.io/v1alpha2
kind: Cluster
metadata:
  name: sample
spec:
  hosts:
  - {name: master, address: 10.0.0.10, internalAddress: 10.0.0.10, user: root, password: "xxx"}
  - {name: node-1, address: 10.0.0.11, internalAddress: 10.0.0.11, user: root, password: "xxx"}
  - {name: node-2, address: 10.0.0.12, internalAddress: 10.0.0.12, user: root, password: "xxx"}
  roleGroups:
    etcd:
    - master
    control-plane: 
    - master
    worker:
    - node-1
    - node-2
  controlPlaneEndpoint:
    ## Internal loadbalancer for apiservers 
    # internalLoadbalancer: haproxy

    domain: lb.kubesphere.local
    address: ""
    port: 6443
  kubernetes:
    version: v1.31.12
    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
  registry:
    privateRegistry: ""
    namespaceOverride: ""
    registryMirrors: []
    insecureRegistries: []
  addons: []

执行创建集群：

kk create cluster -f config.yaml

输入yes执行安装

查看集群：