9.3. バケットインデックスのリシャーディングを設定する

手順

1. 推奨されるシャード数を計算します。

   number of objects expected in a bucket / 100,000

   Copy to Clipboard Toggle word wrap
   注記

   現在サポートされているバケットインデックスシャードの最大数は 65,521 です。

2. rgw_override_bucket_index_max_shards オプションを適宜設定します。

   構文

   ceph config set client.rgw rgw_override_bucket_index_max_shards VALUE

   Copy to Clipboard Toggle word wrap

   VALUE を、計算されたシャードの推奨数に置き換えます。

   例

   [ceph: root@host01 /]# ceph config set client.rgw rgw_override_bucket_index_max_shards 12

   Copy to Clipboard Toggle word wrap

   • Ceph Object Gateway のすべてのインスタンスに対してバケットインデックスのリシャーディングを設定するには、rgw_override_bucket_index_max_shards パラメーターを global オプションで設定します。
   • Ceph Object Gateway の特定のインスタンスに対してのみバケットインデックスのリシャーディングを設定するには、インスタンスの下に rgw_override_bucket_index_max_shards パラメーターを追加します。

3. クラスター内のすべてのノードで Ceph Object Gateways を再起動して、有効にします。

   構文

   ceph orch restart SERVICE_TYPE

   Copy to Clipboard Toggle word wrap

   例

   [ceph: root#host01 /]# ceph orch restart rgw

   Copy to Clipboard Toggle word wrap

手順

1. 推奨されるシャード数を計算します。

   number of objects expected in a bucket / 100,000

   Copy to Clipboard Toggle word wrap
   注記

   現在サポートされているバケットインデックスシャードの最大数は 65,521 です。

2. ゾーングループ設定を zonegroup.json ファイルにデプロイメントします。

   例

   [ceph: root@host01 /]# radosgw-admin zonegroup get > zonegroup.json

   Copy to Clipboard Toggle word wrap

3. zonegroup.json ファイルで、名前付きゾーンごとに bucket_index_max_shards パラメーターを設定します。

   構文

   bucket_index_max_shards = VALUE

   Copy to Clipboard Toggle word wrap

   VALUE を、計算されたシャードの推奨数に置き換えます。

   例

   bucket_index_max_shards = 12

   Copy to Clipboard Toggle word wrap

4. ゾーングループをリセットします。

   例

   [ceph: root@host01 /]# radosgw-admin zonegroup set < zonegroup.json

   Copy to Clipboard Toggle word wrap

5. 期間を更新します。

   例

   [ceph: root@host01 /]# radosgw-admin period update --commit

   Copy to Clipboard Toggle word wrap

6. リシャーディングが完了したかどうかを確認します。

   構文

   radosgw-admin reshard status --bucket BUCKET_NAME

   Copy to Clipboard Toggle word wrap

   例

   [ceph: root@host01 /]# radosgw-admin reshard status --bucket data

   Copy to Clipboard Toggle word wrap

手順

1. rgw_dynamic_resharding パラメーターを true に設定します。

   例

   [ceph: root@host01 /]# radosgw-admin period get

   Copy to Clipboard Toggle word wrap

2. オプション: 次のコマンドを使用して、Ceph 設定をカスタマイズします。

   構文

   ceph config set client.rgw OPTION VALUE

   Copy to Clipboard Toggle word wrap

   OPTION を次のオプションに置き換えます。

   • rgw_reshard_num_logs: 再シャードログのシャードの数。デフォルト値は 16 です。
   • rgw_reshard_bucket_lock_duration: リシャード中にバケットのロックの期間。デフォルト値は 360 秒です。
   • rgw_dynamic_resharding: 動的リシャードを有効または無効にします。デフォルト値は true です。
   • rgw_max_objs_per_shard: シャードごとのオブジェクトの最大数。デフォルト値は、シャードごとに 100000 オブジェクトです。
   • rgw_reshard_thread_interval: 再シャード処理のラウンド間の最大時間。デフォルト値は 600 秒です。

   例

   [ceph: root@host01 /]# ceph config set client.rgw rgw_reshard_num_logs 23

   Copy to Clipboard Toggle word wrap

3. リシャーディングキューにバケットを追加します。

   構文

   radosgw-admin reshard add --bucket BUCKET --num-shards NUMBER

   Copy to Clipboard Toggle word wrap

   例

   [ceph: root@host01 /]# radosgw-admin reshard add --bucket data --num-shards 10

   Copy to Clipboard Toggle word wrap

4. リシャーディングキューを一覧表示します。

   例

   [ceph: root@host01 /]# radosgw-admin reshard list

   Copy to Clipboard Toggle word wrap

5. バケットログの世代とシャードを確認します。

   例

   [ceph: root@host01 /]# radosgw-admin bucket layout --bucket data
   {
       "layout": {
           "resharding": "None",
           "current_index": {
               "gen": 1,
               "layout": {
                   "type": "Normal",
                   "normal": {
                       "num_shards": 23,
                       "hash_type": "Mod"
                   }
               }
           },
           "logs": [
               {
                   "gen": 0,
                   "layout": {
                       "type": "InIndex",
                       "in_index": {
                           "gen": 0,
                           "layout": {
                               "num_shards": 11,
                               "hash_type": "Mod"
                           }
                       }
                   }
               },
               {
                   "gen": 1,
                   "layout": {
                       "type": "InIndex",
                       "in_index": {
                           "gen": 1,
                           "layout": {
                               "num_shards": 23,
                               "hash_type": "Mod"
                           }
                       }
                   }
               }
           ]
       }
   }

   Copy to Clipboard Toggle word wrap

6. バケットの再シャーディングステータスを確認するには、以下のコマンドを実行します。

   構文

   radosgw-admin reshard status --bucket BUCKET

   Copy to Clipboard Toggle word wrap

   例

   [ceph: root@host01 /]# radosgw-admin reshard status --bucket data

   Copy to Clipboard Toggle word wrap

7. リシャーディングキューのエントリーをすぐに処理します。

   [ceph: root@host01 /]# radosgw-admin reshard process

   Copy to Clipboard Toggle word wrap

8. 保留中のバケットのリシャーディングをキャンセルします:

   警告

   保留中 の再シャード操作のみをキャンセルできます。継続中 の再シャード操作をキャンセルしないでください。

   構文

   radosgw-admin reshard cancel --bucket BUCKET

   Copy to Clipboard Toggle word wrap

   例

   [ceph: root@host01 /]# radosgw-admin reshard cancel --bucket data

   Copy to Clipboard Toggle word wrap

手順

1. ゾーングループで resharding が有効になっているかどうかを確認します。

   例

   [ceph: root@host01 /]# radosgw-admin sync status

   Copy to Clipboard Toggle word wrap

   ゾーングループでの再シャーディング用に zonegroup features enabled が有効化されていない場合は、手順を続行してください。

2. Ceph Object Gateway がインストールされているマルチサイト設定のすべてのゾーングループで、resharding 機能を有効にします。

   構文

   radosgw-admin zonegroup modify --rgw-zonegroup=ZONEGROUP_NAME --enable-feature=resharding

   Copy to Clipboard Toggle word wrap

   例

   [ceph: root@host01 /]# radosgw-admin zonegroup modify --rgw-zonegroup=us --enable-feature=resharding

   Copy to Clipboard Toggle word wrap

3. 期間を更新してコミットします。

   例

   [ceph: root@host01 /]# radosgw-admin period update --commit

   Copy to Clipboard Toggle word wrap

4. Ceph Object Gateway がインストールされているマルチサイト設定のすべてのゾーンで、resharding 機能を有効にします。

   構文

   radosgw-admin zone modify --rgw-zone=ZONE_NAME --enable-feature=resharding

   Copy to Clipboard Toggle word wrap

   例

   [ceph: root@host01 /]# radosgw-admin zone modify --rgw-zone=us-east --enable-feature=resharding

   Copy to Clipboard Toggle word wrap

5. 期間を更新してコミットします。

   例

   [ceph: root@host01 /]# radosgw-admin period update --commit

   Copy to Clipboard Toggle word wrap

6. ゾーンおよびゾーングループで、resharding 機能が有効化されていることを確認します。各ゾーンが supported_features をリスト表示し、ゾーングループで enabled_features がリストされていることを確認できます。

   例

   [ceph: root@host01 /]# radosgw-admin period get
   
   "zones": [
                       {
                           "id": "505b48db-6de0-45d5-8208-8c98f7b1278d",
                           "name": "us_east",
                           "endpoints": [
                               "http://10.0.208.11:8080"
                           ],
                           "log_meta": "false",
                           "log_data": "true",
                           "bucket_index_max_shards": 11,
                           "read_only": "false",
                           "tier_type": "",
                           "sync_from_all": "true",
                           "sync_from": [],
                           "redirect_zone": "",
                           "supported_features": [
                               "resharding"
                           ]
                   "default_placement": "default-placement",
                   "realm_id": "26cf6f23-c3a0-4d57-aae4-9b0010ee55cc",
                   "sync_policy": {
                       "groups": []
                   },
                   "enabled_features": [
                       "resharding"
                   ]

   Copy to Clipboard Toggle word wrap

7. 同期のステータスを確認します。

   例

   [ceph: root@host01 /]# radosgw-admin sync status
             realm 26cf6f23-c3a0-4d57-aae4-9b0010ee55cc (usa)
         zonegroup 33a17718-6c77-493e-99fe-048d3110a06e (us)
              zone 505b48db-6de0-45d5-8208-8c98f7b1278d (us_east)
   zonegroup features enabled: resharding

   Copy to Clipboard Toggle word wrap

   この例では、resharding 機能が us ゾーングループに対して有効になっています。

8. オプション: ゾーングループの resharding 機能を無効にすることができます。

   重要

   任意の単一ゾーンで再シャーディングを無効にするには、その特定のゾーンで rgw_dynamic_resharding 設定オプションを false に設定します。

   1. Ceph Object Gateway がインストールされているマルチサイトのすべてのゾーングループで、機能を無効にします。

      構文

      radosgw-admin zonegroup modify --rgw-zonegroup=ZONEGROUP_NAME --disable-feature=resharding

      Copy to Clipboard Toggle word wrap

      例

      [ceph: root@host01 /]# radosgw-admin zonegroup modify --rgw-zonegroup=us --disable-feature=resharding

      Copy to Clipboard Toggle word wrap

   2. 期間を更新してコミットします。

      例

      [ceph: root@host01 /]# radosgw-admin period update --commit

      Copy to Clipboard Toggle word wrap

手順

1. 元のバケットインデックスをバックアップします。

   構文

   radosgw-admin bi list --bucket=BUCKET > BUCKET.list.backup

   Copy to Clipboard Toggle word wrap

   例

   [ceph: root@host01 /]# radosgw-admin bi list --bucket=data > data.list.backup

   Copy to Clipboard Toggle word wrap

2. バケットインデックスを再シャード化します。

   構文

   radosgw-admin bucket reshard --bucket=BUCKET --num-shards=NUMBER

   Copy to Clipboard Toggle word wrap

   例

   [ceph: root@host01 /]# radosgw-admin bucket reshard --bucket=data --num-shards=100

   Copy to Clipboard Toggle word wrap

手順

1. 古いインスタンスをリスト表示します。

   [ceph: root@host01 /]# radosgw-admin reshard stale-instances list

   Copy to Clipboard Toggle word wrap

2. バケットエントリーの古いインスタンスを消去します。

   [ceph: root@host01 /]# radosgw-admin reshard stale-instances rm

   Copy to Clipboard Toggle word wrap