手順

1. Storage → StorageClasses をクリックします。
2. Create Storage Class をクリックします。
3. ストレージクラスの Name および Description を入力します。

4. Reclaim Policy は、デフォルトオプションとして Delete に設定されています。この設定を使用します。

   回収ポリシーをストレージクラスで Retain に変更すると、永続ボリューム要求 (PVC) を削除した後でも、永続ボリューム (PV) はReleased状態のままになります。

5. ボリュームバインディングモードは、デフォルトオプションとしてWaitForConsumerに設定されています。

   Immediate オプションを選択すると、PVC の作成時に PV がすぐに作成されます。

6. 永続ボリュームをプロビジョニングするために使用されるプラグインである RBD Provisioner を選択します。

7. 一覧から既存の ストレージプール を選択するか、新規プールを作成します。

   注記

   双方向レプリケーションデータ保護ポリシーの使用は、デフォルトプールではサポートされていません。ただし、追加のプールを作成する場合は、双方向レプリケーションを使用できます。

   新規プールの作成

   1. Create New Pool をクリックします。
   2. Pool name を入力します。
   3. Data Protection Policy として 2-way-Replication または 3-way-Replication を選択します。

   4. データを圧縮する必要がある場合は、Enable compression を選択します。

      圧縮を有効にするとアプリケーションのパフォーマンスに影響がある可能性があり、書き込まれるデータがすでに圧縮または暗号化されている場合は効果的ではない可能性があります。圧縮を有効にする前に書き込まれたデータは圧縮されません。

   5. Create をクリックして新規ストレージプールを作成します。
   6. プールの作成後に Finish をクリックします。

8. オプション:Enable Encryption チェックボックスを選択します。
9. Create をクリックしてストレージクラスを作成します。

手順

1. Storage → Data Foundation をクリックします。
2. Storage systems タブでストレージシステムを選択し、BlockPools タブをクリックします。
3. Create Block Pool をクリックします。

4. Pool name を入力します。

   注記

   双方向レプリケーションデータ保護ポリシーの使用は、デフォルトプールではサポートされていません。ただし、追加のプールを作成する場合は、双方向レプリケーションを使用できます。

5. Data protection policy を 2-way Replication または 3-way Replication のいずれかとして選択します。
6. Volume Type を選択します。

7. オプション:データを圧縮する必要がある場合は、Enable compression チェックボックスを選択します。

   圧縮を有効にするとアプリケーションのパフォーマンスに影響がある可能性があり、書き込まれるデータがすでに圧縮または暗号化されている場合は効果的ではない可能性があります。圧縮を有効にする前に書き込まれたデータは圧縮されません。

8. Create をクリックします。

手順

1. Storage → Data Foundation をクリックします。
2. Storage systems タブでストレージシステムを選択し、BlockPools をクリックします。
3. 更新するプールの末尾でアクションメニュー (⋮) をクリックします。
4. Edit Block Pool をクリックします。

5. 以下のようにフォームの詳細を変更します。

   注記

   双方向レプリケーションデータ保護ポリシーの使用は、デフォルトプールではサポートされていません。ただし、追加のプールを作成する場合は、双方向レプリケーションを使用できます。

   1. Data protection policy を 2-way Replication または 3-way Replication のいずれかに変更します。

   2. 圧縮オプションを有効または無効にします。

      圧縮を有効にするとアプリケーションのパフォーマンスに影響がある可能性があり、書き込まれるデータがすでに圧縮または暗号化されている場合は効果的ではない可能性があります。圧縮を有効にする前に書き込まれたデータは圧縮されません。

6. Save をクリックします。

手順

1. .Storage → Data Foundation をクリックします。
2. Storage systems タブでストレージシステムを選択し、BlockPools タブをクリックします。
3. 削除するプールの末尾でアクションメニュー (⋮) をクリックします。
4. Delete Block Pool をクリックします。
5. Delete をクリックしてプールの削除を確認します。

手順

