9.7. 버킷 관리

프로세스

1. 버킷을 새 사용자에게 연결합니다.

   구문

   radosgw-admin bucket link --uid=USER --bucket=BUCKET

   예제

   [ceph: root@host01 /]# radosgw-admin bucket link --uid=user2 --bucket=data

2. 버킷이 user2 에 성공적으로 연결되었는지 확인합니다.

   예제

   [ceph: root@host01 /]# radosgw-admin bucket list --uid=user2
   [
       "data"
   ]

3. 버킷의 소유권을 새 사용자로 변경합니다.

   구문

   radosgw-admin bucket chown --uid=user --bucket=bucket

   예제

   [ceph: root@host01 /]# radosgw-admin bucket chown --uid=user2 --bucket=data

4. 다음 명령의 출력에서 owner 행을 확인하여 데이터 버킷의 소유권이 성공적으로 변경되었는지 확인합니다.

   예제

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

프로세스

1. 버킷을 새 사용자에게 연결합니다.

   구문

   radosgw-admin bucket link --bucket=CURRENT_TENANT/BUCKET --uid=NEW_TENANT$USER

   예제

   [ceph: root@host01 /]# radosgw-admin bucket link --bucket=test/data --uid=test2$user2

2. 버킷이 user2 에 성공적으로 연결되었는지 확인합니다.

   [ceph: root@host01 /]# radosgw-admin bucket list --uid=test$user2
   [
       "data"
   ]

3. 버킷의 소유권을 새 사용자로 변경합니다.

   구문

   radosgw-admin bucket chown --bucket=NEW_TENANT/BUCKET --uid=NEW_TENANT$USER

   예제

   [ceph: root@host01 /]# radosgw-admin bucket chown --bucket='test2/data' --uid='test$tuser2'

4. 다음 명령의 출력에서 owner 행을 확인하여 데이터 버킷의 소유권이 성공적으로 변경되었는지 확인합니다.

   [ceph: root@host01 /]# radosgw-admin bucket list --bucket=test2/data

프로세스

1. 선택 사항: 테넌트가 여러 개 없는 경우 rgw_keystone_implicit_tenants 를 활성화하고 외부 테넌트에서 Ceph Object Gateway에 액세스하여 생성할 수 있습니다.

   rgw_keystone_implicit_tenants 옵션을 활성화합니다.

   예제

   [ceph: root@host01 /]# ceph config set client.rgw rgw_keystone_implicit_tenants true

   s3cmd 또는 swift 명령을 사용하여 테넌트에서 Ceph Object Gateway에 액세스합니다.

   예제

   [ceph: root@host01 /]# swift list

   또는 s3cmd 를 사용하십시오.

   예제

   [ceph: root@host01 /]# s3cmd ls

   외부 테넌트에서 첫 번째 액세스 권한은 동일한 Ceph Object Gateway 사용자를 생성합니다.

2. 버킷을 테넌트 사용자로 이동합니다.

   구문

   radosgw-admin bucket link --bucket=/BUCKET --uid='TENANT$USER'

   예제

   [ceph: root@host01 /]# radosgw-admin bucket link --bucket=/data --uid='test$tenanted-user'

3. 데이터 버킷이 tenanted-user 에 성공적으로 연결되었는지 확인합니다.

   예제

   [ceph: root@host01 /]# radosgw-admin bucket list --uid='test$tenanted-user'
   [
       "data"
   ]

4. 버킷의 소유권을 새 사용자로 변경합니다.

   구문

   radosgw-admin bucket chown --bucket='tenant/bucket name' --uid='tenant$user'

   예제

   [ceph: root@host01 /]# radosgw-admin bucket chown --bucket='test/data' --uid='test$tenanted-user'

5. 다음 명령의 출력에서 owner 행을 확인하여 데이터 버킷의 소유권이 성공적으로 변경되었는지 확인합니다.

   예제

   [ceph: root@host01 /]# radosgw-admin bucket list --bucket=test/data

