本文将向你介绍如何配置 Pod 使用
作为存储。以下是该过程的总结:
-
你作为集群管理员创建由物理存储支持的 PersistentVolume。你不会将该卷与任何 Pod 关联。
-
你现在以开发人员或者集群用户的角色创建一个 PersistentVolumeClaim, 它将自动绑定到合适的 PersistentVolume。
-
你创建一个使用以上 PersistentVolumeClaim 作为存储的 Pod。
在你的节点上创建一个 index.html 文件 {#create-an-index-html-file-on-your-node}
打开集群中某个节点的 Shell。如何打开 Shell 取决于集群的设置。
例如,如果你正在使用 Minikube,那么可以通过输入 minikube ssh 来打开节点的 Shell。
在该节点的 Shell 中,创建一个 /mnt/data 目录:
# 这里假定你的节点使用 "sudo" 来运行命令
# 即以超级用户身份运行
sudo mkdir /mnt/data
在 /mnt/data 目录中创建一个 index.html 文件:
# 这里再次假定你的节点使用 "sudo" 来运行命令
# 即以超级用户身份运行
sudo sh -c "echo 'Hello from Kubernetes storage' > /mnt/data/index.html"
如果你的节点使用 sudo 以外的工具来获得超级用户访问权限,
通常只要把上述命令中的 sudo 替换成该工具的名称即可。
测试 index.html 文件确实存在:
cat /mnt/data/index.html
输出应该是:
Hello from Kubernetes storage
现在你可以关闭连接到节点的 Shell 了。
创建 PersistentVolume {#create-a-persistentvolume}
在本练习中,你将创建一个 hostPath 类型的 PersistentVolume。 Kubernetes 在单节点集群上支持使用 hostPath 进行开发和测试。 hostPath 类型的 PersistentVolume 使用节点上的文件或目录来模拟网络附加存储。
在生产集群中,你不会使用 hostPath。集群管理员会提供网络存储资源,比如 Google Compute Engine 持久盘、NFS 共享卷或 Amazon Elastic Block Store 卷。集群管理员还可以使用 StorageClass 来设置动态制备。
下面是 hostPath PersistentVolume 的配置文件:
此配置文件指定卷位于集群节点上的 /mnt/data 路径。
该配置还指定卷的容量为 10 GiB,访问模式为 ReadWriteOnce,
这意味着该卷可以被单个节点以读写方式挂载。它为 PersistentVolume 定义了
StorageClass 名称
manual,用于将 PersistentVolumeClaim 的请求绑定到此 PersistentVolume。
为了简化,本示例采用了 ReadWriteOnce 访问模式。
然而对于生产环境,Kubernetes 项目建议改用 ReadWriteOncePod 访问模式。
创建 PersistentVolume:
kubectl apply -f https://k8s.io/examples/pods/storage/pv-volume.yaml
查看 PersistentVolume 的信息:
kubectl get pv task-pv-volume
输出结果显示该 PersistentVolume 的 STATUS 为 Available。
这意味着它尚未被绑定到任何 PersistentVolumeClaim。
NAME CAPACITY ACCESSMODES RECLAIMPOLICY STATUS CLAIM STORAGECLASS REASON AGE
task-pv-volume 10Gi RWO Retain Available manual 4s
创建 PersistentVolumeClaim {#create-a-persistentvolumeclaim}
下一步是创建一个 PersistentVolumeClaim。 Pod 使用 PersistentVolumeClaim 来请求物理存储。 在本练习中,你将创建一个 PersistentVolumeClaim, 它请求至少 3 GiB 容量的卷,该卷一次最多可以为一个节点提供读写访问。
下面是 PersistentVolumeClaim 的配置文件:
创建 PersistentVolumeClaim:
kubectl apply -f https://k8s.io/examples/pods/storage/pv-claim.yaml
创建 PersistentVolumeClaim 之后, Kubernetes 控制平面会查找满足该申领要求的 PersistentVolume。 如果控制平面找到具有相同 StorageClass 的合适的 PersistentVolume, 就会将该申领绑定到该卷上。
再次查看 PersistentVolume:
kubectl get pv task-pv-volume
现在输出显示 STATUS 为 Bound。
NAME CAPACITY ACCESSMODES RECLAIMPOLICY STATUS CLAIM STORAGECLASS REASON AGE
task-pv-volume 10Gi RWO Retain Bound default/task-pv-claim manual 2m
查看 PersistentVolumeClaim:
kubectl get pvc task-pv-claim
输出结果表明该 PersistentVolumeClaim 已绑定到你的 PersistentVolume,
即 task-pv-volume。
NAME STATUS VOLUME CAPACITY ACCESSMODES STORAGECLASS AGE
task-pv-claim Bound task-pv-volume 10Gi RWO manual 30s
创建 Pod {#create-a-pod}
下一步是创建一个使用你的 PersistentVolumeClaim 作为存储卷的 Pod。
下面是此 Pod 的配置文件:
注意,Pod 的配置文件指定了 PersistentVolumeClaim,但没有指定 PersistentVolume。 对 Pod 而言,这个申领就是一个存储卷。
创建 Pod:
kubectl apply -f https://k8s.io/examples/pods/storage/pv-pod.yaml
验证 Pod 中的容器正在运行:
kubectl get pod task-pv-pod
打开一个 Shell 访问 Pod 中运行的容器:
kubectl exec -it task-pv-pod -- /bin/bash
在 Shell 中,验证 nginx 是否正在从 hostPath 卷提供 index.html 文件:
# 请务必在上一步通过 "kubectl exec" 进入的 root Shell 中
# 运行以下 3 条命令
apt update
apt install curl
curl http://localhost/
输出显示的是你写入 hostPath 卷中 index.html 文件里的文本:
Hello from Kubernetes storage
如果你看到了这条消息,说明你已经成功配置 Pod 使用来自 PersistentVolumeClaim 的存储。
清理 {#clean-up}
删除 Pod:
kubectl delete pod task-pv-pod
在两个位置挂载同一个 PersistentVolume {#mounting-the-same-persistentvolume-in-two-places}
你已经了解了如何创建 PersistentVolume 和 PersistentVolumeClaim,也了解了如何将卷挂载到容器中的单个位置。 下面我们来看看如何在容器中的两个不同位置挂载同一个 PersistentVolume。以下是一个示例:
其中:
subPath:此字段允许将所挂载 PersistentVolume 中的特定文件或目录暴露到容器内的不同位置。在本例中:subPath: html挂载 html 目录。subPath: nginx.conf挂载一个特定文件 nginx.conf。
由于第一个 subPath 是 html,需要在节点上的 /mnt/data/ 下创建一个 html 目录。
第二个 subPath nginx.conf 表示将使用 /mnt/data/ 目录下的一个文件。无需创建其他目录。
你的 nginx 容器中会做两个卷挂载:
/usr/share/nginx/html用于静态网站/etc/nginx/nginx.conf用于默认配置
将节点上的 index.html 文件移动到新的文件夹 {#move-the-index-html-file-on-your-node-to-a-new-folder}
这里提到的 index.html
文件指的是在“在你的节点上创建一个 index.html 文件”一节中创建的那个文件。
打开连接到集群中单个节点的 Shell。如何打开 Shell 取决于集群的设置方式。
例如,如果你使用 Minikube,可以输入 minikube ssh 打开节点的 Shell。
创建 /mnt/data/html 目录:
# 这里假定你的节点使用 "sudo" 来运行命令
# 即以超级用户身份运行
sudo mkdir /mnt/data/html
将 index.html 移动到该目录中:
# 将 index.html 从当前位置移动到 html 子目录
sudo mv /mnt/data/index.html /mnt/data/html/index.html
新建 nginx.conf 文件 {#create-a-new-nginx-conf-file}
这是默认 nginx.conf 文件的修改版。这里将默认的 keepalive_timeout 修改为 60。
创建 nginx.conf 文件:
cat <<EOF > /mnt/data/nginx.conf
user nginx;
worker_processes auto;
error_log /var/log/nginx/error.log notice;
pid /var/run/nginx.pid;
events {
worker_connections 1024;
}
http {
include /etc/nginx/mime.types;
default_type application/octet-stream;
log_format main '\$remote_addr - \$remote_user [\$time_local] "\$request" '
'\$status \$body_bytes_sent "\$http_referer" '
'"\$http_user_agent" "\$http_x_forwarded_for"';
access_log /var/log/nginx/access.log main;
sendfile on;
#tcp_nopush on;
keepalive_timeout 60;
#gzip on;
include /etc/nginx/conf.d/*.conf;
}
EOF
创建 Pod {#create-a-pod-1}
这里我们将创建一个 Pod,使用已有的 PersistentVolume 和 PersistentVolumeClaim。
不过,该 Pod 只把特定文件 nginx.conf 和目录 html 挂载到容器中。
创建 Pod:
kubectl apply -f https://k8s.io/examples/pods/storage/pv-duplicate.yaml
验证 Pod 中的容器正在运行:
kubectl get pod test
打开一个 Shell 访问 Pod 中运行的容器:
kubectl exec -it test -- /bin/bash
在 Shell 中,验证 nginx 是否正在从 hostPath 卷提供 index.html 文件:
# 请务必在上一步通过 "kubectl exec" 进入的 root Shell 中
# 运行以下 3 条命令
apt update
apt install curl
curl http://localhost/
输出显示的是你写入 hostPath 卷中 index.html 文件里的文本:
Hello from Kubernetes storage
在 Shell 中,还要验证 nginx 是否正在从 hostPath 卷提供 nginx.conf 文件:
# 请务必在上一步通过 "kubectl exec" 进入的 root Shell 中
# 运行以下命令
cat /etc/nginx/nginx.conf | grep keepalive_timeout
输出显示的是你写入 hostPath 卷中 nginx.conf 文件里的修改后文本:
keepalive_timeout 60;
如果你看到了这些消息,说明你已经成功将 Pod 配置为使用 PersistentVolumeClaim 存储中的特定文件和目录。
清理 {#clean-up-1}
删除 Pod:
kubectl delete pod test
kubectl delete pvc task-pv-claim
kubectl delete pv task-pv-volume
如果你还没有打开连接到集群中节点的 Shell, 请按之前的方式新开一个 Shell。
在节点上的 Shell 中,删除你创建的文件和目录:
# 这里假定你的节点使用 "sudo" 来运行命令
# 即以超级用户身份运行
sudo rm /mnt/data/html/index.html
sudo rm /mnt/data/nginx.conf
sudo rmdir /mnt/data/html
sudo rmdir /mnt/data
现在你可以关闭连接到节点的 Shell 了。
访问控制 {#access-control}
使用组 ID(GID)配置的存储仅允许使用相同 GID 的 Pod 写入。 GID 不匹配或缺失会导致权限拒绝错误。 为了减少与用户协调的需要,管理员可以为 PersistentVolume 添加 GID 注解。 之后,GID 会被自动添加到使用该 PersistentVolume 的任何 Pod 中。
使用 pv.beta.kubernetes.io/gid 注解的方法如下所示:
apiVersion: v1
kind: PersistentVolume
metadata:
name: pv1
annotations:
pv.beta.kubernetes.io/gid: "1234"
当 Pod 使用带有 GID 注解的 PersistentVolume 时, 所注解的 GID 会以与 Pod 安全上下文中指定的 GID 相同的方式应用到 Pod 中的所有容器。 无论是来自 PersistentVolume 注解还是来自 Pod 规约, 每个 GID 都会被应用到每个容器中运行的第一个进程。
当 Pod 使用 PersistentVolume 时,与 PersistentVolume 关联的 GID 不会出现在 Pod 资源本身中。
- 进一步了解 PersistentVolumes。
- 阅读持久存储设计文档。
参考 {#reference}
来源:Kubernetes 文档贡献者 · 作者与贡献记录 · CC BY 4.0。离线整理了版式、链接和媒体显示。
