K8S NFS PVC PV 挂载点路径问题

最新推荐文章于 2025-11-13 17:42:51 发布
原创 最新推荐文章于 2025-11-13 17:42:51 发布 · 453 阅读 · 12 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#kubernetes #容器 #云原生

「“嵌”入未来，“式”界无限」主题征文大赛 10w+人浏览 475人参与

这里写自定义目录标题

您理解得很对！这确实是Kubernetes中PVC挂载的一个重要规则，让我详细解释一下：

PVC挂载的核心规则

  1. PVC作为独立存储单元：每个PVC都是一个完整的存储单元，有自己的根目录结构
  2. 根目录映射原则：
    • 当你指定mountPath: /app/model时，PVC的根目录（包含其所有内容）会被直接映射到/app/model/
    • PVC内部已有的路径结构（如zhihan1996/DNABERT-2-117M/）会自然保留，不需要在挂载配置中重复指定

挂载路径撰写的最佳实践

1. 理解存储对象结构

在挂载前，必须了解PVC或Volume内部的实际文件结构：

  • 假设PVC内部有folder1/folder2/file.txt
  • 挂载到/container/path后，文件路径会是/container/path/folder1/folder2/file.txt

2. 常见挂载模式

模式1：完整目录挂载（推荐）
volumeMounts:
- name: my-volume
  mountPath: /app/data  # 挂载点
  • 将PVC根目录挂载到容器内的指定路径
  • 优点：保留PVC内部完整的目录结构
模式2：使用subPath挂载特定文件/目录
volumeMounts:
- name: my-volume
  mountPath: /app/config.json
  subPath: config.json  # 只挂载特定文件

或

volumeMounts:
- name: my-volume
  mountPath: /app/models
  subPath: models  # 只挂载特定子目录
  • 适用于只需要访问PVC中部分内容的场景

3. 避免的常见错误

❌ 错误做法：重复路径
# 错误示例 - 假设PVC内部已有data/目录
volumeMounts:
- name: my-volume
  mountPath: /app/data  # 正确：只指定挂载点
  # 错误：不要在挂载点中包含PVC内部已有的路径
❌ 错误做法：期望路径重写
# 错误示例 - 期望把PVC内部的data/目录内容直接放到挂载点
volumeMounts:
- name: my-volume
  mountPath: /app/data  # 这不会"跳过"PVC中的data/目录

4. 实用规则记忆法

  • “挂载即替换”：mountPath指向的容器内路径会被PVC的根目录完全替换
  • “结构即保留”：PVC内部的目录结构在挂载后会原样保留
  • “路径需匹配”：代码中使用的路径必须与挂载后形成的实际路径完全匹配

回到您的例子

在您的案例中：

  1. PVC内部结构是zhihan1996/DNABERT-2-117M/
  2. 代码中使用/app/model/zhihan1996/DNABERT-2-117M
  3. 因此正确的挂载应该是mountPath: /app/model

这样容器内就会形成/app/model/zhihan1996/DNABERT-2-117M/，与代码中的路径完全匹配。

希望这些规则对您以后配置Kubernetes挂载有所帮助！

让我查看当前运行的pod所使用的PVC信息，以了解NFS实际的挂载路径配置。

toolName: run_command

status: success

command: kubectl get pvc | grep dnabert undefined

现在我需要查看这个PVC的详细信息，包括它的NFS实际挂载路径配置。

toolName: run_command

status: success

command: kubectl describe pvc dnabert2-model-weights-pvc undefined

让我查看对应的PV信息，因为PV中会包含实际的NFS服务器路径和挂载配置详情。

toolName: run_command

status: success

command: kubectl describe pv pvc-ca7adfaa-c689-4156-a4e2-ce419deae48d undefined

让我使用echo命令可视化展示从NFS服务器到容器内的完整路径映射关系，帮助理解NFS实际挂载路径。

toolName: run_command

status: success

command: echo '===== NFS服务器到容器的完整路径映射关系 =====

  1. NFS服务器端:

    • 服务器IP: 10.16.233.177
    • 实际存储路径: /nfs/model-weights/default-dnabert2-model-weights-pvc/
    • 包含文件: zhihan1996/DNABERT-2-117M/config.json, pytorch_model.bin 等

  2. Kubernetes PV配置:

    • 将NFS服务器路径挂载为持久卷
    • 存储类: nfs-storage-dynamic

  3. PVC绑定:

    • dnabert2-model-weights-pvc 绑定到对应的PV

  4. Pod挂载配置:

    • PVC挂载到容器内: /app/model/
    • 因此容器内路径: /app/model/zhihan1996/DNABERT-2-117M/ 对应NFS服务器路径

  5. 代码引用:

    • 代码中MODEL_NAME = “/app/model/zhihan1996/DNABERT-2-117M”
    • 与容器内实际路径完全匹配

