手順

1. OpenShift Web コンソールの左側のペインから Administration → Custom Resource Definitions をクリックします。
2. Custom Resource Definitions ページで、ClusterLogging をクリックします。
3. Custom Resource Definition Overview ページで、Actions メニューから View Instances を選択するか、または Instances タブをクリックします。

4. Cluster Logging ページで、Create Cluster Logging をクリックします。

   データを読み込むためにページを更新する必要がある場合があります。

5. YAML で、コードを以下に置き換えます。

   apiVersion: "logging.openshift.io/v1"
   kind: "ClusterLogging"
   metadata:
     name: "instance"
     namespace: "openshift-logging"
   spec:
     managementState: "Managed"
     logStore:
       type: "elasticsearch"
       elasticsearch:
         nodeCount: 3
         storage:
           storageClassName: ocs-storagecluster-ceph-rbd
           size: 200G
         redundancyPolicy: "SingleRedundancy"
     visualization:
       type: "kibana"
       kibana:
         replicas: 1
     curation:
       type: "curator"
       curator:
         schedule: "30 3 * * *"
     collection:
       logs:
         type: "fluentd"
         fluentd: {}

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

検証手順

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

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

   3. Persistent Volume Claim（永続ボリューム要求、PVC）が elasticsearch-* Pod に割り当てられ、 Bound （バインド）の状態で表示されることを確認します。

      図2.1 作成済みのバインドされたクラスターロギング

      

2. 新規クラスターロギングが使用されていることを確認します。

   1. Workload → Pods をクリックします。
   2. プロジェクトを openshift-logging に設定します。
   3. 新規の elasticsearch-* Pod が Running 状態で表示されることを確認します。
   4. 新規の elasticsearch-* Pod をクリックし、Pod の詳細を表示します。
   5. Volumes までスクロールダウンし、elasticsearch ボリュームに新規 Persistent Volume Claim (永続ボリューム要求、PVC) に一致する Type があることを確認します (例: elasticsearch-elasticsearch-cdm-9r624biv-3)。
   6. Persistent Volume Claim（永続ボリューム要求、PVC）の名前をクリックし、PersistenVolumeClaim Overview ページでストレージクラス名を確認します。

手順

1. 以下の行をアプリケーション YAML に追加します。

   apiVersion: objectbucket.io/v1alpha1
   kind: ObjectBucketClaim
   metadata:
     name: <obc-name>
   spec:
     generateBucketName: <obc-bucket-name>
     storageClassName: noobaa

   これらの行は Object Bucket Claim（オブジェクトバケット要求）自体になります。

   1. <obc-name> を、一意の Object Bucket Claim（オブジェクトバケット要求）の名前に置き換えます。
   2. <obc-bucket-name> を、Object Bucket Claim（オブジェクトバケット要求）の一意のバケット名に置き換えます。

2. YAML ファイルにさらに行を追加して、Object Bucket Claim（オブジェクトバケット要求）の使用を自動化できます。以下の例はバケット要求の結果のマッピングです。これは、データを含む設定マップおよび認証情報のあるシークレットです。この特定のジョブは NooBaa からオブジェクトバケットを要求し、バケットとアカウントを作成します。

   apiVersion: batch/v1
   kind: Job
   metadata:
     name: testjob
   spec:
     template:
       spec:
         restartPolicy: OnFailure
         containers:
           - image: <your application image>
             name: test
             env:
               - name: BUCKET_NAME
                 valueFrom:
                   configMapKeyRef:
                     name: <obc-name>
                     key: BUCKET_NAME
               - name: BUCKET_HOST
                 valueFrom:
                   configMapKeyRef:
                     name: <obc-name>
                     key: BUCKET_HOST
               - name: BUCKET_PORT
                 valueFrom:
                   configMapKeyRef:
                     name: <obc-name>
                     key: BUCKET_PORT
               - name: AWS_ACCESS_KEY_ID
                 valueFrom:
                   secretKeyRef:
                     name: <obc-name>
                     key: AWS_ACCESS_KEY_ID
               - name: AWS_SECRET_ACCESS_KEY
                 valueFrom:
                   secretKeyRef:
                     name: <obc-name>
                     key: AWS_SECRET_ACCESS_KEY

   1. <obc-name> のすべてのインスタンスを、Object Bucket Claim（オブジェクトバケット要求）の名前に置き換えます。
   2. <your application image> をアプリケーションイメージに置き換えます。

