创建部署

创建 PVC 和部署配置文件后，在集群中创建部署。

1. 创建部署。

   oc apply -f <local_yaml_path>
   

2. 验证 PV 是否已成功安装。

   oc describe deployment <deployment_name>
   

   安装点位于 Volume Mounts 字段中，卷位于 Volumes 字段中。

   Volume Mounts:
         /var/run/secrets/kubernetes.io/serviceaccount from default-token-tqp61 (ro)
         /volumemount from myvol (rw)
   ...
   Volumes:
       myvol:
       Type:    PersistentVolumeClaim (a reference to a PersistentVolumeClaim in the same namespace)
       ClaimName:    mypvc
       ReadOnly:    false
   

3. 通过登录到应用程序 pod 并写入数据，验证是否可以将数据写入 IBM Cloud Object Storage 服务实例。 登录到安装 PV 的 pod。

   oc exec <pod_name> -it bash
   

4. 浏览到在应用程序部署中定义的卷安装路径。

5. 创建文本文件。

   echo "This is a test" > test.txt
   

6. 在 IBM Cloud 控制台中，导航至您的 IBM Cloud Object Storage 服务实例。

7. 在菜单中，选择存储区。

8. 打开存储区，并验证是否可以看到所创建的 test.txt。

在有状态集内使用对象存储器

如果您有一个有状态的应用程序（如数据库），那么可以创建有状态集，以使用 IBM Cloud Object Storage 来存储应用程序的数据。 或者，可以使用 IBM Cloud 数据库即服务（例如，IBM Cloudant），并将数据存储在云中。

开始之前，请先完成本主题开头列出的先决条件步骤。

部署使用对象存储器的有状态集：

1. 为有状态集和用于公开有状态集的服务创建配置文件。 以下示例显示了如何将 NGINX 部署为有 3 个副本的有状态集，其中每个副本使用单独的存储区，或者所有副本共享同一存储区。

   以下示例演示了如何创建一个包含三个副本的有状态集，每个副本使用一个独立的存储桶。

   apiVersion: v1
   kind: Service
   metadata:
     name: nginx-v01
     namespace: default
     labels:
       app: nginx-v01 # must match spec.template.metadata.labels and spec.selector.matchLabels in stateful set YAML
   spec:
     ports:
     - port: 80
       name: web
     clusterIP: None
     selector:
       app: nginx-v01 # must match spec.template.metadata.labels and spec.selector.matchLabels in stateful set YAML
   ---
   apiVersion: apps/v1
   kind: StatefulSet
   metadata:
     name: web-v01
     namespace: default
   spec:
     selector:
       matchLabels:
         app: nginx-v01 # must match spec.template.metadata.labels in stateful set YAML and metadata.labels in service YAML
     serviceName: "nginx-v01"
     replicas: 3
     template:
       metadata:
         labels:
           app: nginx-v01 # must match spec.selector.matchLabels in stateful set YAML and metadata.labels in service YAML
       spec:
         terminationGracePeriodSeconds: 10
         containers:
         - name: nginx
           image: registry.k8s.io/nginx-slim:0.8
           ports:
           - containerPort: 80
             name: web
           volumeMounts:
           - name: mypvc
             mountPath: /usr/share/nginx/html
     volumeClaimTemplates:
     - metadata:
         name: mypvc
         annotations:
           ibm.io/auto-create-bucket: "true"
           ibm.io/auto-delete-bucket: "true"
           ibm.io/bucket: ""
           ibm.io/secret-name: mysecret
           volume.beta.kubernetes.io/storage-class: ibmc-s3fs-standard-perf-cross-region
           volume.beta.kubernetes.io/storage-provisioner: ibm.io/ibmc-s3fs
       spec:
         accessModes: [ "ReadWriteOnce" ]
         storageClassName: "ibmc-s3fs-standard-perf-cross-region"
         resources:
           requests:
             storage: 1Gi
   

   以下示例演示了如何创建一个包含三个副本且共享同一存储桶 mybucket 的有状态集。

   apiVersion: v1
   kind: Service
   metadata:
     name: nginx-v01
     namespace: default
     labels:
       app: nginx-v01 # must match spec.template.metadata.labels and spec.selector.matchLabels in stateful set YAML
   spec:
     ports:
     - port: 80
       name: web
     clusterIP: None
     selector:
       app: nginx-v01 # must match spec.template.metadata.labels and spec.selector.matchLabels in stateful set YAML
   ---
   apiVersion: apps/v1
   kind: StatefulSet
   metadata:
     name: web-v01
     namespace: default
   spec:
     selector:
       matchLabels:
         app: nginx-v01 # must match spec.template.metadata.labels in stateful set YAML and metadata.labels in service YAML
     serviceName: "nginx-v01"
     replicas: 3
     template:
       metadata:
         labels:
           app: nginx-v01 # must match spec.selector.matchLabels in stateful set YAML and metadata.labels in service YAML
       spec:
         terminationGracePeriodSeconds: 10
         containers:
         - name: nginx
           image: registry.k8s.io/nginx-slim:0.8
           ports:
           - containerPort: 80
             name: web
           volumeMounts:
           - name: mypvc
             mountPath: /usr/share/nginx/html
     volumeClaimTemplates:
     - metadata:
         name: mypvc
         annotations:
           ibm.io/auto-create-bucket: "false"
           ibm.io/auto-delete-bucket: "false"
           ibm.io/bucket: mybucket
           ibm.io/secret-name: mysecret
           volume.beta.kubernetes.io/storage-class: ibmc-s3fs-standard-perf-cross-region
           volume.beta.kubernetes.io/storage-provisioner: ibm.io/ibmc-s3fs
       spec:
         accessModes: [ "ReadOnlyMany" ]
         storageClassName: "ibmc-s3fs-standard-perf-cross-region"
         resources:
           requests:
             storage: 1Gi
   

