ハイブリッドおよびマルチクラウドリソースの管理

手順

1. OpenShift Web コンソールの左側のペインで Operators → Installed Operators をクリックし、インストールされた Operator を表示します。
2. OpenShift Container Storage Operator をクリックします。

3. OpenShift Container Storage Operator ページで右側にスクロールし、Backing Store タブをクリックします。

   図4.1 バッキングストアタブのある OpenShift Container Storage Operator ページ

   

4. Create Backing Store をクリックします。

   図4.2 Create Backing Store ページ

   

5. Create New Backing Store ページで、以下を実行します。

   1. Backing Store Name を入力します。
   2. Provider を選択します。
   3. Region を選択します。
   4. Endpoint を入力します。これはオプションです。

   5. ドロップダウンリストから Secret を選択するか、または独自のシークレットを作成します。オプションで、Switch to Credentials ビューを選択すると、必要なシークレットを入力できます。

      OCP シークレットの作成に関する詳細は、Openshift Container Platform ドキュメントの シークレットの作成 を参照してください。

      バッキングストアごとに異なるシークレットが必要です。特定のバッキングストアのシークレット作成についての詳細は 「MCG コマンドラインインターフェイスを使用したハイブリッドまたはマルチクラウドのストレージリソースの追加」 を参照して、YAML を使用したストレージリソースの追加についての手順を実行します。

      注記

      このメニューは、Google Cloud およびローカル PVC 以外のすべてのプロバイダーに関連します。

   6. Target bucket を入力します。ターゲットバケットは、リモートクラウドサービスでホストされるコンテナーストレージです。MCG に対してシステム用にこのバケットを使用できることを通知する接続を作成できます。
6. Create Backing Store をクリックします。

検証手順

1. Operators → Installed Operators をクリックします。
2. OpenShift Container Storage Operator をクリックします。
3. 新しいバッキングストアを検索するか、または Backing Store タブをクリックし、すべてのバッキングストアを表示します。

手順

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

   noobaa backingstore create s3-compatible rgw-resource --access-key=<RGW ACCESS KEY> --secret-key=<RGW SECRET KEY> --target-bucket=<bucket-name> --endpoint=<RGW endpoint>

   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 バケット名に置き換えます。この引数は、Multicloud Object Gateway に対して、バッキングストア、およびその後のデータストレージおよび管理のためのターゲットバケットとして使用するバケットについて指示します。

   5. <RGW endpoint> を取得するには、RADOS Object Gateway S3 エンドポイントへのアクセス を参照してください。

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

      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: <RGW endpoint>
       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 バケット名に置き換えます。この引数は、Multicloud Object Gateway に対して、バッキングストア、およびその後のデータストレージおよび管理のためのターゲットバケットとして使用するバケットについて指示します。
   3. <RGW endpoint> を取得するには、RADOS Object Gateway S3 エンドポイントへのアクセス を参照してください。

手順

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

   

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

   

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

   

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

   

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

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

手順

1. OpenShift Web コンソールの左側のペインで Operators → Installed Operators をクリックし、インストールされた Operator を表示します。
2. OpenShift Container Storage Operator をクリックします。

3. OpenShift Container Storage Operator ページで右側にスクロールし、Bucket Class タブをクリックします。

   図4.3 Bucket Class タブのある OpenShift Container Storage Operator ページ

   
4. Create Bucket Class をクリックします。

5. Create new Bucket Class ページで、以下を実行します。

   1. Bucket Class Name を入力し、Next をクリックします。

      図4.4 Create Bucket Class ページ

      

   2. Placement Policy で Tier 1 - Policy Type を選択し、Next をクリックします。要件に応じて、いずれかのオプションを選択できます。

      • Spread により、選択したリソース全体にデータを分散できます。
      • Mirror により、選択したリソース全体でデータを完全に複製できます。

      • Add Tier をクリックし、別のポリシー階層を追加します。

        図4.5 階層 1 - Policy Type 選択ページ

        

   3. Tier 1 - Policy Type で Spread を選択した場合、利用可能な一覧から 1 つ以上の Backing Store リソースを選択してから、Next をクリックします。または、新規バッキングストアを作成 することもできます。

      図4.6 階層 1 - Baking Store 選択ページ

      

