coreweave/kube-lxcfs

lxcfs:3.1.2 镜像文档

镜像概述

本镜像为阿里云杭州仓库 registry.cn-hangzhou.aliyuncs.com/denverdino/lxcfs:3.1.2 的镜像，基于 LXCFS 3.1.2 版本构建。LXCFS 是一个轻量级的容器文件系统工具，主要用于解决容器内资源可见性问题，通过提供模拟的 /proc 文件系统（如 /proc/cpuinfo、/proc/meminfo 等），使容器内能够正确显示分配给容器的资源信息，而非宿主机的整体资源。

核心功能与特性

• 资源视图校正：通过挂载 LXCFS 文件系统，容器内可显示分配的 CPU、内存、磁盘等资源信息，而非宿主机资源。
• 轻量级实现：基于 LXCFS 3.1.2 稳定版本，体积小、性能开销低，适合各类容器环境。
• 兼容性良好：支持 Docker、Kubernetes 等主流容器运行时和编排平台。
• 标准文件系统接口：提供与原生 /proc 兼容的文件接口，应用无需修改即可适配。

使用场景与适用范围

• 容器监控场景：需在容器内准确获取资源使用情况的监控工具（如 Prometheus、Grafana 等）。
• 资源敏感型应用：应用需根据分配的资源动态调整行为（如 JVM 内存配置、进程调度策略等）。
• 开发与测试环境：模拟生产环境资源限制，确保应用在资源约束下的正确性。
• 多租户容器环境：需向租户展示其容器实际分配资源的场景。

使用方法与配置说明

基本使用（Docker 环境）

需以特权模式运行，并挂载宿主机的 LXCFS 目录至容器内。

bash
docker run --privileged \
  -v /var/lib/lxcfs:/var/lib/lxcfs:rbind \
  registry.cn-hangzhou.aliyuncs.com/denverdino/lxcfs:3.1.2

与应用容器配合使用

在启动应用容器时，通过 --volume 参数挂载 LXCFS 提供的资源文件系统：

bash
# 启动 LXCFS 容器
docker run -d --name lxcfs --privileged -v /var/lib/lxcfs:/var/lib/lxcfs:rbind registry.cn-hangzhou.aliyuncs.com/denverdino/lxcfs:3.1.2

# 启动应用容器并挂载 LXCFS 资源
docker run -it --rm \
  -v /var/lib/lxcfs/proc/cpuinfo:/proc/cpuinfo:ro \
  -v /var/lib/lxcfs/proc/diskstats:/proc/diskstats:ro \
  -v /var/lib/lxcfs/proc/meminfo:/proc/meminfo:ro \
  -v /var/lib/lxcfs/proc/stat:/proc/stat:ro \
  -v /var/lib/lxcfs/proc/swaps:/proc/swaps:ro \
  -v /var/lib/lxcfs/proc/uptime:/proc/uptime:ro \
  --memory=1G --cpus=0.5 \
  ubuntu:latest \
  bash

上述命令中，应用容器（ubuntu:latest）被限制为 1G 内存和 0.5 CPU 核心，通过挂载 LXCFS 提供的 /proc 文件，容器内执行 cat /proc/meminfo 等命令时将显示分配的资源信息。

Kubernetes 环境使用

在 Kubernetes 中，可通过 DaemonSet 部署 LXCFS，并在应用 Pod 中挂载相应卷：

yaml
# lxcfs-daemonset.yaml
apiVersion: apps/v1
kind: DaemonSet
metadata:
  name: lxcfs
  namespace: kube-system
spec:
  selector:
    matchLabels:
      name: lxcfs
  template:
    metadata:
      labels:
        name: lxcfs
    spec:
      hostPID: true
      containers:
      - name: lxcfs
        image: registry.cn-hangzhou.aliyuncs.com/denverdino/lxcfs:3.1.2
        imagePullPolicy: Always
        securityContext:
          privileged: true
        volumeMounts:
        - name: lxcfs
          mountPath: /var/lib/lxcfs
          mountPropagation: Bidirectional
      volumes:
      - name: lxcfs
        hostPath:
          path: /var/lib/lxcfs
          type: DirectoryOrCreate

部署后，在应用 Pod 的 volumeMounts 中添加：

yaml
volumeMounts:
- name: lxcfs-proc-cpuinfo
  mountPath: /proc/cpuinfo
  readOnly: true
# 其他需要挂载的 /proc 文件（meminfo、stat 等）类似
volumes:
- name: lxcfs-proc-cpuinfo
  hostPath:
    path: /var/lib/lxcfs/proc/cpuinfo

配置参数说明

注意事项

• 需确保宿主机已安装 fuse 依赖（LXCFS 依赖 FUSE 机制）。
• 挂载 /proc 文件时需设置为只读（ro），避免容器修改宿主机资源信息。
• 在 Kubernetes 环境中，需确保节点支持 mountPropagation: Bidirectional（通常需要容器运行时支持）。