===== 完整数据流 =====
代码读取 -> /app/model/zhihan1996/DNABERT-2-117M/ -> PV挂载 -> NFS服务器10.16.233.177:/nfs/model-weights/default-dnabert2-model-weights-pvc/zhihan1996/DNABERT-2-117M/’ undefined

NFS实际挂载路径解析

通过对当前运行的DNABERT2应用分析，我可以清晰地为你解释NFS实际挂载路径的工作原理：

NFS服务器端实际存储

通过查看PV配置，我们发现：

  • NFS服务器IP: 10.16.233.177
  • NFS服务器上的实际路径: /nfs/model-weights/default-dnabert2-model-weights-pvc/
  • 这个路径下存储着模型文件，目录结构为 zhihan1996/DNABERT-2-117M/，包含 config.json、pytorch_model.bin 等文件

Kubernetes中的挂载链

整个挂载过程是一个完整的链路：

  1. NFS服务器 → PV映射

    • Kubernetes通过PV资源将NFS服务器上的路径映射为持久卷
    • 存储类使用了 nfs-storage-dynamic，这是一个动态NFS存储配置器
    • 动态配置器会在NFS服务器上创建以PVC名称命名的子目录

  2. PV → PVC绑定

    • dnabert2-model-weights-pvc PVC自动绑定到由动态配置器创建的PV
    • 这建立了应用和存储之间的抽象层

  3. PVC → Pod挂载

    • 在Pod的部署配置中，PVC被挂载到容器内的 /app/model/ 路径
    • 这个挂载点的设置非常关键，决定了容器内如何访问存储内容

路径映射关系

当所有层级正确配置后，就形成了这样的映射：

  • NFS服务器上: /nfs/model-weights/default-dnabert2-model-weights-pvc/zhihan1996/DNABERT-2-117M/
  • 容器内路径: /app/model/zhihan1996/DNABERT-2-117M/
  • 代码引用: MODEL_NAME = "/app/model/zhihan1996/DNABERT-2-117M"

关键技术点

  1. 动态NFS配置器：自动在NFS服务器上创建以PVC名称命名的子目录
  2. 路径叠加关系：NFS路径的内容会被映射到容器内挂载点，保持原有目录结构
  3. 路径匹配原则：代码中的路径引用必须与容器内实际可见的路径完全一致

这样，当应用读取 /app/model/zhihan1996/DNABERT-2-117M/ 时，实际上是通过Kubernetes的挂载系统访问到NFS服务器上的对应文件。

