linchpiner/cgroup-memory-manager

镜像概述

该镜像提供的cgroup-memory-manager工具可定期扫描指定父cgroup下的子cgroup，通过分析memory.stat文件监控缓存使用情况，当缓存超过阈值时触发memory.force_empty强制回收页面，且支持冷却时间避免频繁操作，适用于Kubernetes环境下防止容器因缓存占用过高被OOM killer终止。

核心功能

1. 定期扫描父cgroup下的子cgroup内存缓存状态
2. 当缓存使用超过设定阈值时强制回收页面
3. 支持设置检查间隔和冷却时间，避免频繁操作
4. 通过环境变量RUST_LOG=info输出监控日志

使用场景

• Kubernetes节点上运行，防止容器因缓存+RSS超过内存限制被OOM killer杀死
• 作为系统服务或Kubernetes DaemonSet部署，持续监控cgroup内存状态

配置说明

工具支持以下命令行选项：

• --parent：父cgroup的路径（如Kubernetes环境下的/sys/fs/cgroup/memory/kubepods）
• --threshold：缓存使用阈值（支持百分比、字节等单位，如25%）
• --interval：检查缓存的频率（单位：秒）
• --cooldown：两次强制回收之间的最小等待时间（单位：秒）

部署示例

作为系统服务运行（Kubernetes节点）

创建systemd单元文件/etc/systemd/system/cgroup-memory-manager.service：

[Unit]
Description=cgroup-memory-manager
After=network.target

[Service]
Type=simple
ExecStart=/usr/local/bin/cgroup-memory-manager \
    --parent /sys/fs/cgroup/memory/kubepods \
    --threshold 25%
Restart=always

[Install]
WantedBy=multi-user.target

启用并启动服务：

bash
systemctl enable cgroup-memory-manager
systemctl start cgroup-memory-manager

作为Kubernetes DaemonSet部署

创建DaemonSet manifest文件cgroup-memory-manager-daemonset.yaml：

yaml
apiVersion: apps/v1
kind: DaemonSet
metadata:
  name: cgroup-memory-manager
  namespace: kube-system
spec:
  revisionHistoryLimit: 10
  selector:
    matchLabels:
      app: cgroup-memory-manager
  updateStrategy:
    type: RollingUpdate
    rollingUpdate:
      maxUnavailable: 100%
  template:
    metadata:
      labels:
        app: cgroup-memory-manager
    spec:
      containers:
        - name: cgroup-memory-manager
          image: linchpiner/cgroup-memory-manager
          imagePullPolicy: IfNotPresent
          command:
            - cgroup-memory-manager
            - --parent=/host/sys/fs/cgroup/memory/kubepods
            - --threshold=25%
          env:
            - name: RUST_LOG
              value: info
          resources:
            limits:
              cpu: 300m
              memory: 512Mi
          volumeMounts:
            - mountPath: /host/sys/fs/cgroup
              name: sysfs
      restartPolicy: Always
      volumes:
        - hostPath:
            path: /sys/fs/cgroup
            type: Directory
          name: sysfs

应用部署：

bash
kubectl apply -f cgroup-memory-manager-daemonset.yaml

注意事项

仅支持cgroup内存资源控制器v1版本，详情参考Linux内核文档。 在Kubernetes环境中，需将父cgroup路径设置为/sys/fs/cgroup/memory/kubepods以覆盖所有容器的cgroup层级。