建立部署

建立 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

在規格 meta 資料標籤區段中，輸入您新增至有狀態集 YAML 的 spec.selector.matchLabels 區段的相同標籤。

terminationGracePeriodSeconds

請輸入秒數，以讓 kubelet 有足夠時間安全地終止執行您的有狀態集複本的 Pod。 如需相關資訊，請參閱 刪除 Pod。

VolumeClaimTemplates.name

在規格磁區要求範本 meta 資料區段中，輸入磁區的名稱。 請使用您在「spec.containers.volumeMount.name」區段中定義的相同名稱。 您在此處輸入的名稱將用於建立您的 PVC 名稱，格式為：<volume_name>-<statefulset_name>-<replica_number>。

ibm.io/auto-create-bucket

在規格磁區要求範本 meta 資料區段中，設定註釋以配置如何建立儲存區。 請從下列選項中進行選擇：

• true： 選擇此選項，系統會為每個有狀態集（stateful set）的複本自動建立一個儲存桶。 請注意，服務認證必須具有 Writer 許可權才能自動建立儲存區。
• false： 若要讓狀態集的各複本共用現有的儲存桶，請選擇此選項。 請務必在您的有狀態集 (StatefulSet) YAML 檔案中，於 spec.volumeClaimTemplates.metadata.annotions.ibm.io/bucket 區段內定義儲存桶的名稱。

ibm.io/auto-delete-bucket

在規格磁區要求範本 meta 資料區段中，設定註釋以配置如何刪除儲存區。 請從下列選項中進行選擇：

• 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

在規格磁區要求範本 meta 資料區段中，設定儲存區詳細資料的註釋。 請從下列選項中進行選擇：

• 若將 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

在規格磁區要求範本 meta 資料註釋區段中，輸入密鑰名稱，該密鑰會保留您先前建立的 IBM Cloud Object Storage 認證。 如果您將 IBM Cloud Object Storage 認證 新增至預設儲存類別，則不得列出 PVC 中的密鑰。

kubernetes.io/storage-class

在規格磁區要求範本 meta 資料註釋區段中，輸入您要使用的儲存類別。 請從下列選項中進行選擇：

• 若為 ibm.io/auto-create-bucket: "true"：請輸入您要為新儲存桶使用的儲存類別。
• 若為 ibm.io/auto-create-bucket: "false"：請輸入您用來建立現有儲存桶的儲存類別。

若要列出現有的儲存類別，請執行 oc get sc | grep s3。 若未指定儲存類別，該 PVC 將採用叢集中設定的預設儲存類別進行建立。 請確保預設儲存類別使用「ibm.io/ibmc-s3fs」配置程式，以便您的有狀態集能透過物件儲存進行配置。

storageClassName

在規格磁區要求範本規格區段中，輸入您在有狀態集 YAML 的 spec.volumeClaimTemplates.metadata.annotations.volume.beta.kubernetes.io/storage-class 區段中輸入的相同儲存空間類別。

storage

在規格磁區要求範本規格資源要求區段中，輸入 IBM Cloud Object Storage 儲存區的虛構大小 (GB)。 Kubernetes 需要大小，但 IBM Cloud Object Storage 中不需要。 您可以輸入任何想要的大小。 您在 IBM Cloud Object Storage 上實際使用的空間可能有所不同，並將根據 定價表進行計費。