1. 使用するイメージレジストリーの Persistent Volume Claim(永続ボリューム要求、PVC) を作成します。

   1. OpenShift Web コンソールで、Storage → Persistent Volume Claims をクリックします。
   2. Project を openshift-image-registry に設定します。

   3. Create Persistent Volume Claim をクリックします。

      1. 上記で取得した利用可能なストレージクラスリストから、プロビジョナー openshift-storage.cephfs.csi.ceph.com で Storage Class を指定します。
      2. Persistent Volume Claim(永続ボリューム要求、PVC) の Name を指定します (例: ocs4registry)。
      3. Shared Access (RWX) の Access Mode を指定します。
      4. 100 GB 以上の Size を指定します。

      5. Create をクリックします。

         新規 Persistent Volume Claim(永続ボリューム要求、PVC) のステータスが Bound としてリスト表示されるまで待機します。

2. クラスターのイメージレジストリーを、新規の Persistent Volume Claim(永続ボリューム要求、PVC) を使用するように設定します。

   1. Administration → Custom Resource Definitions をクリックします。
   2. imageregistry.operator.openshift.io グループに関連付けられた Config カスタムリソース定義をクリックします。
   3. Instances タブをクリックします。
   4. クラスターインスタンスの横にある Action メニュー (⋮) → Edit Config をクリックします。

   5. イメージレジストリーの新規 Persistent Volume Claim(永続ボリューム要求、PVC) を追加します。

      1. 以下を spec: の下に追加し、必要に応じて既存の storage: セクションを置き換えます。

           storage:
             pvc:
               claim: <new-pvc-name>

         以下に例を示します。

           storage:
             pvc:
               claim: ocs4registry

      2. Save をクリックします。

3. 新しい設定が使用されていることを確認します。

   1. Workloads → Pods をクリックします。
   2. Project を openshift-image-registry に設定します。
   3. 新規 image-registry-* Pod が Running のステータスと共に表示され、以前の image-registry-* Pod が終了していることを確認します。
   4. 新規の image-registry-* Pod をクリックし、Pod の詳細を表示します。
   5. Volumes までスクロールダウンし、registry-storage ボリュームに新規 Persistent Volume Claim (永続ボリューム要求、PVC) に一致する Type があることを確認します (例: ocs4registry)。

手順

1. OpenShift Web コンソールで、Workloads → Config Maps に移動します。
2. Project ドロップダウンを openshift-monitoring に設定します。
3. Create Config Map をクリックします。

4. 以下の例を使用して新規の cluster-monitoring-config Config Map を定義します。

   山括弧 (<、>) 内の内容を独自の値に置き換えます (例: retention: 24h または storage:40Gi)。

   storageClassName、をプロビジョナー openshift-storage.rbd.csi.ceph.com を使用する storageclass に置き換えます。以下の例では、storageclass の名前は ocs-storagecluster-ceph-rbd です。

   cluster-monitoring-config Config Map の例

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: cluster-monitoring-config
     namespace: openshift-monitoring
   data:
     config.yaml: |
         prometheusK8s:
           retention: <time to retain monitoring files, e.g. 24h>
           volumeClaimTemplate:
             metadata:
               name: ocs-prometheus-claim
             spec:
               storageClassName: ocs-storagecluster-ceph-rbd
               resources:
                 requests:
                   storage: <size of claim, e.g. 40Gi>
         alertmanagerMain:
           volumeClaimTemplate:
             metadata:
               name: ocs-alertmanager-claim
             spec:
               storageClassName: ocs-storagecluster-ceph-rbd
               resources:
                 requests:
                   storage: <size of claim, e.g. 40Gi>

5. Create をクリックして、設定マップを保存し、作成します。

検証手順

1. Persistent Volume Claim (永続ボリューム要求、PVC) が Pod にバインドされていることを確認します。

   1. Storage → Persistent Volume Claims に移動します。
   2. Project ドロップダウンを openshift-monitoring に設定します。

   3. 5 つの Persistent Volume Claim(永続ボリューム要求、PVC) が Bound (バインド) の状態で表示され、3 つの alertmanager-main-* Pod および 2 つの prometheus-k8s-* Pod に割り当てられていることを確認します。

      図4.1 作成済みのバインドされているストレージのモニタリング

      

2. 新規の alertmanager-main-* Pod が Running 状態で表示されることを確認します。

   1. Workloads → Pods に移動します。
   2. 新規の alertmanager-main-* Pod をクリックし、Pod の詳細を表示します。

   3. Volumes にスクロールダウンし、ボリュームに新規 Persistent Volume Claim(永続ボリューム要求、PVC) のいずれかに一致する Type ocs-alertmanager-claim があることを確認します (例: ocs-alertmanager-claim-alertmanager-main-0)。

      図4.2 alertmanager-main-* Pod に割り当てられた Persistent Volume Claim(永続ボリューム要求、PVC)

      

