在 K8S Volume 中使用 subPath

本文最后更新于:2024年7月24日 晚上

使用 subPath

有时,在单个 Pod 中共享卷以供多方使用是很有用的。 volumeMounts.subPath 属性可用于指定所引用的卷内的子路径,而不是其根路径。

下面是一个使用同一共享卷的、内含 LAMP 栈(Linux Apache Mysql PHP)的 Pod 的示例。 HTML 内容被映射到卷的 html 文件夹,数据库将被存储在卷的 mysql 文件夹中:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
apiVersion: v1
kind: Pod
metadata:
name: my-lamp-site
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

对上面的配置进行说明:

  1. volumeMounts 下面的name, 就是分配给这个 pod 的 volume 的名字site-data, mysql 和 php 的 html 分别使用了它的子路径: mysqlhtml
  2. volumes 对于 site-data 这个 volume, 是通过 PVC 的形式提供的, PVC 的 name 为: my-lamp-site-data

使用带有扩展环境变量的 subPath

FEATURE STATE: Kubernetes v1.15 feature-state-beta.txt

使用 subPathExpr 字段从 Downward API 环境变量构造 subPath 目录名。 在使用此特性之前,必须启用 VolumeSubpathEnvExpansion 功能开关。 subPathsubPathExpr 属性是互斥的。

在这个示例中,Pod 基于 Downward API 中的 Pod 名称,使用 subPathExpr 在 hostPath 卷 /var/log/pods 中创建目录 pod1。 主机目录 /var/log/pods/pod1 挂载到了容器的 /logs 中。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
apiVersion: v1
kind: Pod
metadata:
name: pod1
spec:
containers:
- name: container1
env:
- name: POD_NAME
valueFrom:
fieldRef:
apiVersion: v1
fieldPath: metadata.name
image: busybox
command: ["sh", "-c", "while [true]; do echo 'Hello'; sleep 10; done | tee -a /logs/hello.txt" ]
volumeMounts:
- name: workdir1
mountPath: /logs
subPathExpr: $(POD_NAME)
restartPolicy: Never
volumes:
- name: workdir1
hostPath:
path: /var/log/pods

说明:

  1. env 中, 配置了 POD_NAME 这个环境变量, 这个变量的值来自于metadata.name, 即pod1
  2. subPathExpr: $(POD_NAME) 子路径为 $(POD_NAME) 这个变量, 就是pod1
  3. volume 用的是hostPath, 实际路径为:/var/log/pods. 那么完整的 path 就是/var/log/pods/pod1

总结

subPath 还是挺实用的, 是个小功能, 但是确实能提交效率. 比如我昨天搭建的禅道的容器. 就是典型的 LAMP: Linux + Apache + Mysql + PHP.

这些组件中,

  • Apachewww/html 需要挂载
  • mysql的数据库需要挂载
  • php的应用数据需要挂载

如果没用 subPath, 那么我得这么操作: (以 nfs 为例)

  1. nfs 下手动创建 3 个子目录: html  mysql php
  2. 创建 3 个 PV, 分别为: apache-volume mysql-volume php-volume
  3. 写 3 个 PVC, 分别是: apache-claim mysql-claim php-claim. 而且 2 和 3 这两步最好一个 pv+ 一个 PVC 来建. 避免 bound 乱了.
  4. 再修改Deployment 配置, 一个个挂载上去.

△ 算下来,10 步.

用了 subPath, 确实节省了工作量: (还是以 nfs 为例)

  1. 创建 1 个 PV, 为: LAMP-volume
  2. 创建 1 个 PVC, 为: LAMP-claim
  3. 再修改Deployment 配置, 挂载一个 PVC, 用 subPath 区分.

△ 算下来, 3 步.


在 K8S Volume 中使用 subPath
https://ewhisper.cn/posts/64498/
作者
东风微鸣
发布于
2019年11月7日
许可协议