portainer/k2d

K2D 镜像技术文档

1. 镜像概述和主要用途

K2D（Kubernetes to Docker translator）是一款 Kubernetes 原语转换器，旨在解决资源受限计算设备（尤其是工业物联网场景下的设备）中使用 Kubernetes 原语的问题。它并非完整的 Kubernetes 集群，而是一个 Kubernetes 模拟器/转换器，允许用户在设备上运行 Docker 容器的同时，以管理单节点 Kubernetes 集群的方式管理这些容器，实现“无 Kubernetes 的 Kubernetes 体验”。

2. 核心功能和特性

• Kubernetes 原语支持：兼容 Kubernetes 核心原语（如 Deployment、Service 等），可直接使用 Kubernetes 配置文件进行容器管理。
• Docker 原生集成：通过 Docker 引擎运行和管理容器，无需部署完整 Kubernetes 组件（如 kubelet、etcd 等），降低资源占用。
• 单节点集群模拟：将设备模拟为单节点 Kubernetes 集群，简化边缘设备上的容器编排与管理。
• 多架构支持：适配多种硬件架构，包括 linux/amd64、linux/arm64、linux/386、linux/armv6 和 linux/armv7。

3. 使用场景和适用范围

适用场景

• 工业物联网（IIoT）设备：资源受限的工业传感器、边缘网关等设备，需轻量化管理容器应用。
• 边缘计算节点：边缘环境中资源有限的计算设备，需简化容器编排流程。
• 资源受限环境：无法部署完整 Kubernetes 集群，但需要使用 Kubernetes 原语进行容器管理的场景。

4. 使用方法和配置说明

4.1 部署要求

• 运行环境：支持 Docker 的 Linux 系统。
• 硬件架构：linux/amd64、linux/arm64、linux/386、linux/armv6 或 linux/armv7。

4.2 部署步骤（Docker Run）

通过以下命令部署 K2D 容器：

bash
docker run -d \
  --name k2d-k2d \
  --network host \
  --restart always \
  --env K2D_ADVERTISE_ADDR=YOUR_HOST_IP \
  --env K2D_SECRET=YOUR_OWN_SECRET \
  --label resource.k2d.io/namespace-name=k2d \
  --label workload.k2d.io/name=k2d \
  --volume /var/run/docker.sock:/var/run/docker.sock \
  --volume /var/lib/k2d:/var/lib/k2d \
  portainer/k2d:1.0.0

5. 配置参数详解

5.1 环境变量

5.2 卷挂载

5.3 其他配置

• 网络模式：--network host，使用主机网络以避免端口映射复杂配置，确保 K2D 服务直接暴露在主机网络中。
• 重启策略：--restart always，确保 K2D 容器在意外退出后自动重启，提高服务稳定性。
• 标签：resource.k2d.io/namespace-name=k2d 和 workload.k2d.io/name=k2d，用于 K2D 自身的命名空间和工作负载标识。

6. 参考资料

更多部署和使用细节，请参考官方文档：docs.k2d.io