yansenchangyu/node-feature-discovery

node-feature-discovery:v0.12.1 镜像文档

镜像概述

node-feature-discovery（NFD）是Kubernetes生态系统中的核心工具，用于自动发现集群节点的硬件和软件特性，并将这些信息以标签或注解形式添加到节点对象。v0.12.1版本提供稳定的特性识别能力，帮助Kubernetes调度器基于节点实际特性进行精准的工作负载调度。

核心功能与特性

• 多维度特性发现：支持硬件特性（CPU、GPU、内存、存储、网络设备）、软件特性（内核版本、操作系统、已安装组件）及自定义规则发现
• Kubernetes原生集成：自动将发现的特性转换为节点标签或注解，无缝对接Kubernetes调度系统
• 高度可配置：通过配置文件定义自定义特性发现规则，满足特定业务场景需求
• 轻量级部署：以DaemonSet形式在集群各节点运行，资源占用低，对节点性能影响小
• 版本兼容性：兼容Kubernetes 1.21及以上版本，适配主流K8s发行版

使用场景与适用范围

• 部署需要特定硬件资源（如GPU加速、SR-IOV网络、NVMe存储）的应用
• 实现基于节点软件特性（特定内核模块、运行时环境、库版本）的工作负载调度
• 集群资源优化与管理，确保工作负载部署在具备所需特性的节点上
• 自动化节点特性标签管理，减少人工配置成本和错误率

使用方法与配置说明

典型部署方式

NFD通常以DaemonSet形式部署在Kubernetes集群中，确保每个节点都运行特性发现组件。

DaemonSet部署示例

yaml
apiVersion: apps/v1
kind: DaemonSet
metadata:
  name: nfd-worker
  namespace: node-feature-discovery
spec:
  selector:
    matchLabels:
      app: nfd-worker
  template:
    metadata:
      labels:
        app: nfd-worker
    spec:
      containers:
      - name: nfd-worker
        image: registry.k8s.io/nfd/node-feature-discovery:v0.12.1
        command: ["nfd-worker"]
        args: ["--sleep-interval=60s"]
        volumeMounts:
        - name: host-sys
          mountPath: /sys
        - name: host-dev
          mountPath: /dev
        - name: host-etc
          mountPath: /host-etc
          readOnly: true
        - name: nfd-config
          mountPath: /etc/kubernetes/node-feature-discovery
      volumes:
      - name: host-sys
        hostPath: {path: /sys}
      - name: host-dev
        hostPath: {path: /dev}
      - name: host-etc
        hostPath: {path: /etc}
      - name: nfd-config
        configMap: {name: nfd-config}

核心配置参数

NFD-worker支持以下关键命令行参数：

• --no-publish：仅执行特性发现不更新节点标签（调试用）
• --config：指定配置文件路径（默认：/etc/kubernetes/node-feature-discovery/config.yaml）
• --sleep-interval：特性重新发现间隔时间（默认：60秒）
• --sources：指定启用的发现源（如"cpu,memory,gpu,pci,usb,network"）

环境变量配置

• NFD_WORKER_EXTRA_ARGS：传递额外命令行参数给nfd-worker进程
• NODE_NAME：节点名称（通常通过Downward API自动注入）

自定义特性配置示例

yaml
# /etc/kubernetes/node-feature-discovery/config.yaml
sources:
  cpu:
    enabled: true
  memory:
    enabled: true
  gpu:
    enabled: true
  pci:
    enabled: true
    deviceClassWhitelist:
      - "0300"  # VGA兼容控制器（GPU）
      - "0200"  # 以太网控制器
  custom:
    - name: "high-performance"
      matchOn:
        - kernel.version: ">=5.10.0"
        - cpu.model: ["Intel(R) Xeon(R) Gold 6248"]

注意事项

• 确保节点允许挂载主机的/sys、/dev和/etc目录，通常需要特权访问
• 部分硬件特性（如GPU）需要预先安装相应驱动才能被正确识别
• 自定义规则需遵循NFD配置规范，避免语法错误导致特性发现失败
• 生产环境建议设置适当的资源限制，避免影响节点正常运行