详解kubekey：Kubernetes集群安装工具

YPIVC • 2025-04-22 01:14 • 编程

一、kubekey简介

kubekey是一款用于快速搭建Kubernetes集群的工具。它支持多种云环境，提供了简单易用的命令行工具和离线安装包，可以满足不同场景下的 Kubernetes 部署需求。

相较于其他 Kubernetes 安装工具，kubekey 的优势在于：

1. 实现了硬件和操作系统配置（IP、SSH 等）的自动化，使得安装过程更加简单快速；

2. 支持多种云环境部署，如 AWS, Azure, OpenStack, HuaweiCloud 等，并且可以从各大云厂商镜像仓库自动化获取镜像；

3. 提供了详细的安装文档和命令说明，使得用户可以更好地理解和掌握 Kubernetes 集群的安装过程。

二、安装步骤

kubekey 的安装分为几个步骤。首先，需要下载安装 kubekey 工具；其次，需配置 inventory 文件和对应参数；最后，执行安装命令进行集群部署。

三、kubekey安装详解

1. 下载Kubekey工具

官方仓库提供了多种安装方式，如 yum、apt-get、brew 等。这里以 Linux 环境下的 apt-get 为例：

$ sudo apt-get update
$ sudo apt-get install kubekey

2. 配置Inventory文件

Inventory 文件是 kubekey 安装的一个重要参数文件，其中包含了集群的基本信息、各个节点的详细配置和扩展组件等。下面是一个 inventory 文件的示例：

all:
  vars:
    kube_network_plugin: calico
    kube_version: 1.16.9
    kube_image_repo: kubeimage
    registryconfig_path: /etc/docker
    arch: amd64
    os: ubuntu
    kube_proxy_mode: iptables
    container_manager: docker
    nodelocaldns_cluster_dns: "10.96.0.10"
    nodelocaldns_cluster_domain: "cluster.local"
  hosts:
    node1:
      ansible_host: 192.168.1.10
      internal_address: 192.168.1.10
    node2:
      ansible_host: 192.168.1.11
      internal_address: 192.168.1.11
    node3:
      ansible_host: 192.168.1.12
      internal_address: 192.168.1.12
  etcd:
    hosts:
      node1:
        ip: 192.168.1.10
      node2:
        ip: 192.168.1.11
      node3:
        ip: 192.168.1.12
  k8s_control_plane:
    hosts:
      node1:
        ip: 192.168.1.10
      node2:
        ip: 192.168.1.11
      node3:
        ip: 192.168.1.12
  k8s_worker:
    hosts:
      node1:
        ip: 192.168.1.10
      node2:
        ip: 192.168.1.11
        external_address: 172.16.1.10 # 外网IP
      node3:
        ip: 192.168.1.12

Inventory 文件是一个 YAML 格式的文本文件，包括 all、hosts、etcd、k8s_control_plane、k8s_worker 等几个区块。all 中定义了 cluster 的一些通用属性；hosts 定义了各个节点的 IP 和 ansible 主机名；etcd、k8s_control_plane、k8s_worker 则分别定义了 etcd、控制面和工作节点的信息。

3. 执行安装命令

在配置完 Inventory 文件后，就可以进行集群安装。安装指令如下：

$ kubekey install config.yaml

其中 config.yaml 是 Inventory 文件的路径。

四、小结

kubekey 是一款易用且功能强大的 Kubernetes 集群安装工具。其自动化配置、多云支持、文档详细等优点，都为 Kubernetes 的快速部署提供了优秀的解决方案。不过，kubekey 也存在一些限制，如不支持 Windows 系统、不支持其他容器管理工具等。针对不同场景和需求，使用不同的安装工具才是最合适的选择。

原创文章，作者：YPIVC，如若转载，请注明出处：https://www.506064.com/n/370439.html