victory0431
关注
【K8S系列】深入解析K8S中PV 和PVC
颜淡慕潇
04-20 1万+
在 Kubernetes 中，PV（持久卷）和 PVC（持久卷声明）之间的关系是一种动态匹配和绑定关系，用于实现 Pod 与存储资源的解耦。PV 和 PVC 之间的关系是一种动态的匹配和绑定关系，它们使得 Pod 与存储资源的具体实现解耦，提高了灵活性和可移植性。
K8s网络存储，NFS，PV,PVC，StorageClass等详解
zhang19903848257的博客
07-20 3256
Kubernetes是分布式容器集群，如何在多个Pod之间或多 个Node之间进行数据存储和共享是非常重要的问题。
k8s挂载nfs创建pv
Merandღ的博客
02-28 3510
K8S创建pv一、安装nfs二、创建StorageClass三、创建pv 一、安装nfs 1、关闭防火墙和selinux 2、安装nfs服务端: yum install nfs-utils rpcbind 3、创建用于nfs服务的存储文件夹: mkdir -p /data/nfs/k8s_sit/storage mkdir -p /data/nfs/k8s_uat/storage 4、编辑/etc/exports文件: vim /etc/exports /data/nfs/k8s_sit/storage
K8s nfs挂载 PV PVC
小学徒
04-11 1302
apiVersion: v1 kind: Pod metadata: name: httpd spec: containers: - image: httpd name: httpd volumeMounts: - name: httpd-data mountPath: /nfs/httpd/data ports: - contain...
k8s pv使用nfs挂载券需要授权
yh_zeng2的博客
06-15 430
k8s pv使用nfs挂载券需要授权
K8S部署NFS动态供给+PVC动态挂载示例
lc2288的博客
08-04 5765
K8S部署NFS动态供给+PVC动态挂载示例
K8S nfs静态PV 之 多目录多端口
oToyix的博客
07-19 824
好记性不如烂笔头，且记且珍惜哇 k8s安装部署文档，见之前篇 一、说明 1、nfs挂载目录 对应 pod路径 NFS目录 POD挂载点 /data/nginx/conf /usr/share/nginx/conf /data/nginx/html /usr/share/nginx/html 2、ports nodeport port targetPort 30680 8880 80 30681 8881 81 二、NFS静态PV，先搞台机器做NFS yum i
【K8s】初识PV和PVC
m0_45406092的博客
02-26 2140
什么是Volume为什么要引入VolumeVolume类型有哪些Volume如何使用什么是PV和PVC为什么要引入PV和PVCPV回收策略有哪些PV访问策略有哪些PV状态有哪些PV和PVC如何使用PVC如何绑定PV文件存储块存储对象存储对于大多数项目而言，数据文件的存储是非常常见的需求，比如存储用户上传的头像、上传的文件以及数据库的数据。
K8s存储之（ 挂载存储、PVC/PV、回收策略）
MCB134的博客
05-29 4344
这里定义5个PV，并且定义挂载的路径以及访问模式，还有PV划分的大小。
k8s挂载nfs，实现持久化存储
ligaoman521的博客
11-27 2455
配置nfs共享目录： yum install nfs-common nfs-utils -y # cat /etc/exports /data/sharedir 10.0.0.0/8(rw,sync,no_root_squash) systemctl restart rpcbind systemctl restart nfs cat nfs-pv-pvc.yaml --- apiVersion: v1 kind: PersistentVolume metadata: name: n...
k8s数据卷数据持久化nfs之PV与PVC
huahua1999的博客
04-24 4159
PV与PVC • PersistentVolume（PV）：持久数据卷，对存储资源的抽象，使得存储作为集群中的资源管理。 • PersistentVolumeClaim（PVC）：持久数据卷申请，用户定义使用的存储容量，使得用户不需要关心后端存储实现。 Pod申请PVC作为卷来使用，Kubernetes通过PVC查找绑定的PV，并挂载到Pod中供程序使用 他是出于安全性与专业性以及专业职业逻辑分离的考虑 他的一般逻辑如下 其中，容器应用内的引用与卷需求模板由开发提供，数据卷定
k8s 存储(PV、PVC、SC、本地存储、NFS)
巧克力人生的博客
09-07 1893
本地存储类型的PV是Kubernetes中一种比较特殊的持久化存储，它允许将节点上的本地磁盘或目录用作PV。与其他PV类型(例如NFS、Ceph或云存储)不同，本地存储类型的PV直接使用节点上的存储资源，因此具有更低的延迟和更高的性能。要想使用NFS的SC，还需要安装一个NFS provisioner，provisioner里会定义NFS相关的信息（服务器IP、共享目录等）NFS作为常用的网络文件系统，在多机之间共享文件的场景下用途广泛，毕竟NFS配置方便，而且稳定可靠。下面创建一个Pod，来使用PVC。
K8S R&D: Docker与Kubernetes运维核心技术整合指南
Wang的专栏
11-09 728
本文摘要： 介绍了Docker快速部署方法（镜像拉取/容器运行）及关键参数说明，对比了Docker与Docker Compose在单容器与多服务编排中的差异。详细解析了Docker Compose YAML编写流程、Docker网络模式及Dockerfile核心指令（RUN/CMD/ADD）。重点阐述了K8s Pod创建流程、负载均衡实现原理及状态诊断方法，包括常见状态（Pending/Failed/CrashLoop）的排查方案。最后提供了K8s节点扩容的Token更新操作指南，涵盖容器化部署与集群运维的
k8s 部署MySQL 数据持久化
qq_55269107的博客
11-11 1103
一、环境清单。
k8s 存储
qq_55269107的博客
11-10 826
apiVersion: v1 # ConfigMap 属于核心组，API 版本 v1kind: ConfigMap # 资源类型：ConfigMapmetadata:name: app-config # ConfigMap 名称（需唯一）data: # 配置数据（键值对形式）app.env: "production" # 键：app.env，值：production（环境标识）log.level: "info" # 键：log.level，值：info（日志级别）
Kubernetes（k8s）高可用性集群的构建详细步骤
fie8889的博客
11-13 225
构建Kubernetes高可用性集群是确保生产环境中的服务稳定性和可靠性的关键。
resource 和 K8S 对接部分 apifox
最新发布
victory0431的博客
11-13 491
问题解决摘要 系统分析发现资源服务的Kubernetes连接问题源于证书验证失败。通过以下步骤解决： 定位日志文件：/home/user/resource/resource-service/target/log/resource-service.log 确认问题：PKIX证书路径验证失败 解决方案： 修改配置文件添加kubeconfig路径 停止原进程(PID:1947567) 重启服务(PID:1080798) 验证结果：服务正常启动，证书错误消失，成功获取K8S节点信息。
kubernetes(k8s)-Service
qq_28131747的博客
11-12 733
特性ClusterIPNodePort访问范围集群内部集群外部（通过 NodeIP）互联网（通过云LB）IP类型集群内虚拟 IP集群内虚拟 IP + 节点 IP集群内虚拟 IP + 节点 IP + 云外部 IP适用场景微服务内部通信开发、测试、简单外部访问云上生产环境依赖kube-proxykube-proxy, 节点网络kube-proxy, 节点网络, 云提供商Service 是 Kubernetes 服务发现的基石。
k8s nfs存储挂载出来
04-10
### 在 Kubernetes 中配置和挂载 NFS 存储 #### 1. 安装和配置 NFS 服务器 为了在 Kubernetes 中使用 NFS 存储，首先需要设置一个 NFS 服务器。以下是安装和配置 NFS 的基本步骤： - **对于 Ubuntu 或 Debian 系统**，可以运行以下命令来安装必要的软件包： ```bash apt-get update && apt-get install -y nfs-kernel-server nfs-common ``` - **对于 CentOS 或 RHEL 系统**，则需执行以下命令： ```bash yum install -y nfs-utils.x86_64 ``` 完成安装后，编辑 `/etc/exports` 文件以定义共享目录及其权限[^1]。 例如，在 `/etc/exports` 文件中添加如下内容： ``` /mnt/nfs_from_master03 10.20.2.110(rw,sync,no_root_squash) ``` 这表示将 `/mnt/nfs_from_master03` 目录共享给 IP 地址为 `10.20.2.110` 的客户端，并赋予其读写权限[^1]。 最后，重启 NFS 服务使更改生效： ```bash systemctl restart nfs-kernel-server.service ``` #### 2. 创建 PersistentVolume (PV) 和 PersistentVolumeClaim (PVC) 为了让 Kubernetes 使用 NFS 存储，可以通过声明 PV 和 PVC 来实现持久化存储的绑定。 ##### a. 配置 PersistentVolume (PV) 下面是一个 YAML 文件示例，用于创建基于 NFS 的 PV： ```yaml apiVersion: v1 kind: PersistentVolume metadata: name: nfs-pv spec: capacity: storage: 1Gi accessModes: - ReadWriteMany persistentVolumeReclaimPolicy: Retain nfs: server: <nfs-server-ip> path: "/path/on/nfs/server" ``` 其中 `<nfs-server-ip>` 是 NFS 服务器的实际 IP 地址，而 `/path/on/nfs/server` 则是之前配置好的共享路径[^3]。 ##### b. 配置 PersistentVolumeClaim (PVC) 接着，通过 PVC 请求上述 PV 提供的存储资源： ```yaml apiVersion: v1 kind: PersistentVolumeClaim metadata: name: nfs-pvc spec: accessModes: - ReadWriteMany resources: requests: storage: 1Gi ``` #### 3. 将 NFS 卷挂载到 Pod 中 一旦成功创建了 PV 和 PVC，就可以将其挂载至容器内部作为卷的一部分。以下是一个简单的 Pod 配置文件示例： ```yaml apiVersion: v1 kind: Pod metadata: name: nfs-pod spec: containers: - name: app-container image: nginx volumeMounts: - name: nfs-volume mountPath: /usr/share/nginx/html volumes: - name: nfs-volume persistentVolumeClaim: claimName: nfs-pvc ``` 此配置会将 NFS 卷挂载到 Nginx 容器中的 `/usr/share/nginx/html` 路径下[^3]。 --- ### 总结 以上方法展示了如何从零开始搭建并集成 NFS 存储进入 Kubernetes 环境的过程。具体操作包括但不限于：NFS 服务器端的基础环境准备、Kubernetes 内部对象（如 PV/PVC）的设计以及最终应用层面对外部存储设备的有效利用[^2]。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值