8.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 でオブジェクトの削除イベントを確認します。