3. 新規 prometheus-k8s-* Pod が Running 状態で表示されることを確認します。

   1. 新規 prometheus-k8s-* Pod をクリックし、Pod の詳細を表示します。

   2. Volumes までスクロールダウンし、ボリュームに新規の Persistent Volume Claim (永続ボリューム要求、PVC) のいずれかに一致する Type ocs-prometheus-claim があることを確認します (例: ocs-prometheus-claim-prometheus-k8s-0)。

      図4.3 prometheus-k8s-* Pod に割り当てられた Persistent Volume Claim(永続ボリューム要求、PVC)

      

手順

1. コマンドラインインターフェイスまたはユーザーインターフェイスのいずれかから storagecluster をデプロイします。

2. アプリケーションの namespace にラベルを付けます。

   apiVersion: v1
   kind: Namespace
   metadata:
        name: <desired_name>
        labels:
             storagequota: <desired_label>

   <desired_name>

   アプリケーション namespace の名前を指定します (例: quota-rbd)。

   <desired_label>

   ストレージクォータのラベルを指定します (例: storagequota1)。

3. storagecluster を編集して、ストレージクラスのクォータ制限を設定します。

   $ oc edit storagecluster -n openshift-storage <ocs_storagecluster_name>

   <ocs_storagecluster_name>

   ストレージクラスターの名前を指定します。

4. 必要なハード制限を持つオーバープロビジョニング制御のエントリーを StorageCluster.Spec に追加します。

   apiVersion: ocs.openshift.io/v1
   kind: StorageCluster
   spec:
    [...]
        overprovisionControl:
        - capacity: <desired_quota_limit>
             storageClassName: <storage_class_name>
             quotaName: <desired_quota_name>
             selector:
               labels:
                      matchLabels:
                       storagequota: <desired_label>
   [...]

   <desired_quota_limit>

   ストレージクラスに必要なクォータ制限を指定します (例: 27Ti)。

   <storage_class_name>

   クォータ制限を設定するストレージクラスの名前を指定します (例: ocs-storagecluster-ceph-rbd)。

   <desired_quota_name>

   ストレージクォータの名前を指定します (例: quota1)。

   <desired_label>

   ストレージクォータのラベルを指定します (例: storagequota1)。

5. 変更された storagecluster を保存します。

6. clusterresourcequota が定義されていることを確認します。

   注記

   前の手順で定義した quotaName (たとえば、quota1) を持つ clusterresourcequota を期待します。

   $ oc get clusterresourcequota -A
   
   $ oc describe clusterresourcequota -A

手順

1. OpenShift Web Console で、Compute → Nodes をクリックし、テイントする必要のあるノードを選択します。
2. Details ページで、Edit taints をクリックします。
3. Key <nodes.openshift.ocs.io/storage>、Value <true>、および Effect<Noschedule> フィールドに値を入力します。
4. Save をクリックします。

手順

1. 使用するアプリケーションの Persistent Volume Claim(永続ボリューム要求、PVC) を作成します。

   1. OpenShift Web コンソールで、Storage → Persistent Volume Claims をクリックします。
   2. アプリケーション Pod の Project を設定します。

   3. Create Persistent Volume Claim をクリックします。

      1. OpenShift Data Foundation によって提供される Storage Class を指定します。
      2. PVC Name (例: myclaim) を指定します。

      3. 必要な Access Mode を選択します。

         注記

         IBM FlashSystem では Access Mode の Shared access (RWX) はサポートされません。

      4. Rados Block Device (RBD) の場合、Access mode が ReadWriteOnce (RWO) であれば、必須の Volume mode を選択します。デフォルトのボリュームモードは、Filesystem です。
      5. アプリケーション要件に応じて Size を指定します。
      6. Create をクリックし、PVC のステータスが Bound になるまで待機します。

