你正在查看的文档所针对的是 Kubernetes 版本: v1.30
Kubernetes v1.30 版本的文档已不再维护。你现在看到的版本来自于一份静态的快照。如需查阅最新文档,请点击 最新版本。
Kubernetes 1.30:防止未经授权的卷模式转换进阶到 GA
作者: Raunak Pradip Shah (Mirantis)
译者: Xin Li (DaoCloud)
随着 Kubernetes 1.30 的发布,防止修改从 Kubernetes 集群中现有 VolumeSnapshot 创建的 PersistentVolumeClaim 的卷模式的特性已被升级至 GA!
问题
PersistentVolumeClaim 的卷模式 是指存储设备上的底层卷是被格式化为某文件系统还是作为原始块设备呈现给使用它的 Pod。
用户可以利用自 Kubernetes v1.20 以来一直稳定的 VolumeSnapshot 特性,基于
Kubernetes 集群中现有的 VolumeSnapshot 创建 PersistentVolumeClaim(简称 PVC)。
PVC 规约中包括一个 dataSource
字段,它可以指向现有的 VolumeSnapshot 实例。
有关如何基于 Kubernetes 集群中现有 VolumeSnapshot 创建 PVC 的更多详细信息,
请访问使用卷快照创建 PersistentVolumeClaim。
当利用上述特性时,没有逻辑来验证制作快照的原始卷的模式是否与新创建的卷的模式匹配。
这带来了一个安全漏洞,允许恶意用户潜在地利用主机操作系统中未知的漏洞。
有一个合法的场景允许某些用户执行此类转换。 通常,存储备份供应商会在备份操作过程中转换卷模式,通过检索已被更改的块来提高操作效率。 这使得 Kubernetes 无法完全阻止此类操作,但给区分可信用户和恶意用户带来了挑战。
防止未经授权的用户转换卷模式
在此上下文中,授权用户是有权对 VolumeSnapshotContents(集群级资源)执行 update 或 patch 操作的用户。 集群管理员应仅向受信任的用户或应用程序(例如备份供应商)赋予这些权限。 当从 VolumeSnapshot 创建 PVC 时,除了此类授权用户之外的用户将永远不会被允许修改 PVC 的卷模式。
要转换卷模式,授权用户必须执行以下操作:
-
标识要用作给定命名空间中新创建的 PVC 的数据源的 VolumeSnapshot。
-
识别与上述 VolumeSnapshot 绑定的 VolumeSnapshotContent。
kubectl describe volumesnapshot -n <namespace> <name>
-
在 VolumeSnapshotContent 上添加
snapshot.storage.kubernetes.io/allow-volume-mode-change: "true"
注解,VolumeSnapshotContent 注解必须包含类似于以下清单片段:kind: VolumeSnapshotContent metadata: annotations: - snapshot.storage.kubernetes.io/allow-volume-mode-change: "true" ...
注意:对于预配置的 VolumeSnapshotContents,你必须执行额外的步骤,将
spec.sourceVolumeMode
字段设置为 Filesystem
或 Block
,
具体取决于用来制作此快照的卷的模式。
一个例子如下所示:
apiVersion: snapshot.storage.k8s.io/v1
kind: VolumeSnapshotContent
metadata:
annotations:
- snapshot.storage.kubernetes.io/allow-volume-mode-change: "true"
name: <volume-snapshot-content-name>
spec:
deletionPolicy: Delete
driver: hostpath.csi.k8s.io
source:
snapshotHandle: <snapshot-handle>
sourceVolumeMode: Filesystem
volumeSnapshotRef:
name: <volume-snapshot-name>
namespace: <namespace>
对备份或恢复操作期间需要转换卷模式的所有 VolumeSnapshotContent 重复步骤 1 至 3。 这可以通过具有授权用户凭据的软件来完成,也可以由授权用户手动完成。
如果 VolumeSnapshotContent 对象上存在上面显示的注解,Kubernetes 将不会阻止卷模式转换。 用户在尝试将注解添加到任何 VolumeSnapshotContent 之前应记住这一点。
需要采取的行动
默认情况下,在 external-provisioner v4.0.0
和 external-snapshotter v7.0.0
中启用 prevent-volume-mode-conversion
特性标志。
基于 VolumeSnapshot 来创建 PVC 时,卷模式更改将被拒绝,除非已执行上述步骤。
接下来
要确定哪些 CSI 外部 sidecar 版本支持此功能,请前往 CSI 文档页面。 对于任何疑问或问题,请加入 Slack 上的 Kubernetes 并在 #csi 或 #sig-storage 频道中发起讨论。 或者,在 CSI 外部快照仓库中登记问题。