3. 更新された YAML ファイルを適用します。

   # oc apply -f <yaml.file>

   1. <yaml.file> を YAML ファイルの名前に置き換えます。

4. 新しい設定マップを表示するには、以下を実行します。

   # oc get cm <obc-name>

   1. obc-name を、Object Bucket Claim（オブジェクトバケット要求）の名前に置き換えます。

      出力には、以下の環境変数が表示されることが予想されます。

      • BUCKET_HOST: アプリケーションで使用するエンドポイント

      • BUCKET_PORT: アプリケーションで利用できるポート

        • ポートは BUCKET_HOST に関連します。たとえば、BUCKET_HOST が https://my.example.com で、BUCKET_PORT が 443 の場合、オブジェクトサービスのエンドポイントは https://my.example.com:443 になります。
      • BUCKET_NAME: 要求されるか、または生成されるバケット名
      • AWS_ACCESS_KEY_ID: 認証情報の一部であるアクセスキー
      • AWS_SECRET_ACCESS_KEY: 認証情報の一部であるシークレットのアクセスキー

手順

1. コマンドラインインターフェースを使用して、新規バケットおよび認証情報の詳細を生成します。以下のコマンドを実行します。

   # noobaa obc create <obc-name> -n openshift-storage

   <obc-name> を一意の Object Bucket Claim（オブジェクトバケット要求）の名前に置き換えます (例: myappobc)。

   さらに、--app-namespace オプションを使用して、Object Bucket Claim（オブジェクトバケット要求）設定マップおよびシークレットが作成される namespace を指定できます(例: myapp-namespace)。

   出力例:

   INFO[0001] ✅ Created: ObjectBucketClaim "test21obc"

   MCG コマンドラインインターフェースが必要な設定を作成し、新規 OBC について OpenShift に通知します。

2. 以下のコマンドを実行して Object Bucket Claim（オブジェクトバケット要求）を表示します。

   # oc get obc -n openshift-storage

   出力例:

   NAME        STORAGE-CLASS                 PHASE   AGE
   test21obc   openshift-storage.noobaa.io   Bound   38s

3. 以下のコマンドを実行して、新規 Object Bucket Claim（オブジェクトバケット要求）の YAML ファイルを表示します。

   # oc get obc test21obc -o yaml -n openshift-storage

   出力例:

   apiVersion: objectbucket.io/v1alpha1
   kind: ObjectBucketClaim
   metadata:
     creationTimestamp: "2019-10-24T13:30:07Z"
     finalizers:
     - objectbucket.io/finalizer
     generation: 2
     labels:
       app: noobaa
       bucket-provisioner: openshift-storage.noobaa.io-obc
       noobaa-domain: openshift-storage.noobaa.io
     name: test21obc
     namespace: openshift-storage
     resourceVersion: "40756"
     selfLink: /apis/objectbucket.io/v1alpha1/namespaces/openshift-storage/objectbucketclaims/test21obc
     uid: 64f04cba-f662-11e9-bc3c-0295250841af
   spec:
     ObjectBucketName: obc-openshift-storage-test21obc
     bucketName: test21obc-933348a6-e267-4f82-82f1-e59bf4fe3bb4
     generateBucketName: test21obc
     storageClassName: openshift-storage.noobaa.io
   status:
     phase: Bound