2. 新規または既存のアプリケーション Pod を新規 PVC を使用するように設定します。

   • 新規アプリケーション Pod の場合、以下の手順を実行します。

     1. Workloads →Pods をクリックします。
     2. 新規アプリケーション Pod を作成します。

     3. spec: セクションの下に volumes: セクションを追加し、新規 PVC をアプリケーション Pod のボリュームとして追加します。

        volumes:
          - name: <volume_name>
            persistentVolumeClaim:
              claimName: <pvc_name>

        以下に例を示します。

        volumes:
          - name: mypd
            persistentVolumeClaim:
              claimName: myclaim

   • 既存のアプリケーション Pod の場合、以下の手順を実行します。

     1. Workloads →Deployment Configs をクリックします。
     2. アプリケーション Pod に関連付けられた必要なデプロイメント設定を検索します。
     3. Action メニュー (⋮) → Edit Deployment Config をクリックします。

     4. spec: セクションの下に volumes: セクションを追加し、新規 PVC をアプリケーション Pod のボリュームとして追加し、Save をクリックします。

        volumes:
          - name: <volume_name>
            persistentVolumeClaim:
              claimName: <pvc_name>

        以下に例を示します。

        volumes:
          - name: mypd
            persistentVolumeClaim:
              claimName: myclaim

3. 新しい設定が使用されていることを確認します。

   1. Workloads → Pods をクリックします。
   2. アプリケーション Pod の Project を設定します。
   3. アプリケーション Pod が Running ステータスで表示されていることを確認します。
   4. アプリケーション Pod 名をクリックし、Pod の詳細を表示します。
   5. Volumes セクションまでスクロールダウンし、ボリュームに新規 Persistent Vocume Claim (永続ボリューム要求、PVC) に一致する Type があることを確認します (例: myclaim)。

手順

1. OpenShift Web コンソールにログインします。
2. Storage → Persistent Volume Claims をクリックします。
3. Filter テキストボックスを使用して、必要な PVC 名を検索します。また、リストを絞り込むために Name または Label で PVC のリストをフィルターすることもできます。
4. 必要な PVC に対応する Status 列を確認します。
5. 必要な Name をクリックして PVC の詳細を表示します。

手順

1. OpenShift Web Console で、Storage → Data Foundation をクリックします。
2. Storage systems タブでストレージシステムを選択し、Overview → Block and File タブをクリックします。
3. Inventory カードを見つけ、エラーのある PVC の数を確認します。
4. Storage → Persistent Volume Claims をクリックします。
5. Filter テキストボックスを使用して、必要な PVC を検索します。
6. PVC 名をクリックし、Events に移動します。
7. 必要に応じて、または指示に応じてイベントに対応します。

手順

1. OpenShift Web コンソールで、Storage → Persistent Volume Claims に移動します。
2. 拡張する Persistent Volume Claim(永続ボリューム要求、PVC) の横にある Action メニュー (⋮) をクリックします。

3. Expand PVC をクリックします。

   

4. Persistent Volume Claim(永続ボリューム要求、PVC) の新しいサイズを選択してから、Expand をクリックします。

   

5. 拡張を確認するには、PVC の詳細ページに移動し、Capacity フィールドでサイズが正しく要求されていることを確認します。

   注記

   Ceph RADOS Block Device (RBD) に基づいて PVC を拡張する場合、PVC がまだ Pod に割り当てられていない場合は、PVC の詳細ページで Condition type は FileSystemResizePending になります。ボリュームをマウントすると、ファイルシステムのサイズ変更が正常に実行され、新しいサイズが Capacity フィールドに反映されます。

手順

1. スペースの回収操作用に次のカスタムリソースを作成して適用します。

   apiVersion: csiaddons.openshift.io/v1alpha1
   kind: ReclaimSpaceJob
   metadata:
     name: sample-1
   spec:
     target:
       persistentVolumeClaim: pvc-1

   上記の yaml で使用される変数は次のとおりです。

   • target は、操作が実行するボリュームターゲットを示します。

     • persistentVolumeClaim には、PersistentVolumeClaim の名前を示す文字列が含まれています。
   • backOfflimit は、スペースの回収操作が失敗するまでの最大再試行回数を指定します。指定しない場合、デフォルト値は 6 に設定されます。許可される最大値と最小値は 60 と 0 です。
   • restartDeadlineSeconds は、開始時間に対して操作が終了する可能性のある期間を指定します。その値は正の整数でなければならず、時間の単位は秒単位です。指定しない場合、デフォルトは 600 秒に設定されます。最大許容値は 1800 です。
