darumatic/kubespray

kubespray Docker镜像文档

镜像概述

该镜像包含运行kubespray所需的所有依赖，旨在简化Kubernetes集群的部署过程。用户无需在本地环境手动安装kubespray及其依赖，通过容器即可完成集群部署操作。

核心功能与特性

• 预安装kubespray运行所需的全部依赖组件
• 集成kubectl工具，支持集群部署后直接管理
• 支持通过挂载本地SSH密钥实现对目标VM的SSH访问
• 提供kubespray命令行工具，简化集群部署流程

使用场景

适用于需要快速部署Kubernetes集群的场景，尤其适合：

• 开发环境的Kubernetes集群快速搭建
• 测试环境的集群部署与验证
• 小型生产环境的Kubernetes集群初始化

使用方法

前提条件

• 本地环境已安装Docker
• 目标VM已配置SSH访问权限
• 本地SSH密钥（通常位于~/.ssh/目录）

步骤1：运行容器并挂载SSH密钥

bash
docker run -v ~/.ssh:/root/.ssh -it darumatic/kubespray:1.0

此命令会启动容器并将本地SSH密钥挂载到容器内的/root/.ssh/目录，使容器能够SSH访问目标VM。

步骤2：创建Ansible inventory文件

针对包含2台VM（1个主节点/1个工作节点）的集群，执行以下命令生成inventory配置（将xx.yy.zz.vv替换为实际服务器IP）：

bash
kubespray prepare --nodes k8-poc-node1[ansible_ssh_host=xx.yy.zz.vv] --masters k8-poc-master[ansible_ssh_host=xx.yy.zz.vv]

生成的inventory文件位于：/root/.kubespray/inventory/inventory.cfg，可通过以下命令查看：

bash
cat /root/.kubespray/inventory/inventory.cfg

步骤3：执行集群部署

bash
kubespray deploy

步骤4：访问集群

容器内已集成kubectl工具，可通过基础认证或证书方式连接到新部署的集群进行管理。

注意事项

• 防火墙设置：确保目标VM的防火墙已关闭，否则可能因集群组件间网络不通导致部署失败。具体所需开放端口可参考Kubernetes网络文档。
• SSH权限：当前用户必须拥有目标VM的SSH访问权限，以确保Ansible能够正常执行部署任务。

相关资源

• Dockerfile: https://github.com/darumatic/docker/blob/master/kubespray/Dockerfile
• kubespray官方文档: [***]