デプロイメントの作成

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. アプリ・ポッドにログインしてデータを書き込むことで、IBM Cloud Object Storage サービス・インスタンスにデータを書き込めることを確認します。 PV をマウントするポッドにログインします。

   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 Database as a Service (IBM Cloudant など) を使用し、クラウドにデータを保管することもできます。

始める前に

• IBM Cloud Object Storage サービス・インスタンスを作成して準備します。
• IBM Cloud Object Storage サービス資格情報を保管するシークレットを作成します。
• IBM Cloud Object Storage の構成を決定します。

オブジェクト・ストレージを使用するステートフル・セットをデプロイするには、以下のようにします。

1. ステートフル・セットと、そのステートフル・セットを公開するために使用するサービスに関する、構成ファイルを作成します。 次の例は、3 つのレプリカからなるステートフル・セットとして 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 という 1 つのバケットを共有する、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: "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

ステートフル・セットに対する名前を入力します。 入力した名前は、<volume_name>-< statefulset_name>-<replica_number>という形式で PVC の名前を作成するために使用されます。

serviceName

ステートフル・セットを公開するために使用するサービスの名前を入力します。

replicas

ステートフル・セットのレプリカの数を入力します。

matchLabels

spec の selector の matchLabels セクションで、ステートフル・セットと PVC に含めるすべてのラベルを入力します。 ステートフル・セットの volumeClaimTemplates に含めたラベルは、Kubernetes によって認識されません。 代わりに、それらのラベルをステートフル・セット YAML の spec.selector.matchLabels および spec.template.metadata.labels セクションで定義する必要があります。 すべてのステートフル・セット・レプリカが、サービスのロード・バランシングに含まれるようにするには、サービス YAML のspec.selectorセクションで使用したラベルと同じラベルを含めます。

labels

spec の metadata の labels セクションで、ステートフル・セット YAML の spec.selector.matchLabels セクションに追加したラベルと同じラベルを入力します。

terminationGracePeriodSeconds

ステートフルセットレプリカを実行するポッドを安全に終了させるために、 kubelet に与える秒数を入力します。 詳しくは、 ポッドの削除を参照してください。

VolumeClaimTemplates.name

spec の volumeClaimTemplates の metadata セクションで、ボリュームの名前を入力します。 spec.containers.volumeMount.name セクションで定義した名前と同じ名前を使用します。 ここに入力する名前は、<volume_name>-<statefulset_name>-<replica_number>という形式で PVC の名前を作成するために使用されます。

ibm.io/auto-create-bucket

spec の volumeClaimTemplates の metadata セクションで、アノテーションを設定してバケットの作成方法を構成します。 次のいずれかのオプションを選択します。

• **true: **ステートフル・セット・レプリカごとにバケットを自動的に作成するには、このオプションを選択します。 サービス資格情報には、バケットを自動的に作成するための Writer 権限が必要です。
• **false: **既存のバケットの 1 つをステートフル・セット・レプリカ間で共有する場合は、このオプションを選択します。 ステートフル・セット YAML の spec.volumeClaimTemplates.metadata.annotions.ibm.io/bucket セクションでバケットの名前を定義してください。

ibm.io/auto-delete-bucket

spec の volumeClaimTemplates の metadata セクションで、アノテーションを設定してバケットの削除方法を構成します。 次のいずれかのオプションを選択します。

• **true: **データ、バケット、および PV が、PVC の削除時に自動的に削除されます。 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

spec の volumeClaimTemplates の metadata セクションで、バケットの詳細についてのアノテーションを設定します。 次のいずれかのオプションを選択します。

• 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

spec volume claim templates metadata annotations セクションで、以前に作成した IBM Cloud Object Storage 資格情報を保持するシークレットの名前を入力します。 IBM Cloud Object Storage 資格情報 をデフォルトのストレージ・クラスに追加する場合は、PVC で機密事項をリストしないでください。

kubernetes.io/storage-class

spec の volumeClaimTemplates の metadata の annotations セクションで、使用するストレージ・クラスを入力します。 次のいずれかのオプションを選択します。

• ibm.io/auto-create-bucket: "true"の場合: 新規バケットに使用するストレージ・クラスを入力します。
• ibm.io/auto-create-bucket: "false"の場合: 既存のバケットを作成するために使用したストレージ・クラスを入力します。

既存のストレージ・クラスを一覧表示するには、kubectl get sc | grep s3 を実行する。 ストレージ・クラスを指定しない場合、クラスターに設定されているデフォルトのストレージ・クラスを使用して PVC が作成されます。 オブジェクト・ストレージを使用してステートフル・セットがプロビジョンされるようにするために、デフォルト・ストレージ・クラスで ibm.io/ibmc-s3fs プロビジョナーが使用されていることを確認してください。

storageClassName

spec の volumeClaimTemplates の spec セクションで、ステートフル・セット YAML の spec.volumeClaimTemplates.metadata.annotations.volume.beta.kubernetes.io/storage-class セクションに入力したストレージ・クラスを入力します。

storage

spec の volumeClaimTemplates の resources の requests セクションで、ご使用の IBM Cloud Object Storage バケットの架空のサイズ (ギガバイト単位) を入力します。 このサイズは Kubernetes で必要になりますが、IBM Cloud Object Storage では考慮されません。 希望するサイズを入力できます。 IBM Cloud Object Storage、実際に使用するスペースは異なる場合があり、 料金表に基づいて請求されます。