2. 操作の完了後に顧客リソースを削除します。

手順

1. スペースの回収操作用に次のカスタムリソースを作成して適用します

   apiVersion: csiaddons.openshift.io/v1alpha1
   kind: ReclaimSpaceCronJob
   metadata:
     name: reclaimspacecronjob-sample
   spec:
     jobTemplate:
       spec:
         target:
           persistentVolumeClaim: data-pvc
     schedule: '@weekly'

   上記の yaml で使用される変数は次のとおりです。

   • failedJobsHistoryLimit は、失敗した ReclaimSpaceJobs の数を保持します。
   • jobTemplate には、要求された ReclaimSpaceJob 操作を含む ReclaimSpaceJob.spec 構造が含まれています。
   • schedule は、定期的な操作の間隔を設定します。スケジュールの形式については、Kubernetes CronJobs を参照してください。
   • successfulJobsHistoryLimit は、成功した ReclaimSpaceJob 操作の数を保持します。
2. 操作の完了後に顧客リソースを削除します。

手順

1. 永続ボリュームクレーム (pvc) の詳細を取得します。

   $ oc get pvc data-pvc

   以下に例を示します。

   NAME      STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS                          AGE
   data-pvc  Bound    pvc-f37b8582-4b04-4676-88dd-e1b95c6abf74   1Gi        RWO            ocs-storagecluster-ceph-rbd           20h

2. アノテーション reclaimspace.csiaddons.openshift.io/schedule: "@midnight"`を PVC に追加して、reclaimspacecronjob を作成します。

   $ oc annotate pvc data-pvc "reclaimspace.csiaddons.openshift.io/schedule=@midnight"

   以下に例を示します。

   persistentvolumeclaim/data-pvc annotated

3. reclaimspacecronjob が "<pvc-name>-xxxxxxx" の形式で作成されていることを確認します。

   $ oc get reclaimspacecronjobs.csiaddons.openshift.io

   以下に例を示します。

   NAME                    SCHEDULE    SUSPEND   ACTIVE   LASTSCHEDULE   AGE
   data-pvc-1642663516   @midnight                                     3s

4. このジョブを自動的に実行するようにスケジュールを変更します。

   $ oc annotate pvc data-pvc "reclaimspace.csiaddons.openshift.io/schedule=*/1 * * * *" --overwrite=true

   以下に例を示します。

   persistentvolumeclaim/data-pvc annotated

5. reclaimspacecronjob のスケジュールが変更されていることを確認します。

   $ oc get reclaimspacecronjobs.csiaddons.openshift.io

   以下に例を示します。

   NAME                  SCHEDULE    SUSPEND   ACTIVE   LASTSCHEDULE   AGE
   data-pvc-1642664617   */1 * * * *                                   3s

手順

1. OpenShift Web コンソールで、Storage → Persistent Volume Claims をクリックします。

2. クローンを作成するには、以下のいずれかを実行します。

   • 必要な PVC の横にある Action メニュー (⋮) → Clone PVC をクリックします。
   • クローンを作成する必要のある PVC をクリックし、Actions → Clone PVC をクリックします。
3. クローンの Name を入力します。

4. 任意のアクセスモードを選択します。

   重要

   ReadOnlyMany (ROX) アクセスモードは 開発者プレビュー機能であり、開発者プレビューのサポート制限の対象となります。開発者プレビューリリースは、実稼働環境で実行することは意図されておらず、Red Hat カスタマーポータルのケース管理システムではサポートされません。ReadOnlyMany 機能に関してサポートが必要な場合には、ocs-devpreview@redhat.com メーリングリストに連絡してください。Red Hat Development Team のメンバーが稼働状況とスケジュールに応じて可能な限り迅速に対応します。ROX アクセスモードの使用については、Creating a clone or restoring a snapshot with the new readonly access mode について参照してください。

5. Clone をクリックします。新規 PVC の詳細ページにリダイレクトされます。

6. クローン作成された PVC のステータスが Bound になるまで待機します。

   クローン作成された PVC が Pod で使用できるようになります。このクローン作成された PVC は dataSource PVC とは切り離されています。