guyrotem/kubernetes

镜像概述

本镜像基于kind的https://github.com/kubernetes-sigs/kind/tree/master/images/node%E6%9E%84%E5%BB%BA%EF%BC%8C%E5%8C%85%E5%90%AB%E5%90%AF%E5%8A%A8%E5%8D%95%E8%8A%82%E7%82%B9Kubernetes%E9%9B%86%E7%BE%A4%E6%89%80%E9%9C%80%E7%9A%84%E5%85%A8%E9%83%A8%E7%BB%84%E4%BB%B6%EF%BC%8C%E5%B9%B6%E9%A2%84%E5%8A%A0%E8%BD%BD%E4%BA%86%22busybox%22%E9%95%9C%E5%83%8F%E3%80%82%E4%B8%BB%E8%A6%81%E7%94%A8%E4%BA%8E%E5%9C%A8%E9%9A%94%E7%A6%BB%E7%8E%AF%E5%A2%83%E6%88%96%E6%97%A0%E6%B3%95%E4%BD%BF%E7%94%A8kind CLI的场景下，快速搭建Docker化的Kubernetes测试集群。

核心功能与特性

• 单节点集群部署：无需复杂配置，可直接启动独立的Kubernetes控制平面节点
• 预加载基础镜像：内置busybox镜像，开箱即可使用基础容器功能
• 独立运行能力：无需依赖kind命令行工具，适用于受限环境
• 完整K8s组件：包含Kubernetes控制平面所需的全部核心组件
• 可定制端口映射：支持将Kubernetes API服务器映射到主机指定端口

使用场景

• 隔离网络环境中的Kubernetes功能测试
• 无法安装或使用kind CLI的系统环境
• 快速搭建本地Kubernetes开发与测试环境
• 临时验证Kubernetes相关配置或应用部署
• 教学或演示环境中的Kubernetes快速部署

使用方法与配置说明

1. 启动集群容器

使用以下命令启动Kubernetes控制平面容器，需替换 ${NAME}（自定义集群名称）和 ${PORT}（主机端口，用于API服务器访问）：

bash
docker run --name=${NAME}-control-plane --hostname=${NAME}-control-plane --privileged --security-opt seccomp=unconfined --security-opt apparmor=unconfined --tmpfs /tmp --tmpfs /run -p 127.0.0.1:${PORT}:6443 --tty --label io.x-k8s.kind.role="control-plane" --label io.x-k8s.kind.cluster="${NAME}" --detach=true -t guyrotem/kubernetes:latest

2. 初始化集群组件

容器启动后，执行以下命令初始化Kubernetes集群和CNI网络：

bash
# 初始化Kubernetes控制平面
docker exec -it ${NAME}-control-plane init-kube.sh

# 创建CNI网络配置
docker exec -it ${NAME}-control-plane create-cni.sh

3. 复制kubeconfig配置文件

将容器内的Kubernetes配置文件复制到主机，以便使用kubectl管理集群。替换 ${NAME}、${PORT} 和 ${PATH_TO_KUBECONFIG_FILE}（主机保存路径）：

bash
docker exec -it ${NAME}-control-plane cat /etc/kubernetes/admin.conf | sed "s/172.17.0.2:6443/127.0.0.1:${PORT}/g" > ${PATH_TO_KUBECONFIG_FILE}

4. 使用kubectl操作集群

通过指定kubeconfig文件路径，使用kubectl管理集群：

bash
kubectl --kubeconfig=${PATH_TO_KUBECONFIG_FILE} <kubectl命令>

示例：查看所有命名空间的Pod状态

bash
kubectl --kubeconfig=/docs/kind.conf get pods --all-namespaces

5. 加载额外容器镜像

默认集群仅预加载busybox镜像。如需添加其他镜像，按以下步骤操作：

1. 将所需镜像保存为tar文件（例如：docker save -o image.tar my-image:tag）
2. 将tar文件复制到容器内（例如：docker cp image.tar ${NAME}-control-plane:/tmp/）
3. 在容器内执行以下命令导入镜像：

bash
ctr --namespace=k8s.io images import /tmp/image.tar