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

手順

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

   number of objects expected in a bucket / 100,000

   注記

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

2. rgw_override_bucket_index_max_shards パラメーターを適宜設定します。

   構文

   ceph config set client.rgw rgw_override_bucket_index_max_shards VALUE

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

   例

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

   • 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

   例

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

手順

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

   number of objects expected in a bucket / 100,000

   注記

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

2. ゾーングループ設定を zonegroup.json ファイルに展開します。

   例

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

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

   構文

   bucket_index_max_shards = VALUE

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

   例

   bucket_index_max_shards = 12

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

   例

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

5. 期間を更新します。

   例

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

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

   構文

   radosgw-admin reshard status --bucket BUCKET_NAME

   例

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

手順

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

   例

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

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

   構文

   ceph config set client.rgw OPTION VALUE

   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

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

   構文

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

   例

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

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

   例

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

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"
                           }
                       }
                   }
               }
           ]
       }
   }

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

   構文

   radosgw-admin reshard status --bucket BUCKET

   例

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

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

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

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

   警告

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

   構文

   radosgw-admin reshard cancel --bucket BUCKET

   例

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

手順

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

   例

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

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

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

   構文

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

   例

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

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

   例

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

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

   構文

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

   例

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

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

   例

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

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"
                   ]

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

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

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

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

      構文

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

      例

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

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

      例

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

手順

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

   構文

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

   例

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

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

   構文

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

   例

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

手順

1. 古いインスタンスを一覧表示します。

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

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

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