프로세스

1. 버킷 내에 데이터를 보관하는 오브젝트 목록을 생성합니다.

   구문

   radosgw-admin bucket radoslist --bucket BUCKET_NAME

   예제

   [root@host01 ~]# radosgw-admin bucket radoslist --bucket mybucket

   참고

   BUCKET_NAME 을 생략하면 모든 버킷의 모든 오브젝트가 표시됩니다.

2. rgw-orphan-list 의 버전을 확인합니다.

   예제

   [root@host01 ~]# head /usr/bin/rgw-orphan-list

   버전은 2023-01-11 이상이어야 합니다.

3. 고립 목록을 생성해야 하는 디렉토리를 만듭니다.

   예제

   [root@host01 ~]# mkdir orphans

4. 이전에 만든 디렉터리로 이동합니다.

   예제

   [root@host01 ~]# cd orphans

5. 풀 목록에서 고립을 찾을 풀을 선택합니다. 이 스크립트는 클러스터의 오브젝트에 따라 오랫동안 실행될 수 있습니다.

   예제

   [root@host01 orphans]# rgw-orphan-list

   예제

   Available pools:
       .rgw.root
       default.rgw.control
       default.rgw.meta
       default.rgw.log
       default.rgw.buckets.index
       default.rgw.buckets.data
       rbd
       default.rgw.buckets.non-ec
       ma.rgw.control
       ma.rgw.meta
       ma.rgw.log
       ma.rgw.buckets.index
       ma.rgw.buckets.data
       ma.rgw.buckets.non-ec
   Which pool do you want to search for orphans?

   고립을 검색할 풀 이름을 입력합니다.

   중요

   메타데이터 풀이 아닌 rgw-orphan-list 명령을 사용할 때 데이터 풀을 지정해야 합니다.

6. rgw-orphan-list 툴 사용량의 세부 정보를 확인합니다.

   Synatx

   rgw-orphan-list -h
   rgw-orphan-list POOL_NAME /DIRECTORY

   예제

   [root@host01 orphans]# rgw-orphan-list default.rgw.buckets.data /orphans
   
   2023-09-12 08:41:14 ceph-host01 Computing delta...
   2023-09-12 08:41:14 ceph-host01 Computing results...
   10 potential orphans found out of a possible 2412 (0%).         <<<<<<< orphans detected
   The results can be found in './orphan-list-20230912124113.out'.
       Intermediate files are './rados-20230912124113.intermediate' and './radosgw-admin-20230912124113.intermediate'.
   ***
   *** WARNING: This is EXPERIMENTAL code and the results should be used
   ***          only with CAUTION!
   ***
   Done at 2023-09-12 08:41:14.

7. ls -l 명령을 실행하여 오류로 끝나는 파일이 문제 없이 실행되었음을 나타내는 0 길이여야 하는지 확인합니다.

   예제

   [root@host01 orphans]# ls -l
   
   -rw-r--r--. 1 root root    770 Sep 12 03:59 orphan-list-20230912075939.out
   -rw-r--r--. 1 root root      0 Sep 12 03:59 rados-20230912075939.error
   -rw-r--r--. 1 root root 248508 Sep 12 03:59 rados-20230912075939.intermediate
   -rw-r--r--. 1 root root      0 Sep 12 03:59 rados-20230912075939.issues
   -rw-r--r--. 1 root root      0 Sep 12 03:59 radosgw-admin-20230912075939.error
   -rw-r--r--. 1 root root 247738 Sep 12 03:59 radosgw-admin-20230912075939.intermediate