1. Bucket Class 設定を確認し、確認します。

   図4.7 バケットクラス設定の確認ページ

   
2. Create Bucket Class をクリックします。

検証手順

1. Operators → Installed Operators をクリックします。
2. OpenShift Container Storage Operator をクリックします。
3. 新しい Bucket Class を検索するか、または Bucket Class タブをクリックし、すべての Bucket Class を表示します。

手順

1. OpenShift コンソールで、Home → Overview をクリックし、 Object Service タブをクリックします。
2. Multicloud Object Gateway をクリックし、プロンプトが表示されたらログインします。
3. Accounts をクリックし、接続を追加するアカウントを選択します。
4. My Connections をクリックします。

5. Add Connection をクリックします。

   1. Connection Name を入力します。
   2. クラウドプロバイダーは、デフォルトで Service ドロップダウンに表示されます。別のプロバイダーを使用するように選択を変更します。
   3. クラウドプロバイダーのデフォルトエンドポイントはデフォルトで Endpoint フィールドに表示されます。必要に応じて代替エンドポイントを入力します。
   4. このクラウドプロバイダーの Access Key を入力します。
   5. このクラウドプロバイダーの Secret Key を入力します。
   6. Save をクリックします。

手順

1. OpenShift コンソールで、Home → Overview をクリックし、Object Service タブをクリックします。
2. Multicloud Storage Gateway をクリックし、プロンプトが表示されたらログインします。
3. Resources をクリックし、Namespace Resources タブをクリックします。

4. Create Namespace Resource をクリックします。

   1. Target Connection で、この namespace のストレージプロバイダーに使用される接続を選択します。

      新規の接続を追加する必要がある場合は、Add New Connection をクリックし、プロバイダーの詳細を入力します。詳細は、「プロバイダー接続の Multicloud Object Gateway への追加」 を参照してください。

   2. Target Bucket で、ターゲットとして使用するバケットの名前を選択します。
   3. namespace リソースの Resource Name を入力します。
   4. Create をクリックします。

手順

1. OpenShift コンソールで、Home → Overview をクリックし、 Object Service タブをクリックします。
2. Multicloud Object Gateway をクリックし、プロンプトが表示されたらログインします。
3. Buckets をクリックし、Namespace Buckets タブをクリックします。

4. Create Namespace Bucket をクリックします。

   1. Choose Name タブで、namespace バケットの Name を指定し、Next をクリックします。

   2. Set Placement タブで、以下を実行します。

      1. Read Policy で、namespace バケットがデータの読み取りに使用する各 namespace リソースのチェックボックスを選択します。
      2. Write Policy で、namespace バケットがデータを書き込む namespace リソースを指定します。
      3. Next をクリックします。
   3. 実稼働環境の Set Caching Policy タブを変更しないでください。このタブは開発プレビューとして提供され、サポート制限の対象となります。
   4. Create をクリックします。

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 についての詳細は、8章Object Bucket Claim(オブジェクトバケット要求)を参照してください。

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

   

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

   
3. 更新するバケットをクリックします。

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

   

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

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

1. JSON 形式でバケットポリシーを作成します。以下の例を参照してください。

   {
       "Version": "NewVersion",
       "Statement": [
           {
               "Sid": "Example",
               "Effect": "Allow",
               "Principal": [
                       "john.doe@example.com"
               ],
               "Action": [
                   "s3:GetObject"
               ],
               "Resource": [
                   "arn:aws:s3:::john_bucket"
               ]
           }
       ]
   }

   バケットポリシーには数多くの利用可能な要素があります。それらの設定要素および使用方法についての詳細は、AWS Access Policy Language Overview を参照してください。

   バケットポリシーの他の例については、AWS Bucket Policy Examples を参照してください。

   S3 ユーザーの作成方法については、「Multicloud Object Gateway での AWS S3 ユーザーの作成」 を参照してください。

