创建部署

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

1. 创建部署。

   kubectl apply -f <local_yaml_path>
   

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

   kubectl 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。

   kubectl 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），并将数据存储在云中。

开始之前：

• 创建并准备 IBM Cloud Object Storage 服务实例。
• 创建私钥以存储 IBM Cloud Object Storage 服务凭证。
• 决定 IBM Cloud Object Storage 的配置。

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

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: k8s.gcr.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: k8s.gcr.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 中的所有标签。 volumeClaimTemplates 中包含的标签不会被 Kubernetes 识别。 相反，您必须在有状态数据集 YAML 的 spec.selector.matchLabels 和 spec.template.metadata.labels 部分定义这些标签。 要确保所有有状态集副本都进入了服务的负载平衡，请在服务 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

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

• 真： 选择此选项可为每个有状态数据集副本自动创建一个数据桶。 请注意，服务凭证必须具有 Writer 许可权才能自动创建存储区。
• 假： 如果想在有状态数据集副本中共享现有的数据桶，请选择此选项。 确保在有状态设置 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。
• 错误： 当您删除 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"：输入您用来创建现有水桶的存储类别。

要列出现有存储类，请运行 kubectl 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 中实际使用的空间可能不同，并根据 定价表计费。