3.9. バケット管理
ストレージ管理者は、Ceph Object Gateway を使用する場合は、バケットをユーザー間で移動して名前を変更することで、バケットを管理できます。また、ストレージクラスターの存続期間中に発生する可能性のある孤立したオブジェクトやリークオブジェクトを Ceph Object Gateway 内で見つけることができます。
3.9.1. バケットの移動
radosgw-admin bucket
ユーティリティーは、ユーザー間でバケットを移行する機能を提供します。これを実行するには、バケットを新規ユーザーにリンクし、バケットの所有権を新規ユーザーに変更します。
バケットを移動できます。
3.9.1.1. 前提条件
- 稼働中の Red Hat Ceph Storage クラスターがある。
- Ceph Object Gateway がインストールされている。
- バケット
- さまざまなテナントユーザーとテナントのないユーザー
3.9.1.2. テナントのないユーザー間でのバケットの移動
radosgw-admin bucket chown
コマンドは、バケットとそれに含まれるすべてのオブジェクトの所有権をあるユーザーから別のユーザーに変更する機能を提供します。これを行うには、バケットを現在のユーザーからリンク解除し、新しいユーザーにリンクして、バケットの所有権を新しいユーザーに変更します。
手順
バケットを新規ユーザーにリンクします。
radosgw-admin bucket link --uid=user --bucket=bucket
以下を置き換えます。
- user を、バケットをリンクするユーザーのユーザー名に
- bucket を、名前を持つバケットに
たとえば、
data
バケットをuser2
という名前のユーザーにリンクするには、以下を実行します。# radosgw-admin bucket link --uid=user2 --bucket=data
バケットが
user2
に正常にリンクされていることを確認します。# radosgw-admin bucket list --uid=user2 [ "data" ]
バケットの所有権を新規ユーザーに変更します。
radosgw-admin bucket chown --uid=user --bucket=bucket
以下を置き換えます。
- user を、バケットの所有権を変更するユーザーのユーザー名に
- bucket を、名前を持つバケットに
たとえば、
データ
バケットの所有権をuser2
に変更するには、以下を実行します。# radosgw-admin bucket chown --uid=user2 --bucket=data
次のコマンドの出力で
owner
行を確認して、data
バケットの所有権が正常に変更されたことを確認します。# radosgw-admin bucket list --bucket=data
3.9.1.3. テナントユーザー間でのバケットの移動
バケットは、あるテナントユーザーと別のテナントユーザーの間を移動できます。
手順
バケットを新規ユーザーにリンクします。
radosgw-admin bucket link --bucket=current-tenant/bucket --uid=new-tenant$user
置き換え:
- current-tenant を、バケットのテナントの名前に
- bucket リンクするバケットの名前に
- new-tenant を、新規ユーザーがあるテナントの名前に置き換えます。
- user を、新しいユーザーのユーザー名に
たとえば、
data
バケットを、test
テナントから、test2
テナントのuser2
という名前のユーザーにリンクします。# radosgw-admin bucket link --bucket=test/data --uid=test2$user2
バケットが
user2
に正常にリンクされていることを確認します。# radosgw-admin bucket list --uid=test$user2 [ "data" ]
バケットの所有権を新規ユーザーに変更します。
radosgw-admin bucket chown --bucket=new-tenant/bucket --uid=new-tenant$user
以下を置き換えます。
- bucket リンクするバケットの名前に
- new-tenant を、新規ユーザーがあるテナントの名前に置き換えます。
- user を、新しいユーザーのユーザー名に
たとえば、
data
バケットの所有権をtest2
テナント内のuser2
に変更するには、次のようにします。# radosgw-admin bucket chown --bucket='test2/data' --uid='test$tuser2'
次のコマンドの出力で
owner
行を確認して、data
バケットの所有権が正常に変更されたことを確認します。# radosgw-admin bucket list --bucket=test2/data
3.9.1.4. バケットをテナントのないユーザーからテナントユーザーに移動する
バケットをテナントのないユーザーからテナントユーザーに移動できます。
手順
任意です。まだ複数のテナントがない場合は、
rgw_keystone_implicit_tenants
を有効にして、外部テナントから Ceph Object Gateway にアクセスすることでテナントを作成できます。Ceph 設定ファイル (デフォルトでは
/etc/ceph/ceph.conf
) を開き、編集します。rgw_keystone_implicit_tenants
オプションを有効にします。rgw_keystone_implicit_tenants = true
s3cmd
コマンドまたはswift
コマンドのいずれかを使用して、一時テナントから Ceph Object Gateway にアクセスします。# swift list
または、
s3cmd
を使用します。# s3cmd ls
外部テナントからの最初のアクセスにより、同等の Ceph Object Gateway ユーザーが作成されます。
バケットをテナントされたユーザーに移動します。
radosgw-admin bucket link --bucket=/bucket --uid='tenant$user'
置き換え:
- bucket を、名前を持つバケットに
- tenant を、新規ユーザーがあるテナントの名前に
- user を、新しいユーザーのユーザー名に
たとえば、
data
バケットをtest
テナント内のtenanted-user
に移動するには、以下を実行します。# radosgw-admin bucket link --bucket=/data --uid='test$tenanted-user'
data
バケットがtenanted-user
に正常にリンクされていることを確認します。# radosgw-admin bucket list --uid='test$tenanted-user' [ "data" ]
バケットの所有権を新規ユーザーに変更します。
radosgw-admin bucket chown --bucket='tenant/bucket name' --uid='tenant$user'
置き換え:
- bucket を、名前を持つバケットに
- tenant を、新規ユーザーがあるテナントの名前に
- user を、新しいユーザーのユーザー名に
たとえば、
data
バケットの所有権を、test
テナント内にあるtenanted-user
に変更するには、以下を実行します。# radosgw-admin bucket chown --bucket='test/data' --uid='test$tenanted-user'
次のコマンドの出力で
owner
行を確認して、data
バケットの所有権が正常に変更されたことを確認します。# radosgw-admin bucket list --bucket=test/data
3.9.2. バケットの名前変更
バケットの名前を変更できます。
前提条件
- 稼働中の Red Hat Ceph Storage クラスターがある。
- Ceph Object Gateway がインストールされている。
- バケットがある。
手順
バケットを一覧表示します。
radosgw-admin bucket list
たとえば、出力からのバケットに注意してください。
# radosgw-admin bucket list [ "34150b2e9174475db8e191c188e920f6/swcontainer", "s3bucket1", "34150b2e9174475db8e191c188e920f6/swimpfalse", "c278edd68cfb4705bb3e07837c7ad1a8/ec2container", "c278edd68cfb4705bb3e07837c7ad1a8/demoten1", "c278edd68cfb4705bb3e07837c7ad1a8/demo-ct", "c278edd68cfb4705bb3e07837c7ad1a8/demopostup", "34150b2e9174475db8e191c188e920f6/postimpfalse", "c278edd68cfb4705bb3e07837c7ad1a8/demoten2", "c278edd68cfb4705bb3e07837c7ad1a8/postupsw" ]
バケットの名前を変更します。
radosgw-admin bucket link --bucket=original-name --bucket-new-name=new-name --uid=user-ID
たとえば、
s3bucket1
バケットの名前をs3newb
に変更するには、以下を実行します。# radosgw-admin bucket link --bucket=s3bucket1 --bucket-new-name=s3newb --uid=testuser
バケットがテナント内部にある場合は、テナントも指定します。
radosgw-admin bucket link --bucket=tenant/original-name --bucket-new-name=new-name --uid=tenant$user-ID
以下に例を示します。
# radosgw-admin bucket link --bucket=test/s3bucket1 --bucket-new-name=s3newb --uid=test$testuser
バケットの名前が変更されたことを確認します。
radosgw-admin bucket list
たとえば、
s3newb
という名前のバケットが存在するようになりました。# radosgw-admin bucket list [ "34150b2e9174475db8e191c188e920f6/swcontainer", "34150b2e9174475db8e191c188e920f6/swimpfalse", "c278edd68cfb4705bb3e07837c7ad1a8/ec2container", "s3newb", "c278edd68cfb4705bb3e07837c7ad1a8/demoten1", "c278edd68cfb4705bb3e07837c7ad1a8/demo-ct", "c278edd68cfb4705bb3e07837c7ad1a8/demopostup", "34150b2e9174475db8e191c188e920f6/postimpfalse", "c278edd68cfb4705bb3e07837c7ad1a8/demoten2", "c278edd68cfb4705bb3e07837c7ad1a8/postupsw" ]
3.9.3. 孤立したオブジェクトやリークオブジェクトを見つける
正常なストレージクラスターには孤立したオブジェクトやリークオブジェクトがありませんが、場合によっては、孤立したオブジェクトやリークオブジェクトが発生する可能性があります。たとえば、Ceph Object Gateway が操作の途中でダウンした場合、一部のオブジェクトが孤立する原因となる可能性があります。また、検出されないバグでも、孤立したオブジェクトが発生する可能性があります。
Red Hat Ceph Storage 4.1 以降、ストレージ管理者は Ceph Object Gateway オブジェクトが RADOS オブジェクトにマップする方法を確認できます。radosgw-admin
コマンドは、これらの潜在的な孤立オブジェクトまたはリークオブジェクトの一覧を検索して生成するための新しいツールを提供します。radoslist
サブコマンドを使用すると、バケット内またはストレージクラスター内のすべてのバケットに保存されているオブジェクトが表示されます。rgw-orphan-list
スクリプトは、プール内の孤立したオブジェクトを表示します。
rgw-orphan-list
コマンドは、まだ実験段階にあります。rados rm
command コマンドを使用して削除する前に、一覧表示されているオブジェクトを慎重かつ注意して評価してください。
radoslist
サブコマンドは、非推奨の orphans find
サブコマンドおよび orphans finish
サブコマンドを置き換えます。
前提条件
- 稼働中の Red Hat Ceph Storage クラスターがある。
- 実行中の Ceph Object Gateway。
手順
バケット内でデータを保持するオブジェクトの一覧を生成するには、以下を実行します。
構文
radosgw-admin bucket radoslist --bucket BUCKET_NAME
例
[root@rgw ~]# radosgw-admin bucket radoslist --bucket mybucket
注記BUCKET_NAME を省略すると、すべてのバケット内のすべてのオブジェクトが表示されます。
プールの孤立一覧を生成するには、以下を実行します。
[root@rgw ~]# 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
コマンドを使用する場合は、データプールを指定する必要があります。- リスト内の孤立オブジェクトを確認します。
孤立したオブジェクトを削除するには、以下を実行します。
構文
rados -p POOL_NAME rm OBJECT_NAME
例
[root@rgw ~]# rados -p default.rgw.buckets.data rm myobject
警告正しいオブジェクトを削除していることを確認してください。
rados rm
コマンドを実行すると、ストレージクラスターからデータが削除されます。
関連情報
-
従来の
radosgw-admin orphans find
サブコマンドに関する詳細は、Red Hat Ceph Storage 3 Object Gateway Administration Guideの Finding Orphan Objects セクションを参照してください。
3.9.4. バケットインデックスエントリーの管理
radosgw-admin bucket check
サブコマンドを使用して、Red Hat Ceph Storage クラスターで Ceph Object Gateway のバケットインデックスエントリーを管理できます。
マルチパートアップロードオブジェクトの一部に関連する各バケットインデックスエントリーは、対応する .meta
インデックスエントリーと照合されます。特定のマルチパートアップロードのすべての部分に .meta
エントリーが必要です。ピースに対応する .meta
エントリーが見つからない場合、出力のセクションに孤立したエントリーが一覧表示されます。
バケットの統計はバケットインデックスヘッダーに保存されます。このフェーズでは、これらのヘッダーをロードし、バケットインデックスのすべてのプレーンオブジェクトエントリーを繰り返し処理し、統計を再計算します。次に、それぞれ existing_header と calculated_header というラベルの付いたセクションに実際の統計と計算した統計を表示して、比較できるようにします。
バケットチェック
サブコマンドで --fix
オプションを使用すると、孤立したエントリーがバケットインデックスから削除され、ヘッダー内の既存の統計が計算された統計で上書きされます。これにより、バージョン管理で使用される複数のエントリーを含むすべてのエントリーが出力の セクションに一覧表示されます。
前提条件
- 稼働中の Red Hat Ceph Storage クラスターがある。
- 実行中の Ceph Object Gateway。
- バケットが作成されている。
手順
特定のバケットのバケットインデックスを確認します。
構文
radosgw-admin bucket check --bucket=BUCKET_NAME
例
[root@rgw ~]# radosgw-admin bucket check --bucket=mybucket
孤立したオブジェクトの削除など、バケットインデックスの不整合を修正します。
構文
radosgw-admin bucket check --fix --bucket=BUCKET_NAME
例
[root@rgw ~]# radosgw-admin bucket check --fix --bucket=mybucket
3.9.5. バケット通知
バケット通知により、バケットで特定のイベントが発生した場合に、Ceph Object Gateway から情報を送る方法が提供されます。バケット通知は HTTP、AMQP0.9.1、および Kafka エンドポイントに送信できます。
特定バケットおよび特定のトピック上のイベントのバケット通知を送信するために、通知エントリーを作成する必要があります。バケット通知は、イベントタイプのサブセットに作成することも、デフォルトですべてのイベントタイプに対して作成できます。バケット通知は、キーの接頭辞または接尾辞、キーに一致する正規表現、オブジェクトに割り当てられたメタデータ属性、またはオブジェクトタグに基づいてイベントをフィルタリングできます。バケット通知には、バケット通知メカニズムの設定および制御インターフェイスを提供する REST API があります。
バケット通知 API はデフォルトで有効にされます。rgw_enable_apis
設定パラメーターが明示的に設定されている場合は、s3
および pubsub
が含まれていることを確認します。これを確認するには、ceph config get mon.* rgw_enable_apis
コマンドを実行します。
関連情報
- バケット通知 REST API についての詳細は、Red Hat Ceph Storage 開発者ガイド を参照してください。
3.9.6. バケット通知の作成
バケットレベルでバケット通知を作成します。通知設定には、Red Hat Ceph Storage Object Gateway S3 イベント (ObjectCreated
および ObjectRemoved
) があります。これらは公開され、バケット通知を送信する宛先である必要があります。バケット通知は S3 オペレーションです。
前提条件
- 稼働中の Red Hat Ceph Storage クラスターがある。
- 稼働中の HTTP サーバー、RabbitMQ サーバー、または Kafka サーバー。
- ルートレベルのアクセス。
- Red Hat Ceph Storage Object Gateway のインストール
- ユーザーアクセスキーおよびシークレットキー。
- エンドポイントパラメーター。
Red Hat は、ObjectCreate
イベント (例: put
、post
、multipartUpload
、および copy
) をサポートします。また、Red Hat は、object_delete
、s3_multi_object_delete
などの ObjectRemove
イベントをサポートしています。
手順
- s3 バケットを作成します。
-
http
、amqp
、またはkafka
プロトコルに SNS トピックを作成します。 s3:objectCreate
およびs3:objectRemove
イベントの s3 バケット通知を作成します。例
client.put_bucket_notification_configuration( Bucket=bucket_name, NotificationConfiguration={ 'TopicConfigurations': [ { 'Id': notification_name, 'TopicArn': topic_arn, 'Events': ['s3:ObjectCreated:*', 's3:ObjectRemoved:*'] }]})
- バケットに s3 オブジェクトを作成します。
-
レシーバー
http
、rabbitmq
、またはkafka
でのオブジェクト作成イベントを確認します。 - オブジェクトを削除します。
-
レシーバー
http
、rabbitmq
、またはkafka
でオブジェクトの削除イベントを確認します。
3.9.7. 関連情報
- 詳細は、ユーザーを認証するためのキーストーンの使用 を参照してください。
- 詳細は、Red Hat Ceph Storage 開発者ガイド を参照してください。