4.3. 定义 StorageClass

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

重要

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

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

4.3.1. 基本 StorageClass 对象定义

以下介绍了用来配置一个 StorageClass 所需的参数和默认值。这个示例使用 AWS ElasticBlockStore (EBS) 对象定义。

StorageClass 定义示例

kind: StorageClass 1
apiVersion: storage.k8s.io/v1 2
metadata:
  name: gp2 3
  annotations: 4
    storageclass.kubernetes.io/is-default-class: 'true'
    ...
provisioner: kubernetes.io/aws-ebs 5
parameters: 6
  type: gp2
...

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

4.3.2. StorageClass 注解（annotations）

如需把一个 StorageClass 设置为默认在集群范内有效，把以下注解添加到 StorageClass 的元数据中： 

storageclass.kubernetes.io/is-default-class: "true"

例如： 

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  annotations:
    storageclass.kubernetes.io/is-default-class: "true"
...

这将使任何没有指定特定卷的 PVC 通过默认的 StorageClass 被自动置备。

注意

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

如需设置一个 StorageClass 的描述，把以下注解添加到 StorageClass 的元数据中： 

kubernetes.io/description: My StorageClass Description

例如： 

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  annotations:
    kubernetes.io/description: My StorageClass Description
...

4.3.3. OpenStack Cinder 对象定义

cinder-storageclass.yaml

kind: StorageClass
apiVersion: storage.k8s.io/v1
metadata:
  name: gold
provisioner: kubernetes.io/cinder
parameters:
  type: fast  1
  availability: nova 2
  fsType: ext4 3

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

4.3.4. AWS Elastic Block Store (EBS) 对象定义

aws-ebs-storageclass.yaml

kind: StorageClass
apiVersion: storage.k8s.io/v1
metadata:
  name: slow
provisioner: kubernetes.io/aws-ebs
parameters:
  type: io1 1
  iopsPerGB: "10" 2
  encrypted: "true" 3
  kmsKeyId: keyvalue 4
  fsType: ext4 5

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

4.3.5. Azure Disk 对象定义

azure-advanced-disk-storageclass.yaml

kind: StorageClass
apiVersion: storage.k8s.io/v1
metadata:
  name: slow
provisioner: kubernetes.io/azure-disk
parameters:
  storageAccount: azure_storage_account_name  1
  storageaccounttype: Standard_LRS  2
  kind: Dedicated  3

1
Azure 存储帐户名称。这必须与集群位于同一个资源组中。如果指定了存储帐户，则忽略 location。如果没有指定存储帐户，则在与集群相同的资源组中创建一个新的存储帐户。如果您要指定 StorageAccount，则 kind 的值必须是 Dedicated。
2
Azure 存储帐户 SKU 层。默认为空。请注意，高级虚拟机可以同时附加 Standard_LRS 和 Premium_LRS 磁盘，标准虚拟机只能附加 Standard_LRS 磁盘，受管虚拟机只能附加受管磁盘，非受管虚拟机则只能附加非受管磁盘。
3
可能的值有 Shared（默认）、Dedicated 和 Managed。
  1. 如果 kind 设为 Shared，Azure 会在与集群相同的资源组中的几个共享存储帐户下创建所有未受管磁盘。
  2. 如果 kind 设为 Managed，Azure 会创建新的受管磁盘。

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

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

4.3.6. Azure File 对象定义

Azure File StorageClass 使用 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']
    1
    要查看并创建 Secret 的 ClusterRole 名称。

  2. 将 ClusterRole 添加到 ServiceAccount： 

    $ oc adm policy add-cluster-role-to-user <persistent-volume-binder-role> system:serviceaccount:kube-system:persistent-volume-binder

  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
    1
    StorageClass 的名称。PersistentVolumeClaim 使用这个 StorageClass 来置备相关的 PersistentVolume。
    2
    Azure 存储帐户的位置，如 eastus。默认为空，表示将在 OpenShift Container Platform 集群的位置创建新的 Azure 存储帐户。
    3
    Azure 存储帐户的 SKU 层，如 Standard_LRS。默认为空，表示将使用 Standard_LRS SKU 创建新的 Azure 存储帐户。
    4
    Azure 存储帐户的名称。如果提供了存储帐户，则忽略 skuName 和 location。如果没有提供存储帐户，则 StorageClass 会为任何与定义的 skuName 和 location 匹配的帐户搜索与资源组关联的存储帐户。

4.3.6.1. 使用 Azure File 时的注意事项

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

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

另外，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
1
指定用于挂载的目录的用户标识符。
2
指定用于挂载的目录的组标识符。
3
启用符号链接。

4.3.7. GCE PersistentDisk (gcePD) 对象定义

gce-pd-storageclass.yaml

kind: StorageClass
apiVersion: storage.k8s.io/v1
metadata:
  name: slow
provisioner: kubernetes.io/gce-pd
parameters:
  type: pd-standard  1
  replication-type: none

1
选择 pd-standard 或 pd-ssd。默认为 pd-ssd。

4.3.8. VMware vSphere 对象定义

vsphere-storageclass.yaml

kind: StorageClass
apiVersion: storage.k8s.io/v1
metadata:
  name: slow
provisioner: kubernetes.io/vsphere-volume 1
parameters:
  diskformat: thin 2

1
有关在 OpenShift Container Platform 中使用 VMware vSphere 的详情，请参阅 VMware vSphere 文档。
2
diskformat：thin、zeroedthick 和 eagerzeroedthick 都是有效的磁盘格式。如需有关磁盘格式类型的更多详情，请参阅 vSphere 文档。默认值为 thin。

4.3.9. Red Hat OpenShift Container Storage 对象定义

使用 Red Hat OpenShift Container Storage 时，当从 Operator Hub 部署 Red Hat OpenShift Container Storage 4.2 时，会创建动态卷置备的存储类，如 验证是否创建并列出了存储类所述。