4. openshift-storage namespace 内で、設定マップおよびシークレットを見つけ、この Object Bucket Claim（オブジェクトバケット要求）を使用することができます。CM とシークレットの名前はこの Object Bucket Claim（オブジェクトバケット要求）の名前と同じです。シグナルを表示するには、以下を実行します。

   # oc get -n openshift-storage secret test21obc -o yaml

   出力例:

   Example output:
   apiVersion: v1
   data:
     AWS_ACCESS_KEY_ID: c0M0R2xVanF3ODR3bHBkVW94cmY=
     AWS_SECRET_ACCESS_KEY: Wi9kcFluSWxHRzlWaFlzNk1hc0xma2JXcjM1MVhqa051SlBleXpmOQ==
   kind: Secret
   metadata:
     creationTimestamp: "2019-10-24T13:30:07Z"
     finalizers:
     - objectbucket.io/finalizer
     labels:
       app: noobaa
       bucket-provisioner: openshift-storage.noobaa.io-obc
       noobaa-domain: openshift-storage.noobaa.io
     name: test21obc
     namespace: openshift-storage
     ownerReferences:
     - apiVersion: objectbucket.io/v1alpha1
       blockOwnerDeletion: true
       controller: true
       kind: ObjectBucketClaim
       name: test21obc
       uid: 64f04cba-f662-11e9-bc3c-0295250841af
     resourceVersion: "40751"
     selfLink: /api/v1/namespaces/openshift-storage/secrets/test21obc
     uid: 65117c1c-f662-11e9-9094-0a5305de57bb
   type: Opaque

   シークレットは S3 アクセス認証情報を提供します。

5. 設定マップを表示するには、以下を実行します。

   # oc get -n openshift-storage cm test21obc -o yaml

   出力例:

   apiVersion: v1
   data:
     BUCKET_HOST: 10.0.171.35
     BUCKET_NAME: test21obc-933348a6-e267-4f82-82f1-e59bf4fe3bb4
     BUCKET_PORT: "31242"
     BUCKET_REGION: ""
     BUCKET_SUBREGION: ""
   kind: ConfigMap
   metadata:
     creationTimestamp: "2019-10-24T13:30:07Z"
     finalizers:
     - objectbucket.io/finalizer
     labels:
       app: noobaa
       bucket-provisioner: openshift-storage.noobaa.io-obc
       noobaa-domain: openshift-storage.noobaa.io
     name: test21obc
     namespace: openshift-storage
     ownerReferences:
     - apiVersion: objectbucket.io/v1alpha1
       blockOwnerDeletion: true
       controller: true
       kind: ObjectBucketClaim
       name: test21obc
       uid: 64f04cba-f662-11e9-bc3c-0295250841af
     resourceVersion: "40752"
     selfLink: /api/v1/namespaces/openshift-storage/configmaps/test21obc
     uid: 651c6501-f662-11e9-9094-0a5305de57bb

   設定マップには、アプリケーションの S3 エンドポイント情報が含まれます。

1. 以下のコマンドを実行して、新規ノードが出力にあることを確認します。

   $ oc get nodes --show-labels | grep cluster.ocs.openshift.io/openshift-storage= |cut -d' ' -f1

2. Workloads → Pods をクリックし、新規ノード上の少なくとも以下の Pod が Running 状態にあることを確認します。

   • csi-cephfsplugin-*
   • csi-rbdplugin-*

3. 永続ストレージダッシュボードを使用して OpenShift Container Storage クラスターの正常性を確認します。

   1. OpenShift Web コンソールの左側のペインから Home → Dashboards をクリックし、 Persistent Storage タブをクリックします。
   2. Health カード で、クラスターの正常性が ocs-storagecluster is healthy として表示されることを確認します。

手順

