Mac下Minikube环境中如何将本地Jar挂载到Kubernetes Pod目录

问题背景 #

在Mac系统的Minikube环境部署Kubernetes应用时，尝试将本地目录中的Jar文件挂载到Pod内指定路径，遇到以下问题：

1. 直接以File类型挂载单个Jar文件时，出现挂载失败错误：

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: master
   spec:
     replicas: 1
     (...)
         containers:
           - name: master-c
             (...)
             volumeMounts:
               (...)
               - name: master-volume
                 mountPath: /server/plugins/master.jar
                 #subPath: master.jar
         volumes:
           - name: master-volume
             hostPath: 
               path: /localdir/master.jar
               type: File
   

   报错信息：

   Warning  FailedMount  10s (x6 over 26s)  kubelet           
   MountVolume.SetUp failed for volume "master-volume" : hostPath type check failed: /localdir/master.jar is not a file
   

2. 尝试挂载整个本地目录时，挂载成功但Pod内对应路径显示为空目录：

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: master
   spec:
     replicas: 1
     (...)
         containers:
           - name: master-c
             (...)
             volumeMounts:
               (...)
               - name: master-volume
                 mountPath: /server/plugins
                 #subPath: master.jar
         volumes:
           - name: master-volume
             hostPath: 
               path: /localdir
               type: Directory
   

   需求是让Jar文件在应用启动前就可用，kubectl cp方式因为是在应用启动后复制，无法被应用识别。

解决步骤 #

Minikube在Mac上运行在虚拟机中，hostPath指向的是Minikube虚拟机内部的路径，而非Mac本地路径。需要先将Mac本地目录挂载到Minikube虚拟机，再通过hostPath引用：

1. 挂载Mac本地目录到Minikube虚拟机
   执行以下命令，将Mac本地的/localdir目录挂载到Minikube虚拟机的/data/localdir路径（路径可自定义）：

   minikube mount /localdir:/data/localdir
   

   保持该命令窗口开启，挂载会持续生效。

2. 修改Deployment配置
   更新Deployment的volumes和volumeMounts部分，使用Minikube虚拟机内的挂载路径，并通过subPath指定单个Jar文件：

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: master
   spec:
     replicas: 1
     selector:
       matchLabels:
         app: master
     template:
       metadata:
         labels:
           app: master
       spec:
         containers:
           - name: master-c
             # 替换为你的应用镜像
             image: your-app-image:tag
             volumeMounts:
               - name: master-volume
                 mountPath: /server/plugins/master.jar
                 subPath: master.jar
         volumes:
           - name: master-volume
             hostPath: 
               path: /data/localdir
               type: Directory
   

原因说明 #

• 之前直接使用Mac本地路径作为hostPath时，Minikube虚拟机内不存在该路径，导致kubelet无法找到对应文件或目录，从而报错。
• 通过minikube mount将Mac本地目录同步到Minikube虚拟机后，hostPath指向的是虚拟机内已存在的目录，配合subPath可以精准挂载单个Jar文件，确保应用启动前文件已存在。

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