8. 나열된 고립 오브젝트를 검토합니다.

   예제

   [root@host01 orphans]# cat ./orphan-list-20230912124113.out
   
   a9c042bc-be24-412c-9052-dda6b2f01f55.16749.1_key1.cherylf.433-bucky-4865-0.0
   a9c042bc-be24-412c-9052-dda6b2f01f55.16749.1_key1.cherylf.433-bucky-4865-0.1
   a9c042bc-be24-412c-9052-dda6b2f01f55.16749.1_key1.cherylf.433-bucky-4865-0.2
   a9c042bc-be24-412c-9052-dda6b2f01f55.16749.1_key1.cherylf.433-bucky-4865-0.3
   a9c042bc-be24-412c-9052-dda6b2f01f55.16749.1_key1.cherylf.433-bucky-4865-0.4
   a9c042bc-be24-412c-9052-dda6b2f01f55.16749.1_key1.cherylf.433-bucky-4865-0.5
   a9c042bc-be24-412c-9052-dda6b2f01f55.16749.1_key1.cherylf.433-bucky-4865-0.6
   a9c042bc-be24-412c-9052-dda6b2f01f55.16749.1_key1.cherylf.433-bucky-4865-0.7
   a9c042bc-be24-412c-9052-dda6b2f01f55.16749.1_key1.cherylf.433-bucky-4865-0.8
   a9c042bc-be24-412c-9052-dda6b2f01f55.16749.1_key1.cherylf.433-bucky-4865-0.9

9. 고립 오브젝트를 제거합니다.

   구문

   rados -p POOL_NAME rm OBJECT_NAME

   예제

   [root@host01 orphans]# rados -p default.rgw.buckets.data rm myobject

   주의

   올바른 오브젝트를 제거 중인지 확인합니다. rados rm 명령을 실행하면 스토리지 클러스터에서 데이터가 제거됩니다.

프로세스

1. 특정 버킷의 버킷 인덱스를 확인합니다.

   구문

   radosgw-admin bucket check --bucket=BUCKET_NAME

   예제

   [root@rgw ~]# radosgw-admin bucket check --bucket=mybucket

2. 분리된 오브젝트 제거를 포함하여 버킷 인덱스의 불일치를 수정합니다.

   구문

   radosgw-admin bucket check --fix --bucket=BUCKET_NAME

   예제

   [root@rgw ~]# radosgw-admin bucket check --fix --bucket=mybucket

프로세스

1. S3 버킷을 생성합니다.
2. http,amqp 또는 kafka 프로토콜에 대한 Cryostat 주제를 만듭니다.

3. s3:objectCreate,s3:objectRemove, s3:ObjectLifecycle:Expiration 이벤트에 대한 S3 버킷 알림을 생성합니다.

   예제

   client.put_bucket_notification_configuration(
      Bucket=bucket_name,
      NotificationConfiguration={
          'TopicConfigurations': [
              {
                  'Id': notification_name,
                  'TopicArn': topic_arn,
                  'Events': ['s3:ObjectCreated:*', 's3:ObjectRemoved:*', 's3:ObjectLifecycle:Expiration:*']
              }]})

4. 버킷에 S3 오브젝트를 생성합니다.
5. http,rabbitmq 또는 kafka 수신자에서 오브젝트 생성 이벤트를 확인합니다.
6. 오브젝트를 삭제합니다.
7. http,rabbitmq 또는 kafka 수신자에서 오브젝트 삭제 이벤트를 확인합니다.

프로세스

1. 복제의 세부 정보가 포함된 복제 구성 파일을 만듭니다.

   구문

   {
   "Role": "arn:aws:iam::account-id:role/role-name",
       "Rules": [
           {
               "ID": "String",
               "Status": "Enabled",
               "Priority": 1,
               "DeleteMarkerReplication": { "Status": "Enabled"|"Disabled" },
               "Destination": {
                   "Bucket": "BUCKET_NAME"
               }
           }
       ]
   }

   예제

   [root@host01 ~]# cat replication.json
   {
       "Role": "arn:aws:iam::account-id:role/role-name",
       "Rules": [
           {
               "ID": "pipe-bkt",
               "Status": "Enabled",
               "Priority": 1,
               "DeleteMarkerReplication": { "Status": "Disabled" },
               "Destination": {
                   "Bucket": "testbucket"
               }
           }
       ]
   }

