readystack/kubernetes

ReadyStack Kubernetes 镜像文档

快速开始

bash
docker run -d \
  --name kubernetes \
  --privileged \
  -p 6443:6443 \
  -p 10250:10250 \
  -v k8s-data:/data \
  readystack/kubernetes:v1.35.1-CE-ubuntu24.04-r1

等待2-4分钟让控制平面初始化，然后：

bash
# 复制kubeconfig
docker cp kubernetes:/etc/kubernetes/admin.conf ./kubeconfig
kubectl --kubeconfig=./kubeconfig get nodes

镜像概述和主要用途

这是一个生产就绪的单节点Kubernetes集群，打包为Docker容器。非常适合：

• 开发环境
• CI/CD管道
• Kubernetes学习
• 边缘部署

核心功能和特性

• 完整的单节点Kubernetes集群，包含控制平面组件
• 内置containerd容器运行时
• 自动初始化和配置，无需手动设置
• 持久化存储支持，通过挂载卷保存集群状态
• 健康检查机制，验证关键组件运行状态
• 完整的Kubernetes API支持，兼容标准kubectl命令

API端点

运行后，Kubernetes API可通过以下地址访问：

https://localhost:6443

健康检查端点（无需认证）

核心API端点（需认证）

完整API文档：参见 https://github.com/readystack/kubernetes/blob/main/docs/API_INTEGRATION_GUIDE.md

环境变量

端口

首次启动行为

首次启动时，容器会：

1. 启动containerd（容器运行时）
2. 运行kubeadm init引导集群
3. 生成admin.conf kubeconfig
4. 等待控制平面就绪

此过程需要2-4分钟。可通过以下命令检查进度：

bash
docker logs -f kubernetes

健康检查

容器包含健康检查，验证：

• containerd是否运行
• kubelet是否响应
• API服务器是否可访问（就绪后）

可通过以下命令获取健康状态：

bash
docker inspect --format="{{.State.Health.Status}}" kubernetes

卷

重要：挂载持久卷到/data以在重启之间保留集群状态。

认证

Kubernetes API需要认证。支持以下方法：

Kubeconfig（推荐）

bash
docker cp kubernetes:/etc/kubernetes/admin.conf ./kubeconfig
kubectl --kubeconfig=./kubeconfig get nodes

Bearer令牌

bash
export TOKEN=$(kubectl --kubeconfig=./kubeconfig create token default)
curl -k -H "Authorization: Bearer $TOKEN" https://localhost:6443/api/v1/nodes

客户端证书

bash
curl -k --cert /etc/kubernetes/pki/apiserver-kubelet-client.crt \
     --key /etc/kubernetes/pki/apiserver-kubelet-client.key \
     https://localhost:6443/api/v1/nodes

已知限制

需要特权模式

此镜像需要--privileged标志运行，因为containerd需要cgroup访问权限。这是Kubernetes-in-Docker部署的架构要求。

注意：所有API均通过静态验证。由于特权容器要求，构建验证期间的运行时测试被阻止（DEF-001）。在适当的基础设施上部署时，API功能正常。

许可证

Apache-2.0 — 参见 https://github.com/kubernetes/kubernetes/blob/master/LICENSE

支持

• 文档：[***]
• 问题：[***]
• 源码：https://github.com/kubernetes/kubernetes

使用ReadyStack构建 — 具有完整来源的确定性容器构建