Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

7.3. 定义存储类

StorageClass 对象目前是一个全局范围的对象，必须由 cluster-admin 或 storage-admin 用户创建。

重要

根据使用的平台，Cluster Storage Operator 可能会安装一个默认的存储类。这个存储类由 Operator 拥有和控制。不能在定义注解和标签之外将其删除或修改。如果需要实现不同的行为，则必须定义自定义存储类。

以下小节描述了 StorageClass 对象的基本定义，以及每个支持的插件类型的具体示例。

7.3.1. 基本 StorageClass 对象定义
复制链接

以下资源显示了用来配置存储类的参数和默认值。这个示例使用 AWS ElasticBlockStore (EBS) 对象定义。

StorageClass 定义示例

kind: StorageClass
1 

apiVersion: storage.k8s.io/v1
2 

metadata:
  name: <storage-class-name>
3 

  annotations:
4 

    storageclass.kubernetes.io/is-default-class: 'true'
    ...
provisioner: kubernetes.io/aws-ebs
5 

parameters:
6 

  type: gp2
...
Copy to Clipboard Toggle word wrap

1
（必需）API 对象类型。
2
（必需）当前的 apiVersion。
3
（必需）存储类的名称。
4
（可选）存储类的注解。
5
（必需）与这个存储类关联的置备程序类型。
6
（可选）特定置备程序所需的参数，这将根据插件的不同而有所不同。

7.3.2. 存储类注解
复制链接

要将存储类设置为集群范围的默认值，请在存储类元数据中添加以下注解： 

storageclass.kubernetes.io/is-default-class: "true"
Copy to Clipboard Toggle word wrap

例如： 

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  annotations:
    storageclass.kubernetes.io/is-default-class: "true"
...
Copy to Clipboard Toggle word wrap

这允许任何没有指定特定存储类的持久性卷声明（PVC）通过默认存储类自动置备。但是，您的集群可以有多个存储类，但只有其中一个是默认存储类。

注意

beta 注解 storageclass.beta.kubernetes.io/is-default-class 当前仍然可用，但将在以后的版本中被删除。

要设置存储类描述，请在存储类元数据中添加以下注解： 

kubernetes.io/description: My Storage Class Description
Copy to Clipboard Toggle word wrap

例如： 

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  annotations:
    kubernetes.io/description: My Storage Class Description
...
Copy to Clipboard Toggle word wrap

7.3.3. RHOSP Cinder 对象定义
复制链接

cinder-storageclass.yaml

kind: StorageClass
apiVersion: storage.k8s.io/v1
metadata:
  name: <storage-class-name>
1 

provisioner: kubernetes.io/cinder
parameters:
  type: fast
2 

  availability: nova
3 

  fsType: ext4
4
Copy to Clipboard Toggle word wrap

1
存储类的名称。持久性卷声明使用此存储类来置备关联的持久性卷。
2
在 Cinder 中创建的卷类型。默认为空。
3
可用区。如果没有指定可用区，则通常会在所有 OpenShift Container Platform 集群有节点的所有活跃区域间轮换选择。
4
在动态部署卷中创建的文件系统。这个值被复制到动态配置的持久性卷的 fstype 字段中，并在第一个挂载卷时创建文件系统。默认值为 ext4。

安装后, OpenStack Manila CSI Driver Operator 和 ManilaDriver 会自动为所有可用 Manila 共享类型创建动态置备所需的存储类。

7.3.5. AWS Elastic Block Store (EBS) 对象定义
复制链接

aws-ebs-storageclass.yaml

kind: StorageClass
apiVersion: storage.k8s.io/v1
metadata:
  name: <storage-class-name>
1 

provisioner: kubernetes.io/aws-ebs
parameters:
  type: io1
2 

  iopsPerGB: "10"
3 

  encrypted: "true"
4 

  kmsKeyId: keyvalue
5 

  fsType: ext4
6
Copy to Clipboard Toggle word wrap

