卷类型之hostPath
hostPath类型的卷可以把宿主机节点上的文件或文件夹挂载到pod中
先来看看hostPath类型的卷如何配置:
apiVersion: v1
kind: Pod
metadata:
name: test-pd
spec:
volumes:
- name: test-volume
hostPath:
path: /data
type: Directory
containers:
- image: k8s.gcr.io/test-webserver
name: test-container
volumeMounts:
- name: test-volume
mountPath: /test-pd
mountPropagation: None
readOnly: true
subPath: test.txt
subPathExpr:
这里针对每一个配置项逐一解释:
sepc.volumes: 配置宿主机节点上的挂载目录
配置项名称 | 是否必须 | 说明 |
name | 必须 | 卷的名称,在pod内必须唯一 |
hostPath.path | 必须 | 宿主机上的目录路径,如果是符号链接,它将根据符号链接追踪到实际路径 |
hostPath.type | 可选 | hostPath卷的类型,默认为“” |
hostPath.type的枚举值有:
取值 | 说明 |
DirectoryOrCreate | 如果给定路径不存在,将根据需要在那里创建一个空目录,权限设置为755,与Kubelet具有相同的组和所有权。 |
Directory | 给定的目录路径必须存在 |
FileOrCreate | 如果给定路径不存在,将根据需要在那里创建一个空文件,权限设置为644,与Kubelet具有相同的组和所有权。 |
File | 给定路径上必须存在对应文件 |
Socket | 给定路径上必须存在一个UNIX socket |
CharDevice | 给定路径上必须存在字符设备 |
BlockDevice | 给定路径上必须存在块设备 |
使用type字段时需要注意:
由于节点上的文件不同,具有相同配置(如从podTemplate创建的)的Pods在不同节点上的行为可能不同
当Kubernetes按照计划添加资源感知调度(?)时,它将不会使用hostPath声明的资源
在主机上创建的文件或目录只能由根用户写。你需要在一个有特权的容器中以root身份运行进程,或者修改主机上的文件权限,以便能够写入hostPath卷
containers.volumeMounts: 配置挂载到pod里的路径
配置项名称 | 是否必须 | 说明 |
name | 必须 | 此处卷的名称必须和spec.volumes下的某个卷的名称一致 |
mountPath | 必须 | 挂载到容器里的路径,不能包含英文冒号‘:’ |
mountPropagation | 可选 | 该参数决定如何将挂载从主机传播到容器,反之亦然。默认为None |
readOnly | 可选 | 是否只读,默认为可读写 |
subPath | 可选 | 将spec.volumes中的子目录挂载到容器中不同的位置,默认为“”,也就是挂载到spec.volumes定义的根目录 |
subPathExpr | 可选 | 与subPath类似,但是路径中可以支持从环境变量取值:${VAR_NAME},默认为“”,也就是spec.volumes定义的根目录。和subPath只能有一个出现 |
mountPropagation的取值有:
None:默认值,卷在容器中以及宿主机上的后续挂载相互隔离
HostToContainer:任何在宿主机上创建的卷挂载在容器中都是可见的
Bidirectional:任何在容器中创建的卷挂载都会传播到宿主机,然后传播到所有使用此挂载的pod中的容器里