subPath其實就是volumes掛載的子目錄或單個文件，是不是目錄和單文件，取決于subPath在volumes掛載的目錄下是否存在subPath定義的文件（文件或目錄），如果不存在，則會volumes對應的目錄下創建一個subPath目錄。
一、概述
有時，在單個 Pod 中共享卷以供多方使用是很有用的。volumeMounts.subPath 屬性可用于指定所引用的卷內的子路徑，而不是其根路徑。
官方文檔：https://kubernetes.io/zh-cn/docs/concepts/storage/volumes/#using-subpath
二、使用場景
- 一個共享卷, 掛載多個路徑。
- ConfigMap或Secret掛載到特定目錄的特定路徑, 而 該目錄下已經有其他文件且不希望被覆蓋掉。
三、共享卷中使用, 掛載多個路徑
作為configmap/secret使用時,subPath代表configmap/secret的子路徑。
【示例1】掛載目錄，hostPath
apiVersion: v1
kind: Pod
metadata:
name: my-lamp-site
spec:
nodeName: local-168-182-110 # 為了測試方便，指定調度機器
containers:
- name: mysql
image: mysql
env:
- name: MYSQL_ROOT_PASSWORD
value: "rootpasswd"
volumeMounts:
- mountPath: /var/lib/mysql #掛載到容器的某個路徑下
name: site-data #掛載設備的名字，與volumes[*].name 需要對應
subPath: mysql # volumes path中的子路徑（會自動在volumes path目錄下創建mysql空目錄）
- name: php
image: php:7.0-apache
volumeMounts:
- mountPath: /var/www/html #掛載到容器的某個路徑下
name: site-data # volumes path中的子路徑（會自動在volumes path目錄下創建site-data【空目錄】）
subPath: html
volumes:
- name: nginx #和上面保持一致 這是本地的文件路徑，上面是容器內部的路徑
hostPath:
path: /opt/k8s/subPath/lamp #此路徑需要實現創建
【示例2】掛載目錄，pvc
# StorageClass
kind: StorageClass
apiVersion: storage.k8s.io/v1
metadata:
name: local-storage
provisioner: kubernetes.io/no-provisioner
volumeBindingMode: WaitForFirstConsumer
---
# pvc
apiVersion: v1
kind: PersistentVolume
metadata:
name: local-lamp-pv
labels:
name: local-lamp-pv
spec:
capacity:
storage: 1Gi
accessModes:
- ReadWriteOnce
persistentVolumeReclaimPolicy: Retain
storageClassName: local-storage
local:
path: /opt/k8s/subPath/lamp-pvc
nodeAffinity:
required:
nodeSelectorTerms:
- matchExpressions:
- key: kubernetes.io/hostname
operator: In
values:
- local-168-182-110
---
# pvc
kind: PersistentVolumeClaim
apiVersion: v1
metadata:
name: my-lamp-site-data
spec:
accessModes:
- ReadWriteOnce
resources:
requests:
storage: 1Gi
storageClassName: local-storage
selector:
matchLabels:
name: local-lamp-pv
---
apiVersion: v1
kind: Pod
metadata:
name: my-lamp-site-pvc
spec:
containers:
- name: mysql
image: mysql
env:
- name: MYSQL_ROOT_PASSWORD
value: "rootpasswd"
volumeMounts:
- mountPath: /var/lib/mysql
name: site-data
subPath: mysql
- name: php
image: php:7.0-apache
volumeMounts:
- mountPath: /var/www/html
name: site-data
subPath: html
volumes:
- name: site-data
persistentVolumeClaim:
claimName: my-lamp-site-data
如果使用PVC模板就不用手動創建PVC了，示例如下：
volumeClaimTemplates: #可看作pvc的模板
- metadata:
name: nginx-pvc
spec:
accessModes: [ "ReadWriteOnce" ]
storageClassName: "local-storage" #存儲類名，就是上面nginx-sc.yaml metadata.name
resources:
requests:
storage: 1Gi
【示例3】共享單個文件那么如果 subPath 不是文件夾，而是一個文件，又該如何解決呢？同樣的道理，只需要通過 subPath 指定出該文件即可，注意 subPath 要使用相對目錄。具體如下所示：
apiVersion: apps/v1
kind: Deployment
metadata:
name: deployment-test
spec:
replicas: 1
selector:
matchLabels:
app: nginx-pod
template:
metadata:
labels:
app: nginx-pod
spec:
nodeName: local-168-182-110 # 為了測試方便，指定調度機器
containers:
- name: nginx
image: docker.io/library/nginx:latest
volumeMounts:
- mountPath: /etc/nginx/nginx.conf
name: nginx-conf
subPath: nginx-conf
volumes:
- name: nginx-conf #和上面保持一致 這是本地的文件路徑，上面是容器內部的路徑
hostPath:
path: /opt/k8s/subPath/nginx #此路徑需要實現創建
【結論】以宿主機上的文件為準，會覆蓋pod里原先默認的的文件內容。
四、ConfigMap 和 Secret 中使用 subPath
作為configmap/secret使用時,subPath代表configmap/secret?的子路徑。如果不使用subPath?會把容器里原本的文件（volumeMounts.mountPath?對應的目錄）都清空，自會把ConfigMap 和 Secret 的文件放在volumeMounts.mountPath對應的目錄下。
【示例1】ConfigMap
apiVersion: v1
kind: ConfigMap
metadata:
name: nginx-conf
data:
nginx.conf: |+
worker_processes 1;
events {
worker_connections 1024;
}
http {
include mime.types;
default_type application/octet-stream;
sendfile on;
keepalive_timeout 65;
server {
listen 80;
server_name localhost;
location / {
root html;
index index.html index.htm;
}
error_page 500 502 503 504 /50x.html;
location = /50x.html {
root html;
}
}
}
---
apiVersion: apps/v1
kind: Deployment
metadata:
name: deployment-test2
spec:
replicas: 1
selector:
matchLabels:
app: nginx-pod
template:
metadata:
labels:
app: nginx-pod
spec:
nodeName: local-168-182-110 # 為了測試方便，指定調度機器
containers:
- name: nginx
image: docker.io/library/nginx:latest
volumeMounts:
- name: nginx-cm # 與volumes.name一致
mountPath: /etc/nginx/nginx.conf
subPath: nginx.conf
volumes:
- name: nginx-cm
configMap:
name: nginx-conf # configMap名稱
【示例1】Secret
apiVersion: v1
kind: Secret
metadata:
name: mysecret
type: Opaque
data:
username: admin
password: MWYyZDFlMmU2N2Rm
---
vim myapp-demo.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
name: mysql-demo
namespace: default
spec:
replicas: 1
selector:
matchLabels:
app: myapp
template:
metadata:
labels:
app: myapp
spec:
containers:
- name: myapp
image: mysql
imagePullPolicy: IfNotPresent
ports:
- name: http
containerPort: 80
volumeMounts:
- name: mysql
mountPath: /tmp/data
subPath: data
volumes:
- name: mysql
secret:
secretName: mysecret
【結論】會在/tmp目錄下面存放data文件信息，如果存在則覆蓋。如果不存在，則自動創建。
最后對volumeMounts.subPath來一個總結：
- subPath其實就是volumes掛載的子目錄或單個文件，是不是目錄和單文件，取決于subPath在volumes掛載的目錄下是否存在subPath定義的文件（文件或目錄），如果不存在，則會volumes對應的目錄下創建一個subPath目錄。
- 如果ConfigMap 和 Secret 中使用 subPath，如果不指定subPath，則會把volumeMounts.mountPath對應的目錄下的文件都清掉，然后只存放ConfigMap 或者 Secret 定義的文件。
關于volumeMounts.subPath的用法就先到這里了，有疑問的小伙伴，歡迎給我留言哦，后續文章更精彩，請小伙伴耐心等待哦~