2. AWS S3 クライアントを使用して put-bucket-policy コマンドを使用してバケットポリシーを S3 バケットに適用します。

   # aws --endpoint ENDPOINT --no-verify-ssl s3api put-bucket-policy --bucket MyBucket --policy BucketPolicy

   ENDPOINT を S3 エンドポイントに置き換えます。

   MyBucket を、ポリシーを設定するバケットに置き換えます。

   BucketPolicy をバケットポリシー JSON ファイルに置き換えます。

   デフォルトの自己署名証明書を使用している場合は、--no-verify-ssl を追加します。

   以下に例を示します。

   # aws --endpoint https://s3-openshift-storage.apps.gogo44.noobaa.org --no-verify-ssl s3api put-bucket-policy -bucket MyBucket --policy file://BucketPolicy

   put-bucket-policy コマンドについての詳細は、AWS CLI Command Reference for put-bucket-policy を参照してください。

手順

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

   

2. Accounts タブで、Create Account をクリックします。

   

3. S3 Access Only を選択し、Account Name を指定します (例: john.doe@example.com)。Next をクリックします。

   

4. S3 default placement を選択します (例: noobaa-default-backing-store)。Buckets Permissions を選択します。特定のバケットまたはすべてのバケットを選択できます。Create をクリックします。

   

手順

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

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

   これらの行は 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. OpenShift Web コンソールにログインします。
2. 左側のナビゲーションバーで Storage → Object Bucket Claims をクリックします。

3. Create Object Bucket Claim をクリックします。

   

4. Object Bucket Claim(オブジェクトバケット要求) の名前を入力し、ドロップダウンメニューから、内部または外部かのデプロイメントに応じて適切なストレージクラスとバケットクラスを選択します。

   内部モード

   

   デプロイメント後に作成された以下のストレージクラスを使用できます。

   • ocs-storagecluster-ceph-rgw は Ceph Object Gateway (RGW) を使用します。
   • openshift-storage.noobaa.io は Multicloud Object Gateway を使用します。

   外部モード

   

   デプロイメント後に作成された以下のストレージクラスを使用できます。

   • ocs-external-storagecluster-ceph-rgw は Ceph Object Gateway (RGW) を使用します。

   • openshift-storage.noobaa.io は Multicloud Object Gateway を使用します。

     注記

     RGW OBC ストレージクラスは、OpenShift Container Storage バージョン 4.5 の新規インストールでのみ利用できます。これは、以前の OpenShift Container Storage リリースからアップグレードされたクラスターには適用されません。

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

   OBC を作成すると、その詳細ページにリダイレクトされます。

   

手順

1. 左側のナビゲーションバーで Storage → Object Bucket Claims をクリックします。
2. 作成した OBC の横にあるアクションメニュー (✓) をクリックします。

3. ドロップダウンメニューで、Attach to Deployment を選択します。

   

4. Deployment Name 一覧から必要なデプロイメントを選択し、Attach をクリックします。

   

1. OpenShift Web コンソールにログインします。

2. 左側のナビゲーションバーで Storage → Object Buckets をクリックします。

   

   特定の OBC の詳細ページに移動し、Resource リンクをクリックして、その OBC のオブジェクトバケットを表示します。

3. 詳細を表示するオブジェクトバケットを選択します。オブジェクトバケットの詳細ページに移動します。

   

手順

1. 左側のナビゲーションバーで Storage → Object Bucket Claims をクリックします。

2. 削除する Object Bucket Claim(オブジェクトバケット要求) の横にあるアクションメニュー (⋮) をクリックします。

   

3. メニューから Delete Object Bucket Claim を選択します。

   
4. Delete をクリックします。

手順

1. Mult-Cloud Object Gateway ユーザーインターフェイスの Overview ページで、 Add Storage Resources をクリックします。

   

2. ウィンドウから Deploy Kubernetes Pool をクリックします。

   

3. Create Pool 手順で、今後インストールされるノードのターゲットプールを作成します。

   

4. Configure 手順で、要求される Pod 数と各 PV のサイズを設定します。新規 Pod ごとに、1 つの PV が作成されます。

   
5. Review 手順で、新規プールの詳細を検索し、ローカルまたは外部デプロイメントのいずれかの使用するデプロイメント方法を選択します。ローカルデプロイメントが選択されている場合、Kubernetes ノードはクラスター内にデプロイされます。外部デプロイメントが選択されている場合、外部で実行するための YAML ファイルが提供されます。

6. すべてのノードは最初の手順で選択したプールに割り当てられ、Resources → Storage resources → Resource name の下で確認できます。