2. S3 API put bucket 복제를 생성합니다.

   구문

   aws --endpoint-url=RADOSGW_ENDPOINT_URL s3api put-bucket-replication --bucket BUCKET_NAME --replication-configuration file://REPLICATION_CONFIIRATION_FILE.json

   예제

   [root@host01 ~]# aws --endpoint-url=http://host01:80 s3api put-bucket-replication --bucket testbucket --replication-configuration file://replication.json

검증

1. 동기화 정책 get 명령을 사용하여 동기화 정책을 확인합니다.

   구문

   radosgw-admin sync policy get --bucket BUCKET_NAME

   참고

   복제 정책을 적용할 때 규칙은 파이프 라고 하는 sync-policy 규칙으로 변환되며 활성화 및 비활성화 됨으로 분류됩니다.

   • enabled: 이 파이프는 활성화되고 활성 상태이며 그룹 상태는 'rgw_sync_policy_group:STATUS'로 설정됩니다. 예를 들어s3-bucket-replication:enabled.
   • disabled: 이 세트의 파이프는 활성 상태가 아니며 그룹 상태는 'rgw_sync_policy_group:STATUS'로 설정됩니다. 예를 들어 s3-bucket-replication:disabled.

   복제 정책의 일부로 구성할 수 있는 규칙이 여러 개 있을 수 있으므로 각 그룹의 정확한 매핑을 위해 두 개의 개별 그룹('enabled' 및 '허용됨' 상태의 다른 그룹)이 있습니다.

   예제

   [ceph: root@host01 /]# radosgw-admin sync policy get --bucket testbucket
   {
       "groups": [
           {
               "id": "s3-bucket-replication:disabled",
               "data_flow": {},
               "pipes": [],
               "status": "allowed"
           },
           {
               "id": "s3-bucket-replication:enabled",
               "data_flow": {},
               "pipes": [
                   {
                       "id": "",
                       "source": {
                           "bucket": "*",
                           "zones": [
                               "*"
                           ]
                       },
                       "dest": {
                           "bucket": "testbucket",
                           "zones": [
                               "*"
                           ]
                       },
                       "params": {
                           "source": {},
                           "dest": {},
                           "priority": 1,
                           "mode": "user",
                           "user": "s3cmd"
                       }
                   }
               ],
               "status": "enabled"
           }
       ]
   }

프로세스

1. S3 API put 버킷 복제를 삭제합니다.

   구문

   aws s3api delete-bucket-replication --bucket BUCKET_NAME --endpoint-url=RADOSGW_ENDPOINT_URL

   예제

   [root@host01 ~]# aws s3api delete-bucket-replication --bucket testbucket --endpoint-url=http://host01:80

프로세스

1. S3 버킷 복제 API에 대한 액세스를 거부하려면 사용자 정책 구성 파일을 생성합니다.

   예제

   [root@host01 ~]# cat user_policy.json
   {
   	"Version":"2012-10-17",
   	"Statement":
   	{
   		"Effect":"Deny",
   		"Action":
   		[
   			"s3:PutReplicationConfiguration",
   			"s3:GetReplicationConfiguration",
   			"s3:DeleteReplicationConfiguration"
   		],
   		"Resource": "arn:aws:s3:::*",
   	}
   }

2. 관리자 권한으로 S3 API에 대한 사용자 액세스를 비활성화하려면 사용자 정책을 user로 설정합니다.

   구문

   aws --endpoint-url=ENDPOINT_URL iam put-user-policy --user-name USER_NAME --policy-name USER_POLICY_NAME --policy-document POLICY_DOCUMENT_PATH

   예제

   [root@host01 ~]# aws --endpoint-url=http://host01:80 iam put-user-policy --user-name newuser1 --policy-name userpolicy --policy-document file://user_policy.json