9.3. 버킷 인덱스 재하드 구성

프로세스

1. 권장 shard 수를 계산합니다.

   number of objects expected in a bucket / 100,000

   참고

   현재 지원되는 최대 버킷 인덱스 shard 수는 65,521입니다.

2. 그에 따라 rgw_override_bucket_index_max_shards 옵션을 설정합니다.

   구문

   ceph config set client.rgw rgw_override_bucket_index_max_shards VALUE

   VALUE 를 계산된 권장 shard 수로 바꿉니다.

   예제

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

   • Ceph Object Gateway의 모든 인스턴스에 대해 버킷 인덱스 재하드를 구성하려면 글로벌 옵션을 사용하여 rgw_override_bucket_index_max_shards 매개변수를 설정합니다.
   • Ceph Object Gateway의 특정 인스턴스에 대해서만 버킷 인덱스 재하드를 구성하려면 인스턴스에 rgw_override_bucket_index_max_shards 매개변수를 추가합니다.

3. 클러스터의 모든 노드에서 Ceph Object Gateway를 다시 시작하여 적용합니다.

   구문

   ceph orch restart SERVICE_TYPE

   예제

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

프로세스

1. 권장 shard 수를 계산합니다.

   number of objects expected in a bucket / 100,000

   참고

   현재 지원되는 최대 버킷 인덱스 shard 수는 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 를 계산된 권장 shard 수로 바꿉니다.

   예제

   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: resharding 로그의 shard 수입니다. 기본값은 16 입니다.
   • rgw_reshard_bucket_lock_duration: 재하드하는 동안 버킷에 있는 잠금 기간입니다. 기본값은 360 초입니다.
   • rgw_dynamic_resharding: 동적 재하드를 활성화하거나 비활성화합니다. 기본값은 true입니다.
   • rgw_max_objs_per_shard: shard당 최대 오브젝트 수입니다. 기본값은 shard당 100000 오브젝트입니다.
   • rgw_reshard_thread_interval: reshard 스레드 처리의 라운드 사이의 최대 시간입니다. 기본값은 600 초입니다.

   예제

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

3. resharding 큐에 버킷을 추가합니다.

   구문

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

   예제

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

4. resharding 큐를 나열합니다.

   예제

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

5. 버킷 로그 생성 및 shard를 확인합니다.

   예제

   [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. resharding 대기열의 즉시 프로세스 항목:

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

8. 보류 중인 버킷 재하드를 취소합니다.

   주의

   보류 중인 재하드 작업만 취소할 수 있습니다. 진행 중인 재하드 작업을 취소하지 마십시오.

   구문

   radosgw-admin reshard cancel --bucket BUCKET

   예제

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

프로세스

1. zonegroup에서 resharding 이 활성화되어 있는지 확인합니다.

   예제

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

   zonegroup에서 재하드하는 데 영역 그룹 기능이 활성화되지 않은 경우 절차를 계속합니다.

2. Ceph Object Gateway가 설치된 다중 사이트 구성의 모든 영역 그룹에서 재하드 기능을 활성화합니다.

   구문

   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 가 나열되고 zonegroups가 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

   이 예에서는 us zonegroup에 대해 resharding 기능이 활성화됩니다.

8. 선택 사항: 영역 그룹의 복구 기능을 비활성화 할 수 있습니다.

   중요

   단일 영역에서 재하드를 비활성화하려면 해당 특정 영역에서 rgw_dynamic_resharding 구성 옵션을 false 로 설정합니다.

   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