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 行を確認して、data バケットの所有権が正常に変更されたことを確認します。

   例

   [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 行を確認して、data バケットの所有権が正常に変更されたことを確認します。

   [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. data バケットが 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 行を確認して、data バケットの所有権が正常に変更されたことを確認します。

   例

   [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. orphan のリストを生成する必要があるディレクトリーを作成します。

   例

   [root@host01 ~]# mkdir orphans

4. 前に作成したディレクトリーに移動します。

   例

   [root@host01 ~]# cd orphans

5. プールリストから、orphans を検索するプールを選択します。このスクリプトは、クラスター内のオブジェクトによっては長時間実行される可能性があります。

   例

   [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 ツールの使用の詳細を表示します。

   構文

   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 プロトコルに SNS トピックを作成します。

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 バケットレプリケーションを作成します。

   構文

   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. sync policy get コマンドを使用して、同期ポリシーを確認します。

   構文

   radosgw-admin sync policy get --bucket BUCKET_NAME

   注記

   レプリケーションポリシーを適用すると、ルールは パイプ と呼ばれる同期ポリシールールに変換され、enabled と disabled に分類されます。

   • Enabled: パイプは有効かつアクティブであり、グループステータスは 'rgw_sync_policy_group:STATUS' に設定されています。たとえば、s3-bucket-replication:enabled です。
   • Disabled: この配下のパイプは非アクティブで、グループステータスは 'rgw_sync_policy_group:STATUS' に設定されています。たとえば、s3-bucket-replication:disabled です。

   複数のルールをレプリケーションポリシーの一部として設定できるため、各グループを正確にマッピングするために 2 つの異なるグループ (1 つは 'enabled' の状態、もう 1 つは 'allowed' の状態) があります。

   例

   [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 へのユーザーアクセスを無効にします。

   構文

   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