enix/kube-image-keeper

kuik Docker镜像文档

1. 镜像概述

kuik是一款专为Kubernetes集群设计的容器镜像缓存系统，旨在解决集群环境中频繁拉取容器镜像导致的网络带宽占用过高、部署延迟等问题。通过在集群节点本地缓存常用镜像，kuik可显著减少重复镜像拉取操作，降低对外部镜像仓库的依赖，提升应用部署和扩缩容的响应速度。

2. 核心功能与特性

• 自动镜像缓存：监控Kubernetes集群中的镜像拉取请求，自动缓存首次拉取的镜像，后续相同镜像请求直接从本地缓存获取。
• 减少网络传输：通过本地缓存机制，降低对外部网络带宽的占用，尤其适用于网络带宽有限或镜像仓库位于公网的场景。
• 提升部署效率：缩短镜像拉取时间，加速Pod启动过程，改善集群应用部署和扩缩容的整体效率。
• Kubernetes原生集成：与Kubernetes容器运行时（如containerd、CRI-O）无缝集成，无需修改应用部署配置即可启用缓存功能。
• 缓存策略管理：支持基于镜像标签、仓库地址等维度的缓存策略配置，可自定义缓存清理规则（如LRU淘汰机制）。

3. 使用场景与适用范围

• 大型Kubernetes集群：节点数量多、镜像拉取频率高的集群环境，可通过kuik减少跨节点重复镜像传输。
• 频繁部署场景：CI/CD流水线自动化部署、开发测试环境频繁迭代等场景，减少重复镜像拉取耗时。
• 网络受限环境：外部网络带宽有限或镜像仓库访问延迟较高的场景，通过本地缓存提升稳定性。
• 生产环境优化：对应用部署速度和可用性有较高要求的生产环境，降低因镜像拉取失败导致的部署故障风险。

4. 使用方法与配置说明

4.1 部署方式

kuik通常以DaemonSet形式部署在Kubernetes集群的每个节点上，确保每个节点均具备本地缓存能力。

4.1.1 基本部署（kubectl）

通过以下YAML配置部署kuik DaemonSet：

yaml
apiVersion: apps/v1
kind: DaemonSet
metadata:
  name: kuik
  namespace: kube-system
spec:
  selector:
    matchLabels:
      app: kuik
  template:
    metadata:
      labels:
        app: kuik
    spec:
      containers:
      - name: kuik
        image: kuik:latest  # 替换为实际kuik镜像标签
        ports:
        - containerPort: 8080  # 缓存服务端口
        volumeMounts:
        - name: cache-volume
          mountPath: /var/lib/kuik/cache  # 镜像缓存存储路径
        - name: containerd-socket
          mountPath: /run/containerd/containerd.sock  # 容器运行时socket（根据实际运行时调整）
        env:
        - name: KUIK_CACHE_SIZE
          value: "50Gi"  # 缓存最大容量限制
        - name: KUIK_NAMESPACE
          value: "kube-system"  # 部署命名空间
      volumes:
      - name: cache-volume
        hostPath:
          path: /var/lib/kuik/cache  # 宿主机缓存目录
          type: DirectoryOrCreate
      - name: containerd-socket
        hostPath:
          path: /run/containerd/containerd.sock
          type: Socket

执行部署命令：

bash
kubectl apply -f kuik-daemonset.yaml

4.2 配置参数

kuik支持通过环境变量或配置文件进行参数配置，常用参数如下：

4.3 验证部署

部署完成后，可通过以下方式验证kuik是否正常运行：

1. 检查DaemonSet状态：

bash
kubectl get daemonset kuik -n kube-system

2. 查看节点日志确认缓存功能：

bash
kubectl logs -n kube-system -l app=kuik

3. 在集群中部署测试Pod，观察kuik日志是否记录镜像缓存命中信息。

5. 注意事项

• 需确保宿主机缓存目录（/var/lib/kuik/cache）有足够的存储空间，容量配置建议根据节点实际磁盘大小和镜像使用情况调整。
• 与容器运行时的集成需根据集群实际使用的运行时（containerd/CRI-O）调整socket路径。
• 在多节点集群中，每个节点独立维护本地缓存，跨节点镜像拉取不会共享缓存（需结合分布式缓存方案可进一步优化）。