大网数据广告活动
Kubernetes 部署与运维

配置 Pod 以使用 PersistentVolume 作为存储

· 52CE 我爱测

1. 你作为集群管理员创建由物理存储支持的 PersistentVolume。你不会将该卷与任何 Pod 关联。

本文将向你介绍如何配置 Pod 使用

作为存储。以下是该过程的总结:

  1. 你作为集群管理员创建由物理存储支持的 PersistentVolume。你不会将该卷与任何 Pod 关联。

  2. 你现在以开发人员或者集群用户的角色创建一个 PersistentVolumeClaim, 它将自动绑定到合适的 PersistentVolume。

  3. 你创建一个使用以上 PersistentVolumeClaim 作为存储的 Pod。

  • 你需要一个包含单个节点的 Kubernetes 集群,并且必须配置 命令行工具以便与集群交互。 如果还没有单节点集群,可以使用 Minikube 创建一个。

  • 熟悉持久卷文档。

在你的节点上创建一个 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 资源本身中。

参考 {#reference}

来源:Kubernetes 文档贡献者 · 作者与贡献记录 · CC BY 4.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
Kubernetes 文档贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。