name

输入有状态集的名称。 您输入的名称将用于为您的 PVC 生成名称，格式为：<volume_name>-< statefulset_name>-<replica_number>。

serviceName

输入要用于公开有状态集的服务的名称。

replicas

输入有状态集的副本数。

matchLabels

在“规范选择器匹配标签”部分中，输入要包含在有状态集和 PVC 中的所有标签。 您在有状态集合（stateful set）的 volumeClaimTemplates 中包含的标签不会被 Kubernetes 识别。 相反，您必须在有状态集群（stateful set）的 YAML 文件中，于 spec.selector.matchLabels 和 spec.template.metadata.labels 部分定义这些标签。 为确保所有有状态集（stateful set）的副本都纳入服务的负载均衡范围，请添加与服务 YAML 文件中 spec.selector 部分所用标签相同的标签。

labels

在“规范元数据标签”部分中，输入添加到有状态集 YAML 的 spec.selector.matchLabels 部分的相同标签。

terminationGracePeriodSeconds

请输入秒数，以便为 kubelet 分配足够的时间，以安全地终止运行您的有状态集副本的Pod。 有关更多信息，请参阅 删除 Pod。

VolumeClaimTemplates.name

在规范卷声明模板元数据部分中，输入卷的名称。 请使用您在“spec.containers.volumeMount.name”部分中定义的名称。 您在此处输入的名称将用于为您的 PVC 生成名称，格式为：<volume_name>-<statefulset_name>-<replica_number>。

ibm.io/auto-create-bucket

在规范卷声明模板元数据部分中，设置注释以配置如何创建存储区。 在以下选项之间进行选择：

• true： 选择此选项可为每个有状态集副本自动创建一个存储桶。 请注意，服务凭证必须具有 Writer 许可权才能自动创建存储区。
• false： 若要让有状态集的各个副本共享一个现有的存储桶，请选择此选项。 请务必在有状态集（StatefulSet）的 YAML 文件中，于 spec.volumeClaimTemplates.metadata.annotions.ibm.io/bucket 部分定义存储桶的名称。

ibm.io/auto-delete-bucket

在规范卷声明模板元数据部分中，设置注释以配置如何删除存储区。 在以下选项之间进行选择：

• true： 删除 PVC 时，您的数据、存储桶和 PV 将被自动删除。 IBM Cloud Object Storage 服务实例会保留而不删除。 如果您选择将此选项设置为 true，则必须设置 ibm.io/auto-create-bucket: true 和 ibm.io/bucket: ""，以便您的存储桶在自动创建时采用 tmp-s3fs-xxxx 格式的名称。
• false： 删除 PVC 时，PV 会自动被删除，但您在 IBM Cloud Object Storage 服务实例中的数据和存储桶仍会保留。 要访问数据，必须使用现有存储区的名称来创建新的 PVC。

ibm.io/bucket

在规范卷声明模板元数据部分中，设置存储区详细信息的注释。 在以下选项之间进行选择：

• 如果将 ibm.io/auto-create-bucket 设置为 true ：请在 IBM Cloud Object Storage 中输入要创建的存储桶名称。 此外，如果将“ibm.io/auto-delete-bucket”设置为“true”，则必须将此字段留空，系统才会自动为您的存储桶分配一个格式为“tmp-s3fs-xxxx”的名称。 该名称在 IBM Cloud Object Storage 中必须唯一。
• 如果将 ibm.io/auto-create-bucket 设置为 false ：请输入您要在集群中访问的现有存储桶的名称。

ibm.io/secret-name

在规范卷声明模板元数据注释部分中，输入保存先前创建的 IBM Cloud Object Storage 凭证的私钥的名称。 如果将 IBM Cloud Object Storage 凭证 添加到缺省存储类，那么不得在 PVC 中列出私钥。

kubernetes.io/storage-class

在“规范卷声明模板元数据注释”部分中，输入要使用的存储类。 在以下选项之间进行选择：

• 如果 ibm.io/auto-create-bucket: "true"：请输入您希望为新存储桶使用的存储类。
• 如果 ibm.io/auto-create-bucket: "false"：请输入您用于创建现有存储桶的存储类。

要列出现有的存储类，请运行 oc get sc | grep s3。 如果您未指定存储类，则该 PVC 将使用集群中设置的默认存储类进行创建。 请确保默认存储类使用 ibm.io/ibmc-s3fs 配置程序，以便您的有状态集群通过对象存储进行配置。

storageClassName

在 spec 卷声明模板 spec 部分中，输入您在有状态集 YAML 的 spec.volumeClaimTemplates.metadata.annotations.volume.beta.kubernetes.io/storage-class 部分中输入的相同存储类。

storage

在“规范卷声明模板规范资源请求”部分中，输入 IBM Cloud Object Storage 存储区的虚构大小 (以千兆字节为单位)。 Kubernetes 需要此大小，但在 IBM Cloud Object Storage 中并不考虑此大小。 所以您可以输入所需的任意大小。 您在 IBM Cloud Object Storage 上实际使用的空间可能有所不同，具体费用将根据 价格表进行结算。