1
（必需）存储类的名称。持久性卷声明使用此存储类来置备关联的持久性卷。
2
（必需）选择 io1、 gp2、 sc1、 st1。默认为 gp2。可用的 Amazon 资源名 (ARN) 值请查看 AWS 文档 。
3
可选：只适用于 io1 卷。每个 GiB 每秒一次 I/O 操作。AWS 卷插件乘以这个值，再乘以请求卷的大小以计算卷的 IOPS。数值上限为 20,000 IOPS，这是 AWS 支持的最大值。详情请查看 AWS 文档 。
4
可选：是否加密 EBS 卷。有效值为 true 或者 false。
5
可选：加密卷时使用的密钥的完整 ARN。如果没有提供任何信息，但 encypted 被设置为 true，则 AWS 会生成一个密钥。有效 ARN 值请查看 AWS 文档 。
6
可选：在动态置备卷中创建的文件系统。这个值被复制到动态配置的持久性卷的 fstype 字段中，并在第一个挂载卷时创建文件系统。默认值为 ext4。

7.3.6. Azure Disk 对象定义
复制链接

azure-advanced-disk-storageclass.yaml

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: <storage-class-name>
1 

provisioner: kubernetes.io/azure-disk
volumeBindingMode: WaitForFirstConsumer
2 

allowVolumeExpansion: true
parameters:
  kind: Managed
3 

  storageaccounttype: Premium_LRS
4 

reclaimPolicy: Delete
Copy to Clipboard Toggle word wrap

1
存储类的名称。持久性卷声明使用此存储类来置备关联的持久性卷。
2
强烈建议使用 WaitForFirstConsumer。这会置备卷，同时允许有足够的存储空间从可用区将 pod 调度到空闲 worker 节点上。
3
可能的值有 Shared （默认）、Managed 和 Dedicated。
重要

红帽仅在存储类中支持使用 kind: Managed。

使用 Shared 和 Dedicated 时，Azure 会创建非受管磁盘，而 OpenShift Container Platform 为机器 OS（root）磁盘创建一个受管磁盘。但是，因为 Azure Disk 不允许在节点上同时使用受管和非受管磁盘，所以使用 Shared 或 Dedicated 创建的非受管磁盘无法附加到 OpenShift Container Platform 节点。

4
Azure 存储帐户 SKU 层。默认为空。请注意，高级虚拟机可以同时附加 Standard_LRS 和 Premium_LRS 磁盘，标准虚拟机只能附加 Standard_LRS 磁盘，受管虚拟机只能附加受管磁盘，非受管虚拟机则只能附加非受管磁盘。
  1. 如果 kind 设为 Shared，Azure 会在与集群相同的资源组中的几个共享存储帐户下创建所有未受管磁盘。
  2. 如果 kind 设为 Managed，Azure 会创建新的受管磁盘。

  3. 如果 kind 设为 Dedicated，并且指定了 StorageAccount，Azure 会将指定的存储帐户用于与集群相同的资源组中新的非受管磁盘。为此，请确保：

    • 指定的存储帐户必须位于同一区域。
    • Azure Cloud Provider 必须具有存储帐户的写入权限。
  4. 如果 kind 设为 Dedicated，并且未指定 StorageAccount，Azure 会在与集群相同的资源组中为新的非受管磁盘创建一个新的专用存储帐户。

7.3.7. Azure File 对象定义
复制链接

Azure File 存储类使用 secret 来存储创建 Azure File 共享所需的 Azure 存储帐户名称和存储帐户密钥。这些权限是在以下流程中创建的。

流程

  1. 定义允许创建和查看 secret 的 ClusterRole 对象： 

    apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
#  name: system:azure-cloud-provider
  name: <persistent-volume-binder-role>
    1 
    
