使用Docker与Kubernetes Deployment无法读写本地文件问题排查

我正在使用minikube测试Kubernetes，部署了一个Java应用，配置了两个HostPath卷，但无法读写本地系统指定路径下的文件。以下是我的配置文件：

Dockerfile #

FROM openjdk:17-jdk-alpine
ARG JARFILE=target/*.jar
COPY ./target/zion-0.0.1-SNAPSHOT.jar app.jar
VOLUME /home/ubuntu/yd/
VOLUME /etc/dost/yd/
ENTRYPOINT ["java", "-jar", "/app.jar"]

Deployment YAML #

apiVersion: apps/v1
kind: Deployment
metadata:
  name: deploymentlocal
spec:
  replicas: 2
  selector:
    matchLabels:
      app: dep
  template:
    metadata:
      labels:
        app: dep
    spec:
      containers:
        - name: dep-container
          image: java17dep
          imagePullPolicy: Never
          ports:
            - containerPort: 8080
          livenessProbe:
            httpGet:
              path: /v3/test/db
              port: 8080
            initialDelaySeconds: 60
            periodSeconds: 60
            timeoutSeconds: 5
          volumeMounts:
            - name: yd-volume
              mountPath: /home/ubuntu/yd
            - name: z-volume
              mountPath: /etc/dost/yd
      volumes:
        - name: yd-volume
          hostPath:
            path: /home/ubuntu/yd
        - name: z-volume
          hostPath:
            path: /etc/dost/yd

集群和镜像运行正常，但就是无法读写本地指定路径的文件，请问配置哪里有问题？

核心问题是Minikube的运行环境特性：Minikube本质是在宿主机的虚拟机（或容器）内运行K8s集群，你Deployment中hostPath指向的是Minikube节点内部的路径，而非你物理宿主机的路径。以下是具体修复步骤：

1. 确认Minikube节点内的目标路径存在并配置权限 #

首先进入Minikube节点的shell：

minikube ssh

在Minikube节点内创建所需目录：

sudo mkdir -p /home/ubuntu/yd /etc/dost/yd

设置目录权限，确保容器内的用户能读写（如果容器用root用户，直接开放权限；如果是普通用户，需匹配UID）：

# 临时测试可用宽松权限
sudo chmod 777 /home/ubuntu/yd /etc/dost/yd

# 更严谨的方式：先进入容器执行`id`查看运行UID，假设为1000
sudo chown 1000:1000 /home/ubuntu/yd /etc/dost/yd

2. 若需挂载宿主机本地路径到Minikube节点 #

如果你想让容器读写物理宿主机的路径，需要用Minikube的挂载功能将宿主机路径同步到Minikube节点：

# 挂载单个路径
minikube mount /宿主机的/home/ubuntu/yd:/home/ubuntu/yd

# 挂载多个路径可开多终端，或用--mount-string参数
minikube mount --mount-string /宿主机的/home/ubuntu/yd:/home/ubuntu/yd --mount-string /宿主机的/etc/dost/yd:/etc/dost/yd

注意：这种挂载是临时的，Minikube重启后会失效，如需持久化，建议使用Minikube的PersistentVolume或Local PV方案。

3. 移除Dockerfile中的VOLUME指令 #

Dockerfile中的VOLUME会自动创建匿名卷，可能和Deployment中配置的hostPath卷产生冲突，建议直接删除这两行：

# 移除这两行
VOLUME /home/ubuntu/yd/
VOLUME /etc/dost/yd/

4. 验证配置 #

修改后重新构建镜像并更新Deployment：

docker build -t java17dep .
kubectl apply -f deployment.yaml

进入容器验证路径读写：

# 找到目标Pod名称
kubectl get pods
# 进入容器shell
kubectl exec -it <pod-name> -- sh
# 测试读写操作
touch /home/ubuntu/yd/test.txt && echo "test" > /home/ubuntu/yd/test.txt && cat /home/ubuntu/yd/test.txt

内容的提问来源于stack exchange，提问作者vtustudent