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

8.3. 定义存储类

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

重要

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

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

8.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: gp3
...
Copy to Clipboard Toggle word wrap

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

8.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

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

aws-ebs-storageclass.yaml

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

provisioner: ebs.csi.aws.com
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, gp3, sc1, st1 选择。默认值为 gp3。可用的 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。

8.3.4. 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-ssd
2 

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

1
存储类的名称。持久性卷声明使用此存储类来置备关联的持久性卷。
2
选择 pd-ssd、pd-standard 或 hyperdisk-balanced。默认为 pd-ssd。
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2025 Red Hat