3.5. Ceph Manager rgw モジュールの使用

手順

1. Cephadm シェルにログインします。

   例

   [root@host01 ~]# cephadm shell

   Copy to Clipboard Toggle word wrap

2. rgw モジュールを有効にします。

   例

   [ceph: root@host01 /]# ceph mgr module enable rgw

   Copy to Clipboard Toggle word wrap

3. コマンドラインまたは yaml 仕様ファイルを使用して、Ceph Object Gateway レルムをブートストラップします。

   • オプション 1: コマンドラインインターフェイスを使用します。

     構文

     ceph rgw realm bootstrap [--realm name REALM_NAME] [--zonegroup-name ZONEGROUP_NAME] [--zone-name ZONE_NAME] [--port PORT_NUMBER] [--placement HOSTNAME] [--start-radosgw]

     Copy to Clipboard Toggle word wrap

     例

     [ceph: root@host01 /]# ceph rgw realm bootstrap --realm-name myrealm --zonegroup-name myzonegroup --zone-name myzone --port 5500 --placement="host01 host02" --start-radosgw
     Realm(s) created correctly. Please, use 'ceph rgw realm tokens' to get the token.

     Copy to Clipboard Toggle word wrap

   • オプション 2: yaml 仕様ファイルを使用します。

     1. root ユーザーとして、yaml ファイルを作成します。

        構文

        rgw_realm: REALM_NAME
        rgw_zonegroup: ZONEGROUP_NAME
        rgw_zone: ZONE_NAME
        placement:
          hosts:
           - _HOSTNAME_1_
           - _HOSTNAME_2_

        Copy to Clipboard Toggle word wrap

        例

        [root@host01 ~]# cat rgw.yaml
        
        rgw_realm: myrealm
        rgw_zonegroup: myzonegroup
        rgw_zone: myzone
        placement:
          hosts:
           - host01
           - host02

        Copy to Clipboard Toggle word wrap

     2. オプション: レルムのブートストラップ中に、ゾーングループに hostnames パラメーターを追加できます。

        構文

        service_type: rgw
        placement:
          hosts:
          - _host1_
          - _host2_
        spec:
          rgw_realm: my_realm
          rgw_zonegroup: my_zonegroup
          rgw_zone: my_zone
          zonegroup_hostnames:
          - _hostname1_
          - _hostname2_

        Copy to Clipboard Toggle word wrap

        例

        service_type: rgw
        placement:
          hosts:
          - _host1_
          - _host2_
        spec:
          rgw_realm: my_realm
          rgw_zonegroup: my_zonegroup
          rgw_zone: my_zone
          zonegroup_hostnames:
          - foo
          - bar

        Copy to Clipboard Toggle word wrap

     3. YAML ファイルをコンテナー内のディレクトリーにマウントします。

        例

        [root@host01 ~]# cephadm shell --mount rgw.yaml:/var/lib/ceph/rgw/rgw.yaml

        Copy to Clipboard Toggle word wrap

     4. レルムをブートストラップします。

        例

        [ceph: root@host01 /]# ceph rgw realm bootstrap -i /var/lib/ceph/rgw/rgw.yaml

        Copy to Clipboard Toggle word wrap

        注記

        rgw モジュールで使用される仕様ファイルの形式は、オーケストレーターで使用されるものと同じです。したがって、SSL 証明書などの高度な設定機能を含む、オーケストレーションがサポートする Ceph Object Gateway パラメーターを提供できます。

4. 利用可能なトークンをリストします。

   例

   [ceph: root@host01 /]# ceph rgw realm tokens | jq
   
   [
     {
       "realm": "myrealm",
       "token": "ewogICAgInJlYWxtX25hbWUiOiAibXlyZWFsbSIsCiAgICAicmVhbG1faWQiOiAiZDA3YzAwZWYtOTA0MS00ZjZlLTg4MDQtN2Q0MDI0MDU1NmFlIiwKICAgICJlbmRwb2ludCI6ICJodHRwOi8vdm0tMDA6NDMyMSIsCiAgICAiYWNjZXNzX2tleSI6ICI5NTY1VFZSMVFWTExFRzdVNFIxRCIsCiAgICAic2VjcmV0IjogImQ3b0FJQXZrNEdYeXpyd3Q2QVZ6bEZNQmNnRG53RVdMMHFDenE3cjUiCn1="
     }
   ]

   Copy to Clipboard Toggle word wrap

   注記

   Ceph Object Gateway デーモンがデプロイされる前に上記のコマンドを実行すると、まだエンドポイントがないためトークンがないという旨のメッセージが表示されます。

