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

   Expand

   表9.1 動的リシャーディングのための Ceph 設定オプション

   パラメーターオプション	説明	デフォルト値
   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
   rgw_dynamic_resharding_may_reduce	Red Hat Ceph Storage 8.1 以降でサポートされています。動的リシャーディング中にシャード削減を許可するには、true に設定します。動的リシャーディングの場合は、rgw_dynamic_reshard を true に設定して使用する必要があります。	true
   rgw_dynamic_resharding_reduction_wait	Red Hat Ceph Storage 8.1 以降でサポートされています。削減対象のバケットを識別した後、削減を実行するまでの待機時間 (時間単位) を定義します。このオプションは、オブジェクト数の変動による継続的なリシャーディングを防ぐための保護メカニズムを提供します。 注意: 値が小さいと、オブジェクト数が頻繁に変動するバケットで、クラスターのパフォーマンスに影響を与える可能性があります。	120

   Show more

   例

   [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