liuhougangxa/kubespray

镜像概述和主要用途

liuhougangxa/kubespray:2.8.2是一个基于Kubespray工具的Docker镜像，旨在简化Kubernetes（K8s）集群的部署与卸载过程。通过容器化方式封装部署逻辑，用户无需在本地安装复杂依赖，只需通过简单的Docker命令即可完成K8s集群的搭建和清理，降低了K8s部署的技术门槛。

核心功能和特性

• 容器化部署流程：将Kubespray部署逻辑封装在Docker镜像中，避免本地环境依赖冲突
• 便捷的配置管理：支持通过主机清单文件（hosts.ini）自定义集群节点角色（如master、node、etcd）
• 完整的生命周期管理：提供一键安装和卸载K8s集群的命令，简化集群维护
• 灵活的节点配置：支持多节点集群部署，可通过配置文件定义master节点、node节点和etcd节点

使用场景和适用范围

• 快速搭建K8s开发或测试环境
• 小型K8s集群的部署与管理
• 需要统一部署流程的多节点K8s环境
• 对部署过程有标准化需求的场景

使用方法和配置说明

环境要求

• 网络访问：目标服务器需能访问互联网以拉取Docker镜像（离线环境需额外配置，详见https://github.com/kubernetes-sigs/kubespray/blob/master/docs/downloads.md#offline-environment%EF%BC%89
• 系统配置：目标服务器需启用IPv4转发
• SSH密钥：部署节点的SSH密钥需复制到所有目标服务器
• 防火墙：需自行管理防火墙规则，建议部署期间关闭防火墙以避免部署问题

步骤1：复制部署节点SSH密钥到所有目标服务器

生成SSH密钥（如已存在可跳过）并复制到所有目标服务器：

bash
# 生成SSH密钥（无密码）
ssh-keygen -b 4096 -f ~/.ssh/id_rsa -N ""

# 复制公钥到目标服务器（替换<user>和<node_ip_address>）
ssh-copy-id -i ~/.ssh/id_rsa.pub <user>@<node_ip_address>

步骤2：配置集群

1. 从镜像复制配置文件到本地：

bash
docker run -v $(pwd):/data liuhougangxa/kubespray:2.8.2 cp -r /cluster /data

2. 复制SSH密钥到配置目录：

bash
cp ~/.ssh/id_rsa cluster/ssh_key

3. 编辑主机清单文件cluster/hosts.ini，定义集群节点及角色。示例配置：

ini
[all]
node1 ansible_host=172.16.26.134  # 节点1 IP
node2 ansible_host=172.16.26.155  # 节点2 IP
node3 ansible_host=172.16.26.167  # 节点3 IP

[kube-master]
node1  # 定义master节点

[etcd]
node1  # 定义etcd节点（通常与master节点相同）

[kube-node]
node2  # 定义node节点1
node3  # 定义node节点2

[k8s-cluster:children]
kube-master  # 集群包含master节点
kube-node    # 集群包含node节点

步骤3：安装K8s集群

进入配置目录并执行安装命令：

bash
cd cluster/
docker run --net=host -t -v "$(pwd)":/cluster liuhougangxa/kubespray:2.8.2 install

卸载K8s集群

如需卸载集群，在配置目录执行：

bash
cd cluster/
docker run --net=host -t -v "$(pwd)":/cluster liuhougangxa/kubespray:2.8.2 uninstall