手順

1. Cephadm シェルにログインします。

   例

   [root@host01 ~]# cephadm shell

   Copy to Clipboard Toggle word wrap

2. rgw モジュールを有効にします。

   例

   [ceph: root@host01 /]# ceph mgr module enable rgw

   Copy to Clipboard Toggle word wrap

3. コマンドラインまたは yaml 仕様ファイルを使用して、Ceph Object Gateway レルムをブートストラップします。

   • オプション 1: コマンドラインインターフェイスを使用します。

     構文

     ceph rgw realm bootstrap [--realm name REALM_NAME] [--zonegroup-name ZONEGROUP_NAME] [--zone-name ZONE_NAME] [--port PORT_NUMBER] [--placement HOSTNAME] [--start-radosgw]

     Copy to Clipboard Toggle word wrap

     例

     [ceph: root@host01 /]# ceph rgw realm bootstrap --realm-name myrealm --zonegroup-name myzonegroup --zone-name myzone --port 5500 --placement="host01 host02" --start-radosgw
     Realm(s) created correctly. Please, use 'ceph rgw realm tokens' to get the token.

     Copy to Clipboard Toggle word wrap

   • オプション 2: yaml 仕様ファイルを使用する: root ユーザーとして、yaml ファイルを作成します。

     構文

     rgw_realm: pass:q[REALM_NAME]
     rgw_zonegroup: pass:q[ZONEGROUP_NAME]
     rgw_zone: pass:q[ZONE_NAME]
     placement:
       hosts:
        - pass:q[HOSTNAME_1]
        - pass:q[HOSTNAME_2]
     spec:
       rgw_frontend_port: pass:q[PORT_NUMBER]
     zone_endpoints:pass:q[ http://RGW_HOSTNAME_1]:pass:q[RGW_PORT_NUMBER_1], pass:q[http://RGW_HOSTNAME_2]:pass:q[RGW_PORT_NUMBER_2]

     Copy to Clipboard Toggle word wrap

     例

     [root@host01 ~]# cat rgw.yaml
     rgw_realm: myrealm
     rgw_zonegroup: myzonegroup
     rgw_zone: myzone
     placement
       hosts:
        - host01
        - host02
     spec:
       rgw_frontend_port: 5500
       zone_endpoints: http://<rgw_host1>:<rgw_port1>, http://<rgw_host2>:<rgw_port2>

     Copy to Clipboard Toggle word wrap

     1. オプション: これらのクライアント rgw の場合、Ceph Object Gateway 仕様ファイルの spec セクションで、disable_multisite_sync_traffic:true を設定します。次に、Cephadm はこれらの RGW デーモンの rgw_run_sync_thread 設定を false に設定し、同期操作に参加できないようにします。この自動化により、RGW ユーザーに対して rgw_run_sync_thread を手動で設定する必要がなくなります。

   構文

   ceph config set <client_rgw_daemon> rgw_run_sync_thread false

   Copy to Clipboard Toggle word wrap

   +

   次の例では、RGW サービス io.rgw は、disable_multisite_sync_traffic: true で設定されているため、クライアント IO のみを処理します。RGW サービス sync.rgw は、disable_multisite_sync_traffic がデフォルトで false に設定されているため、マルチサイト同期操作に参加するように設定されています。

   + .例

   [root@host01 ~]# cat rgw.yaml
   service_id: io.rgw
   service_name: rgw.io.rgw
   rgw_realm: myrealm
   rgw_zonegroup: myzonegroup
   rgw_zone: myzone
   placement:
     hosts:
     - rgw_host1
     - rgw_host2
   spec:
      rgw_frontend_port: <rgw_port>
      disable_multisite_sync_traffic: true
   
   service_id: sync.rgw
   service_name: rgw.sync.rgw
   rgw_realm: myrealm
   rgw_zonegroup: myzonegroup
   rgw_zone: myzone
   placement:
     hosts:
     - rgw_host3
     - rgw_host4
   spec:
      rgw_frontend_port: <rgw_port>
   zone_endpoints: http://<rgw_host3>:<rgw_port>, http://<rgw_host4>:<rgw_port>

   Copy to Clipboard Toggle word wrap

   +

   1. YAML ファイルをコンテナー内のディレクトリーにマウントします。

      例

      [root@host01 ~]# cephadm shell --mount rgw.yaml:/var/lib/ceph/rgw/rgw.yaml

      Copy to Clipboard Toggle word wrap

   2. レルムをブートストラップします。

      例

      [ceph: root@host01 /]# ceph rgw realm bootstrap -i /var/lib/ceph/rgw/rgw.yaml

      Copy to Clipboard Toggle word wrap

      注記

      rgw モジュールで使用される仕様ファイルの形式は、オーケストレーターで使用されるものと同じです。したがって、SSL 証明書などの高度な設定機能を含む、オーケストレーションがサポートする Ceph Object Gateway パラメーターを提供できます。

4. 利用可能なトークンをリストします。

   例

   [ceph: root@host01 /]# ceph rgw realm tokens | jq
   
   [
     {
       "realm": "myrealm",
       "token": "ewogICAgInJlYWxtX25hbWUiOiAibXlyZWFsbSIsCiAgICAicmVhbG1faWQiOiAiZDA3YzAwZWYtOTA0MS00ZjZlLTg4MDQtN2Q0MDI0MDU1NmFlIiwKICAgICJlbmRwb2ludCI6ICJodHRwOi8vdm0tMDA6NDMyMSIsCiAgICAiYWNjZXNzX2tleSI6ICI5NTY1VFZSMVFWTExFRzdVNFIxRCIsCiAgICAic2VjcmV0IjogImQ3b0FJQXZrNEdYeXpyd3Q2QVZ6bEZNQmNnRG53RVdMMHFDenE3cjUiCn1="
     }
   ]

   Copy to Clipboard Toggle word wrap

   注記

   Ceph Object Gateway デーモンがデプロイされる前に上記のコマンドを実行すると、まだエンドポイントがないためトークンがないという旨のメッセージが表示されます。

5. これらのトークンを使用してセカンダリーゾーンを作成し、既存のレルムに参加します。

   1. root ユーザーとして、yaml ファイルを作成します。

      例

      [root@host01 ~]# cat zone-spec.yaml
      rgw_zone: my-secondary-zone
      rgw_realm_token: <token>
      placement:
        hosts:
         - ceph-node-1
         - ceph-node-2
      spec:
        rgw_frontend_port: 5500

      Copy to Clipboard Toggle word wrap

      デプロイメント中に特定の RGW サービスのマルチサイト同期トラフィックパラメーターを無効にするには、手順 3 (b オプション) に従います。この設定により、デプロイメント中に特定の RGW サービスのマルチサイト同期トラフィックが無効になり、クライアント IO のみが処理されるようになります。

   2. コンテナー内のディレクトリーに zone-spec.yaml ファイルをマウントします。

      例

      [root@host01 ~]# cephadm shell --mount zone-spec.yaml:/var/lib/ceph/radosgw/zone-spec.yaml

      Copy to Clipboard Toggle word wrap

   3. セカンダリーゾーンで rgw モジュールを有効にします。

      例

      [ceph: root@host01 /]# ceph mgr module enable rgw

      Copy to Clipboard Toggle word wrap

   4. セカンダリーゾーンを作成します。

      例

      [ceph: root@host01 /]# ceph rgw zone create -i /var/lib/ceph/radosgw/zone-spec.yaml

      Copy to Clipboard Toggle word wrap

      検証

      • Object Gateway のマルチサイトデプロイメントを確認します。

        例

        [ceph: root@host01 /]# radosgw-admin realm list
        {
        "default_info": "d07c00ef-9041-4f6e-8804-7d40240556ae",
        "realms": [
        "myrealm"
        ]
        }

        Copy to Clipboard Toggle word wrap