mcfly722/kubernetes-overlay-threshold

kubernetes-overlay-threshold

镜像概述和主要用途

kubernetes-overlay-threshold是一个用于Kubernetes集群的监控工具镜像，主要功能是为pod提供Docker overlay2存储驱动的磁盘使用阈值监控。通过检查容器特定目录的磁盘占用情况，实现对pod磁盘膨胀的自动检测与处理，保障集群资源稳定。

核心功能和特性

• 目录检查：实时监控每个容器的/var/lib/docker/overlay2/<mountContainerId>/diff目录
• 阈值监控：可配置磁盘使用量阈值（MB为单位）
• 自动重启：当检测到容器目录大小超过设定阈值时，自动重启对应pod
• 事件通知：向Kubernetes集群发送事件，记录pod重启原因和相关信息

使用场景和适用范围

• Kubernetes集群中需要监控容器磁盘使用情况的场景
• 防止因容器日志、临时文件等导致磁盘空间过度占用的场景
• 需要自动化处理pod磁盘膨胀问题的生产环境
• 使用Docker overlay2存储驱动的Kubernetes集群

使用方法和配置说明

部署方式

通常以DaemonSet形式部署在Kubernetes集群的每个节点上，确保对所有节点的容器进行监控。

配置参数

Docker run示例

bash
docker run -d \
  --name k8s-overlay-threshold \
  -e THRESHOLD_MB=2048 \
  -e CHECK_INTERVAL=30 \
  -v /var/lib/docker/overlay2:/var/lib/docker/overlay2 \
  -v /var/run/kubernetes/client-certificate.pem:/var/run/kubernetes/client-certificate.pem \
  -v /var/run/kubernetes/client-key.pem:/var/run/kubernetes/client-key.pem \
  kubernetes-overlay-threshold

Kubernetes DaemonSet部署示例

yaml
apiVersion: apps/v1
kind: DaemonSet
metadata:
  name: overlay-threshold-monitor
  namespace: kube-system
spec:
  selector:
    matchLabels:
      name: overlay-threshold-monitor
  template:
    metadata:
      labels:
        name: overlay-threshold-monitor
    spec:
      containers:
      - name: overlay-threshold-monitor
        image: kubernetes-overlay-threshold
        env:
        - name: THRESHOLD_MB
          value: "1024"
        - name: CHECK_INTERVAL
          value: "60"
        volumeMounts:
        - name: docker-overlay
          mountPath: /var/lib/docker/overlay2
          readOnly: true
        - name: k8s-certs
          mountPath: /var/run/kubernetes
          readOnly: true
      volumes:
      - name: docker-overlay
        hostPath:
          path: /var/lib/docker/overlay2
      - name: k8s-certs
        hostPath:
          path: /var/run/kubernetes

注意事项

• 需确保容器具有访问Docker overlay2目录和Kubernetes API的权限
• 根据集群实际情况调整阈值参数，避免误触发或未及时处理
• 建议在非生产环境先进行测试，验证阈值设置的合理性