NPU Feature Discovery

特性介绍

NPU Feature Discovery是集群中NPU相关的特征发现组件，用于发现NPU设备类型并在节点上打上相应的标签，以便NPU Operator相关组件的安装部署与使用。

本地构建

镜像构建

构建参数

• GOPRIVATE：配置Go语言私有仓库，等同于GOPRIVATE环境变量。
• COMMIT：当前git commit的哈希值。
• VERSION：组件版本。
• SOURCE_DATE_EPOCH：镜像rootfs的时间戳。

构建命令

• 构建并推送到指定OCI仓库。

  使用docker

  docker buildx build . -f <path/to/dockerfile> \
      -o type=image,name=<oci/repository>:<tag>,oci-mediatypes=true,rewrite-timestamp=true,push=true \
      --platform=linux/amd64,linux/arm64 \
      --provenance=false \
      --build-arg=GOPRIVATE=gopkg.openfuyao.cn \
      --build-arg=COMMIT=$(git rev-parse HEAD) \
      --build-arg=VERSION=0.0.0-latest \
      --build-arg=SOURCE_DATE_EPOCH=$(git log -1 --pretty=%ct)
  

  使用nerdctl

  nerdctl build . -f <path/to/dockerfile> \
      -o type=image,name=<oci/repository>:<tag>,oci-mediatypes=true,rewrite-timestamp=true,push=true \
      --platform=linux/amd64,linux/arm64 \
      --provenance=false \
      --build-arg=GOPRIVATE=gopkg.openfuyao.cn \
      --build-arg=COMMIT=$(git rev-parse HEAD) \
      --build-arg=VERSION=0.0.0-latest \
      --build-arg=SOURCE_DATE_EPOCH=$(git log -1 --pretty=%ct)
  

  其中，<path/to/dockerfile>为Dockerfile路径，<oci/repository>为镜像地址，<tag>为镜像tag。

• 构建并导出OCI Layout到本地tarball。

  使用docker

  docker buildx build . -f <path/to/dockerfile> \
      -o type=oci,name=<oci/repository>:<tag>,dest=<path/to/oci-layout.tar>,rewrite-timestamp=true \
      --platform=linux/amd64,linux/arm64 \
      --provenance=false \
      --build-arg=GOPRIVATE=gopkg.openfuyao.cn \
      --build-arg=COMMIT=$(git rev-parse HEAD) \
      --build-arg=VERSION=0.0.0-latest \
      --build-arg=SOURCE_DATE_EPOCH=$(git log -1 --pretty=%ct)
  

  使用nerdctl

  nerdctl build . -f <path/to/dockerfile> \
      -o type=oci,name=<oci/repository>:<tag>,dest=<path/to/oci-layout.tar>,rewrite-timestamp=true \
      --platform=linux/amd64,linux/arm64 \
      --provenance=false \
      --build-arg=GOPRIVATE=gopkg.openfuyao.cn \
      --build-arg=COMMIT=$(git rev-parse HEAD) \
      --build-arg=VERSION=0.0.0-latest \
      --build-arg=SOURCE_DATE_EPOCH=$(git log -1 --pretty=%ct)
  

  其中，<path/to/dockerfile>为Dockerfile路径，<oci/repository>为镜像地址，<tag>为镜像tag，path/to/oci-layout.tar为tar包路径。

• 构建并导出镜像rootfs到本地目录。

  使用docker

  docker buildx build . -f <path/to/dockerfile> \
      -o type=local,dest=<path/to/output>,platform-split=true \
      --platform=linux/amd64,linux/arm64 \
      --provenance=false \
      --build-arg=GOPRIVATE=gopkg.openfuyao.cn \
      --build-arg=COMMIT=$(git rev-parse HEAD) \
      --build-arg=VERSION=0.0.0-latest
  

  使用nerdctl

  nerdctl build . -f <path/to/dockerfile> \
      -o type=local,dest=<path/to/output>,platform-split=true \
      --platform=linux/amd64,linux/arm64 \
      --provenance=false \
      --build-arg=GOPRIVATE=gopkg.openfuyao.cn \
      --build-arg=COMMIT=$(git rev-parse HEAD) \
      --build-arg=VERSION=0.0.0-latest
  

  其中，<path/to/dockerfile>为Dockerfile路径，path/to/output为本地目录路径。

Helm Chart构建

• 打包Helm Chart。

  helm package <path/to/chart> -u \
      --version=0.0.0-latest \
      --app-version=openFuyao-v25.09
  

  其中，<path/to/chart>为Chart文件夹路径。

• 推送Chart包到指定OCI仓库。

  helm push <path/to/chart.tgz> oci://<oci/repository>:<tag>
  

  其中，<path/to/chart.tgz>为Chart包路径，<oci/repository>为Chart包推送地址，<tag>为Chart包tag。

安装部署

该组件为openFuyao NPU Operator特性的前置依赖，也可进行独立安装，部署方式可参考NPU Operator用户指南。