rules:
- apiGroups: ['']
  resources: ['secrets']
  verbs:     ['get','create']
    Copy to Clipboard Toggle word wrap
    1
    要查看并创建 secret 的集群角色名称。

  2. 将集群角色添加到服务帐户： 

    $ oc adm policy add-cluster-role-to-user <persistent-volume-binder-role> system:serviceaccount:kube-system:persistent-volume-binder
    Copy to Clipboard Toggle word wrap

  3. 创建 Azure File StorageClass 对象： 

    kind: StorageClass
apiVersion: storage.k8s.io/v1
metadata:
  name: <azure-file>
    1 
    
provisioner: kubernetes.io/azure-file
parameters:
  location: eastus
    2 
    
  skuName: Standard_LRS
    3 
    
  storageAccount: <storage-account>
    4 
    
reclaimPolicy: Delete
volumeBindingMode: Immediate
    Copy to Clipboard Toggle word wrap
    1
    存储类的名称。持久性卷声明使用此存储类来置备关联的持久性卷。
    2
    Azure 存储帐户的位置，如 eastus。默认为空，表示将在 OpenShift Container Platform 集群的位置创建新的 Azure 存储帐户。
    3
    Azure 存储帐户的 SKU 层，如 Standard_LRS。默认为空，表示将使用 Standard_LRS SKU 创建新的 Azure 存储帐户。
    4
    Azure 存储帐户的名称。如果提供了存储帐户，则忽略 skuName 和 location。如果没有提供存储帐户，则存储类会为任何与定义的 skuName 和 location 匹配的帐户搜索与资源组关联的存储帐户。

7.3.7.1. 使用 Azure File 时的注意事项
复制链接

默认 Azure File 存储类不支持以下文件系统功能：

  • 符号链接
  • 硬链接
  • 扩展属性
  • 稀疏文件
  • 命名管道

另外，Azure File 挂载目录的所有者用户标识符 (UID) 与容器的进程 UID 不同。可在 StorageClass 对象中指定 uid 挂载选项来定义用于挂载的目录的特定用户标识符。

以下 StorageClass 对象演示了修改用户和组标识符，以及为挂载的目录启用符号链接。 

kind: StorageClass
apiVersion: storage.k8s.io/v1
metadata:
  name: azure-file
mountOptions:
  - uid=1500
1 

  - gid=1500
2 

  - mfsymlinks
3 

provisioner: kubernetes.io/azure-file
parameters:
  location: eastus
  skuName: Standard_LRS
reclaimPolicy: Delete
volumeBindingMode: Immediate
Copy to Clipboard Toggle word wrap
1
指定用于挂载的目录的用户标识符。
2
指定用于挂载的目录的组标识符。
3
启用符号链接。

7.3.8. GCE PersistentDisk (gcePD) 对象定义
复制链接

gce-pd-storageclass.yaml

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: <storage-class-name>
1 

provisioner: kubernetes.io/gce-pd
parameters:
  type: pd-standard
2 

  replication-type: none
volumeBindingMode: WaitForFirstConsumer
allowVolumeExpansion: true
reclaimPolicy: Delete
Copy to Clipboard Toggle word wrap

1
存储类的名称。持久性卷声明使用此存储类来置备关联的持久性卷。
2
选择 pd-standard 或 pd-ssd。默认为 pd-standard。

7.3.9. VMware vSphere 对象定义
复制链接

vsphere-storageclass.yaml

kind: StorageClass
apiVersion: storage.k8s.io/v1
metadata:
  name: <storage-class-name>
1 

provisioner: kubernetes.io/vsphere-volume
2 

parameters:
  diskformat: thin
3
Copy to Clipboard Toggle word wrap

1
存储类的名称。持久性卷声明使用此存储类来置备关联的持久性卷。
2
有关在 OpenShift Container Platform 中使用 VMware vSphere 的详情，请参阅 VMware vSphere 文档。
3
diskformat：thin、zeroedthick 和 eagerzeroedthick 都是有效的磁盘格式。如需有关磁盘格式类型的更多详情，请参阅 vSphere 文档。默认值为 thin。
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2025 Red Hat