1. MCG コマンドラインインターフェースから、以下のコマンドを実行します。

   noobaa backingstore create <backing-store-type> <backingstore_name> --access-key=<AWS ACCESS KEY> --secret-key=<AWS SECRET ACCESS KEY> --target-bucket <bucket-name>

   1. <backing-store-type> を、関連するバッキングストアタイプの aws-s3、google-cloud-store、azure-blob、または s3-compatible に置き換えます。
   2. <backingstore_name> を、バッキングストアの名前に置き換えます。
   3. <AWS ACCESS KEY> および <AWS SECRET ACCESS KEY> を、作成した AWS アクセスキー ID およびシークレットアクセスキーに置き換えます。

   4. <bucket-name> を既存の AWS バケット名に置き換えます。この引数は、NooBaa に対して、バッキングストア、およびその後のデータストレージおよび管理のためのターゲットバケットとして使用するバケットについて指示します。

      出力は以下のようになります。

      INFO[0001] ✅ Exists: NooBaa "noobaa"
      INFO[0002] ✅ Created: BackingStore "aws-resource"
      INFO[0002] ✅ Created: Secret "backing-store-secret-aws-resource"

1. 認証情報でシークレットを作成します。

   apiVersion: v1
   kind: Secret
   metadata:
     name: <backingstore-secret-name>
   type: Opaque
   data:
     AWS_ACCESS_KEY_ID: <AWS ACCESS KEY ID ENCODED IN BASE64>
     AWS_SECRET_ACCESS_KEY: <AWS SECRET ACCESS KEY ENCODED IN BASE64>

   1. Base64 を使用して独自の AWS アクセスキー ID およびシークレットアクセスキーを指定し、エンコードし、その結果を <AWS ACCESS KEY ID ENCODED IN BASE64> および <AWS SECRET ACCESS KEY ENCODED IN BASE64> に使用する必要があります。
   2. <backingStore-secret-name> を一意の名前に置き換えます。

2. 特定のバッキングストアについて以下の YAML を適用します。

   apiVersion: noobaa.io/v1alpha1
   kind: BackingStore
   metadata:
     name: aws-resource
     labels:
       app: noobaa
   spec:
     bucketName: <bucket-name>
     s3Options:
       endpoint: s3.amazonaws.com
     secret:
       name: <backingstore-secret-name>
       namespace: openshift-storage
     type: <backing-store-type>

   1. <bucket-name> を既存の AWS バケット名に置き換えます。この引数は、NooBaa に対して、バッキングストア、およびその後のデータストレージおよび管理のためのターゲットバケットとして使用するバケットについて指示します。
   2. <backingstore-secret-name> を直前の手順で作成したシークレットの名前に置き換えます。
   3. <backing-store-type> を、関連するバッキングストアタイプの aws-s3、google-cloud-store、 azure-blob、または s3-compatible に置き換えます。

手順

1. MCG コマンドラインインターフェースから、以下のコマンドを実行します。

   noobaa backingstore create s3-compatible rgw_resource --access-key=<RGW ACCESS KEY> --secret-key=<RGW SECRET KEY> --target-bucket=<bucket-name> --endpoint=http://rook-ceph-rgw-ocs-storagecluster-cephobjectstore.openshift-storage:80

   1. <RGW ACCESS KEY> および <RGW SECRET KEY> を取得するには、RGW ユーザーシークレット名を使用して以下のコマンドを実行します。

      oc get secret <RGW USER SECRET NAME> -o yaml

   2. Base64 からアクセスキー ID とアクセスキーをデコードし、それらのキーを保持します。
   3. <RGW USER ACCESS KEY> と <RGW USER SECRET ACCESS KEY> を、直前の手順でデコードした適切なデータに置き換えます。

   4. <bucket-name> を既存の RGW バケット名に置き換えます。この引数は、NooBaa に対して、バッキングストア、およびその後のデータストレージおよび管理のためのターゲットバケットとして使用するバケットについて指示します。

      出力は以下のようになります。

      INFO[0001] ✅ Exists: NooBaa "noobaa"
      INFO[0002] ✅ Created: BackingStore "rgw-resource"
      INFO[0002] ✅ Created: Secret "backing-store-secret-rgw-resource"

1. CephObjectStore ユーザーを作成します。これにより、RGW 認証情報が含まれるシークレットも作成されます。

   apiVersion: ceph.rook.io/v1
   kind: CephObjectStoreUser
   metadata:
     name: <RGW-Username>
     namespace: openshift-storage
   spec:
     store: ocs-storagecluster-cephobjectstore
     displayName: "<Display-name>"

   1. <RGW-Username> と <Display-name> を、一意のユーザー名および表示名に置き換えます。

2. 以下の YAML を S3 と互換性のあるバッキングストアについて適用します。

   apiVersion: noobaa.io/v1alpha1
   kind: BackingStore
   metadata:
     finalizers:
     - noobaa.io/finalizer
     labels:
       app: noobaa
     name: <backingstore-name>
     namespace: openshift-storage
   spec:
     s3Compatible:
       endpoint: http://rook-ceph-rgw-ocs-storagecluster-cephobjectstore.openshift-storage
       secret:
         name: <backingstore-secret-name>
         namespace: openshift-storage
       signatureVersion: v4
       targetBucket: <RGW-bucket-name>
     type: s3-compatible

   1. <backingstore-secret-name> を、直前の手順で CephObjectStore で作成したシークレットの名前に置き換えます。
   2. <bucket-name> を既存の RGW バケット名に置き換えます。この引数は、NooBaa に対して、バッキングストア、およびその後のデータストレージおよび管理のためのターゲットバケットとして使用するバケットについて指示します。

手順

1. OpenShift Storage コンソールで、Dashboards → Object Service → に移動し、noobaa リンクを選択します。

   

2. 以下に強調表示されているように左側にある Resources タブを選択します。設定する一覧から、Add Cloud Resource を選択します。

   

3. Add new connection を選択します。

   

4. 関連するネイティブクラウドプロバイダーまたは S3 互換オプションを選択し、詳細を入力します。

   

5. 新規に作成された接続を選択し、これを既存バケットにマップします。

   
6. これらの手順を繰り返して、必要な数のバッキングストアを作成します。

1. MCG コマンドラインインターフェースから以下のコマンドを実行し、ミラーリングポリシーでバケットクラスを作成します。

   $ noobaa bucketclass create mirror-to-aws --backingstores=azure-resource,aws-resource --placement Mirror

2. 新たに作成されたバケットクラスを新規のバケット要求に設定し、2 つのロケーション間でミラーリングされる新規バケットを生成します。

   $ noobaa obc create  mirrored-bucket --bucketclass=mirror-to-aws

1. 以下の YAML を適用します。この YAML は、ローカル Ceph ストレージと AWS 間でデータをミラーリングするハイブリッドの例です。

   apiVersion: noobaa.io/v1alpha1
   kind: BucketClass
   metadata:
     name: hybrid-class
     labels:
       app: noobaa
   spec:
     placementPolicy:
       tiers:
         - tier:
             mirrors:
               - mirror:
                   spread:
                     - cos-east-us
               - mirror:
                   spread:
                     - noobaa-test-bucket-for-ocp201907291921-11247_resource

2. 以下の行を標準の Object Bucket Claim (オブジェクトバケット要求、OBC) に追加します。

   additionalConfig:
     bucketclass: mirror-to-aws

   OBC についての詳細は、「Object Bucket Claim（オブジェクトバケット要求）」を参照してください。

1. OpenShift Storage コンソールで、Dashboards → Object Service → に移動し、noobaa リンクを選択します。

   

2. 左側の buckets アイコンをクリックします。バケットの一覧が表示されます。

   
3. 更新するバケットを選択します。

4. Edit Tier 1 Resources をクリックします。

   

5. Mirror を選択し、このバケットに使用する関連リソースを確認します。以下の例では、prem Ceph RGW と AWS 間でデータのミラーリングをします。

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