開発者ガイド

手順

1. 以下の要求形式でトピックを作成します。

   構文

   POST
   Action=CreateTopic
   &Name=TOPIC_NAME
   [&Attributes.entry.1.key=amqp-exchange&Attributes.entry.1.value=EXCHANGE]
   [&Attributes.entry.2.key=amqp-ack-level&Attributes.entry.2.value=none|broker|routable]
   [&Attributes.entry.3.key=verify-ssl&Attributes.entry.3.value=true|false]
   [&Attributes.entry.4.key=kafka-ack-level&Attributes.entry.4.value=none|broker]
   [&Attributes.entry.5.key=use-ssl&Attributes.entry.5.value=true|false]
   [&Attributes.entry.6.key=ca-location&Attributes.entry.6.value=FILE_PATH]
   [&Attributes.entry.7.key=OpaqueData&Attributes.entry.7.value=OPAQUE_DATA]
   [&Attributes.entry.8.key=push-endpoint&Attributes.entry.8.value=ENDPOINT]

   リクエストパラメーターを以下に示します。

   • Endpoint: 通知を送信するエンドポイントの URL。
   • OpaqueData: 不透明なデータはトピック設定で設定され、トピックによって発生するすべての通知に追加されます。

   • HTTP エンドポイント:

     • URL: http[s]://FQDN[: PORT ]
     • ポートのデフォルト: HTTP または HTTPS にそれぞれ 80 または 443 を使用します。
     • verify-ssl: サーバー証明書がクライアントによって検証されているかどうかを示します。デフォルトでは true です。

   • AMQP0.9.1 エンドポイント:

     • URL: amqp://[USER : PASSWORD @] FQDN [: PORT][/VHOST].
     • ユーザーおよびグループのデフォルト値はそれぞれ guest と guest です。
     • ユーザーおよびパスワードは、HTTPS でのみ提供できます。そうしないと、トピック作成要求は拒否されます。
     • Port のデフォルト値 は 5672 です。
     • vhost のデフォルトは/です。
     • amqp-exchange: 交換は存在し、トピックに基づいてメッセージをルーティングできる必要があります。これは AMQP0.9.1 の必須パラメーターです。同じエンドポイントを参照するさまざまなトピックが同じ交換を使用する必要があります。

     • amqp-ack-level: 最終宛先に送信される前にメッセージがブローカーで永続化される可能性があるため、終了確認は不要です。確認方法は 3 つあります。

       • none: ブローカーに送信された場合にメッセージが 配信されている と見なされます。
       • broker: デフォルトでは、メッセージはブローカーによって確認応答されると 配信されている と見なされます。

       • routable: ブローカーがコンシューマーにルーティングできる場合、メッセージは 配信されている と見なされます。

         注記

         特定のパラメーターのキーと値は、同じ行または特定の順序で存在する必要はありませんが、同じインデックスを使用する必要があります。属性インデックスは、特定の値から順番にしたり、開始したりする必要はありません。

         注記

         topic-name は AMQP トピックに使用されます。

   • Kafka エンドポイント:

     • URL: kafka://[USER: PASSWORD @] FQDN[: PORT].
     • use-ssl がデフォルトで false に設定される場合。use-ssl が true に設定されている場合は、ブローカーへの接続にセキュアな接続が使用されます。
     • ca-location が指定され、セキュアな接続が使用される場合は、ブローカーを認証するために、デフォルトの CA ではなく、指定された CA が使用されます。
     • ユーザーおよびパスワードは HTTP[S] でのみ提供できます。そうでない場合、トピック作成リクエストは拒否されます。
     • ユーザーおよびパスワードは use-ssl とのみ提供でき、ブローカーへの接続に失敗していました。
     • Port のデフォルト値 は 9092 です。

     • kafka-ack-level: 最終宛先に送信される前にメッセージがブローカーで永続化される可能性があるため、終了確認は不要です。確認方法は 2 つあります。

       • none: ブローカーに送信された場合にメッセージが 配信されている と見なされます。
       • broker: デフォルトでは、メッセージはブローカーによって確認応答されると 配信されている と見なされます。

2. 次の形式でレスポンスを作成します。

   構文

   <CreateTopicResponse xmlns="https://sns.amazonaws.com/doc/2010-03-31/">
       <CreateTopicResult>
           <TopicArn></TopicArn>
       </CreateTopicResult>
       <ResponseMetadata>
           <RequestId></RequestId>
       </ResponseMetadata>
   </CreateTopicResponse>

   注記

   レスポンスのトピックの Amazon Resource Name (ARN) の形式は、arn:aws:sns:ZONE_GROUP:TENANT:TOPIC になります。

   以下は AMQP0.9.1 エンドポイントの例になります。

   構文

   "client.create_topic(Name='my-topic' , Attributes={'push-endpoint': 'amqp://127.0.0.1:5672', 'amqp-exchange': 'ex1', 'amqp-ack-level': 'broker'})"

手順

1. 以下の要求形式でトピック情報を取得します。

   構文

   POST
   Action=GetTopic
   &TopicArn=TOPIC_ARN

   レスポンスフォーマットの例を以下に示します。

   <GetTopicResponse>
     <GetTopicRersult>
       <Topic>
         <User>
         </User>
         <Name>
         </Name>
         <EndPoint>
           <EndpointAddress>
           </EndpointAddress>
           <EndpointArgs>
           </EndpointArgs>
           <EndpointTopic>
           </EndpointTopic>
         </EndPoint>
         <TopicArn>
         </TopicArn>
         <OpaqueData>
         </OpaqueData>
       </Topic>
     </GetTopicResult>
     <ResponseMetadata>
       <RequestId>
       </RequestId>
     </ResponseMetadata>
   </GetTopicResponse>

   タグおよびその定義を以下に示します。

   • User: トピックを作成したユーザーの名前。
   • Name: トピックの名前。
   • EndpointAddress: エンドポイントの URL。エンドポイント URL にユーザーおよびパスワード情報が含まれる場合、リクエストは HTTPS 経由で行う必要があります。そうでない場合、トピックの取得要求は拒否されます。
   • EndPointArgs: エンドポイント引数。
   • EndpointTopic: エンドポイントに送信されるトピック名は、上記のトピック名とは異なる場合があります。
   • TopicArn: Topic ARN。

手順

1. 以下の要求形式でトピック情報を一覧表示します。

   POST
   Action=ListTopics

   レスポンスフォーマットの例を以下に示します。

   <ListTopicdResponse xmlns="https://sns.amazonaws.com/doc/2020-03-31/">
     <ListTopicsRersult>
       <Topics>
         <member>
           <User>
           </User>
           <Name>
           </Name>
           <EndPoint>
             <EndpointAddress>
             </EndpointAddress>
             <EndpointArgs>
             </EndpointArgs>
             <EndpointTopic>
             </EndpointTopic>
           </EndPoint>
           <TopicArn>
           </TopicArn>
           <OpaqueData>
           </OpaqueData>
         </member>
       </Topics>
     </ListTopicsResult>
     <ResponseMetadata>
       <RequestId>
       </RequestId>
     </ResponseMetadata>
   </ListTopicsResponse>

   注記

   エンドポイント URL にユーザーおよびパスワード情報が含まれる場合は、トピックのいずれかで要求を行う必要があります。そうでない場合、トピック一覧の要求は拒否されます。

手順

1. 以下の要求形式でトピックを削除します。

   構文

   POST
   Action=DeleteTopic
   &TopicArn=TOPIC_ARN

   レスポンスフォーマットの例を以下に示します。

   <DeleteTopicResponse xmlns="https://sns.amazonaws.com/doc/2020-03-31/">
     <ResponseMetadata>
       <RequestId>
       </RequestId>
     </ResponseMetadata>
   </DeleteTopicResponse>

1. ヘッダー文字列の値を取得します。
2. 要求ヘッダー文字列を正規形式に正規化します。
3. SHA-1 ハッシュアルゴリズムを使用して HMAC を生成します。
4. hmac の結果を base-64 としてエンコードします。

1. すべての content- ヘッダーを取得します。
2. content-type および content-md5 以外の content- ヘッダーをすべて削除します。
3. content- ヘッダー名が小文字であることを確認します。
4. content- ヘッダーの辞書式で並べ替えます。
5. Date ヘッダー AND があることを確認します。指定した日付が、オフセットではなく GMT を使用していることを確認してください。
6. x-amz- で始まるヘッダーをすべて取得します。
7. x-amz- ヘッダーがすべて小文字であることを確認します。
8. x-amz- ヘッダーの辞書式で並べ替えます。
9. 同じフィールド名の複数のインスタンスを単一のフィールドに組み合わせ、フィールド値をコンマで区切ります。
10. ヘッダー値の空白文字および改行文字を、単一スペースに置き換えます。
11. コロンの前後に空白を削除します。
12. 各ヘッダーの後に新しい行を追加します。
13. ヘッダーを要求ヘッダーにマージします。

手順

1. root で、ファイアウォールのポート 8080 を開きます。

   [root@rgw ~]# firewall-cmd --zone=public --add-port=8080/tcp --permanent
   [root@rgw ~]# firewall-cmd --reload

2. Object Gateway 設定および管理ガイド で説明されているように、ゲートウェイに使用する DNS サーバーにワイルドカードを追加します。

   ローカル DNS キャッシュ用のゲートウェイノードを設定することもできます。これを実行するには、以下の手順を実行します。

   1. root で dnsmasq をインストールおよび設定します。

      [root@rgw ~]# yum install dnsmasq
      [root@rgw ~]# echo "address=/.FQDN_OF_GATEWAY_NODE/IP_OF_GATEWAY_NODE" | tee --append /etc/dnsmasq.conf
      [root@rgw ~]# systemctl start dnsmasq
      [root@rgw ~]# systemctl enable dnsmasq

      IP_OF_GATEWAY_NODE および FQDN_OF_GATEWAY_NODE は、ゲートウェイノードの IP アドレスと FQDN に置き換えます。

   2. root で NetworkManager を停止します。

      [root@rgw ~]# systemctl stop NetworkManager
      [root@rgw ~]# systemctl disable NetworkManager

   3. root として、ゲートウェイサーバーの IP を名前空間として設定します。

      [root@rgw ~]# echo "DNS1=IP_OF_GATEWAY_NODE" | tee --append /etc/sysconfig/network-scripts/ifcfg-eth0
      [root@rgw ~]# echo "IP_OF_GATEWAY_NODE FQDN_OF_GATEWAY_NODE" | tee --append /etc/hosts
      [root@rgw ~]# systemctl restart network
      [root@rgw ~]# systemctl enable network
      [root@rgw ~]# systemctl restart dnsmasq

      IP_OF_GATEWAY_NODE および FQDN_OF_GATEWAY_NODE は、ゲートウェイノードの IP アドレスと FQDN に置き換えます。

   4. サブドメイン要求を確認します。

      [user@rgw ~]$ ping mybucket.FQDN_OF_GATEWAY_NODE

      FQDN_OF_GATEWAY_NODE は、ゲートウェイノードの FQDN に置き換えます。

      警告

      ローカルの DNS キャッシュ用にゲートウェイサーバーを設定することは、テスト目的のみを目的としています。これを行った後は、外部ネットワークにはアクセスできなくなります。Red Hat Ceph Storage クラスターおよびゲートウェイノードに適切な DNS サーバーを使用することを強く推奨します。

3. Object Gateway の設定および管理ガイド に説明されているように、S3 アクセスに radosgw ユーザーを作成し、生成した access_key および secret_key をコピーします。S3 アクセス、およびそれ以降のバケット管理タスクには、これらのキーが必要です。

手順

1. ruby パッケージをインストールします。

   [root@dev ~]# yum install ruby

   注記

   上記のコマンドは ruby と、rubygems、ruby-libs などの基本的な依存関係をインストールします。コマンドによってすべての依存関係がインストールされていない場合は、個別にインストールします。

2. Ruby パッケージ aws-s3 をインストールします。

   [root@dev ~]# gem install aws-s3

3. プロジェクトディレクトリーを作成します。

   [user@dev ~]$ mkdir ruby_aws_s3
   [user@dev ~]$ cd ruby_aws_s3

4. コネクションファイルを作成します。

   [user@dev ~]$ vim conn.rb

5. conn.rb ファイルに以下のコンテンツを貼り付けます。

   構文

   #!/usr/bin/env ruby
   
   require 'aws/s3'
   require 'resolv-replace'
   
   AWS::S3::Base.establish_connection!(
           :server            => 'FQDN_OF_GATEWAY_NODE',
           :port           => '8080',
           :access_key_id     => 'MY_ACCESS_KEY',
           :secret_access_key => 'MY_SECRET_KEY'
   )

   FQDN_OF_GATEWAY_NODE は、Ceph Object Gateway ノードの FQDN に置き換えます。MY_ACCESS_KEY および MY_SECRET_KEY を、Red Hat Ceph Storage Object Gateway Configuration and Administration Guide に記載されているように、S3 アクセス用の radosgw ユーザーを作成したときに生成された access_key および secret_key に置き換えます。

   例

   #!/usr/bin/env ruby
   
   require 'aws/s3'
   require 'resolv-replace'
   
   AWS::S3::Base.establish_connection!(
           :server            => 'testclient.englab.pnq.redhat.com',
           :port           => '8080',
           :access_key_id     => '98J4R9P22P5CDL65HKP8',
           :secret_access_key => '6C+jcaP0dp0+FZfrRNgyGA9EzRy25pURldwje049'
   )

   ファイルを保存して、エディターを終了します。

6. ファイルを実行可能にします。

   [user@dev ~]$ chmod +x conn.rb

7. コマンドを実行します。

   [user@dev ~]$ ./conn.rb | echo $?

   ファイルに正しく値を指定した場合は、コマンドの出力は 0 になります。

8. バケットを作成するための新規ファイルを作成します。

   [user@dev ~]$ vim create_bucket.rb

   以下のコンテンツをファイルに貼り付けます。

   #!/usr/bin/env ruby
   
   load 'conn.rb'
   
   AWS::S3::Bucket.create('my-new-bucket1')

   ファイルを保存して、エディターを終了します。

9. ファイルを実行可能にします。

   [user@dev ~]$ chmod +x create_bucket.rb

10. コマンドを実行します。

    [user@dev ~]$ ./create_bucket.rb

    コマンドの出力が true の場合は、バケット my-new-bucket1 が正常に作成されたことを意味します。

11. 所有されるバケットを一覧表示するために新規ファイルを作成します。

    [user@dev ~]$ vim list_owned_buckets.rb

    以下のコンテンツをファイルに貼り付けます。

    #!/usr/bin/env ruby
    
    load 'conn.rb'
    
    AWS::S3::Service.buckets.each do |bucket|
            puts "{bucket.name}\t{bucket.creation_date}"
    end

    ファイルを保存して、エディターを終了します。

12. ファイルを実行可能にします。

    [user@dev ~]$ chmod +x list_owned_buckets.rb

13. コマンドを実行します。

    [user@dev ~]$ ./list_owned_buckets.rb

    出力は以下のようになります。

    my-new-bucket1 2020-01-21 10:33:19 UTC

14. オブジェクトを作成するための新規ファイルを作成します。

    [user@dev ~]$ vim create_object.rb

    以下のコンテンツをファイルに貼り付けます。

    #!/usr/bin/env ruby
    
    load 'conn.rb'
    
    AWS::S3::S3Object.store(
            'hello.txt',
            'Hello World!',
            'my-new-bucket1',
            :content_type => 'text/plain'
    )

    ファイルを保存して、エディターを終了します。

15. ファイルを実行可能にします。

    [user@dev ~]$ chmod +x create_object.rb

16. コマンドを実行します。

    [user@dev ~]$ ./create_object.rb

    これで、文字列 Hello World! で hello.txt が作成されます。

17. バケットのコンテンツを一覧表示するための新規ファイルを作成します。

    [user@dev ~]$ vim list_bucket_content.rb

    以下のコンテンツをファイルに貼り付けます。

    #!/usr/bin/env ruby
    
    load 'conn.rb'
    
    new_bucket = AWS::S3::Bucket.find('my-new-bucket1')
    new_bucket.each do |object|
            puts "{object.key}\t{object.about['content-length']}\t{object.about['last-modified']}"
    end

    ファイルを保存して、エディターを終了します。

18. ファイルを実行可能にします。

    [user@dev ~]$ chmod +x list_bucket_content.rb

19. コマンドを実行します。

    [user@dev ~]$ ./list_bucket_content.rb

    出力は以下のようになります。

    hello.txt    12    Fri, 22 Jan 2020 15:54:52 GMT

20. 空のバケットを削除するために新規ファイルを作成します。

    [user@dev ~]$ vim del_empty_bucket.rb

    以下のコンテンツをファイルに貼り付けます。

    #!/usr/bin/env ruby
    
    load 'conn.rb'
    
    AWS::S3::Bucket.delete('my-new-bucket1')

    ファイルを保存して、エディターを終了します。

21. ファイルを実行可能にします。

    [user@dev ~]$ chmod +x del_empty_bucket.rb

22. コマンドを実行します。

    [user@dev ~]$ ./del_empty_bucket.rb | echo $?

    バケットが正常に削除されると、コマンドは 0 を出力として返します。

    注記

    create_bucket.rb ファイルを編集し、空のバケットを作成します (例: my-new-bucket4、my-new-bucket5)。次に、空のバケットの削除を試みる前に、上記の del_empty_bucket.rb ファイルを適宜編集します。

23. 空でないバケットを削除する新規ファイルを作成します。

    [user@dev ~]$ vim del_non_empty_bucket.rb

    以下のコンテンツをファイルに貼り付けます。

    #!/usr/bin/env ruby
    
    load 'conn.rb'
    
    AWS::S3::Bucket.delete('my-new-bucket1', :force => true)

    ファイルを保存して、エディターを終了します。

24. ファイルを実行可能にします。

    [user@dev ~]$ chmod +x del_non_empty_bucket.rb

25. コマンドを実行します。

    [user@dev ~]$ ./del_non_empty_bucket.rb | echo $?

    バケットが正常に削除されると、コマンドは 0 を出力として返します。

26. オブジェクトを削除する新しいファイルを作成します。

    [user@dev ~]$ vim delete_object.rb

    以下のコンテンツをファイルに貼り付けます。

    #!/usr/bin/env ruby
    
    load 'conn.rb'
    
    AWS::S3::S3Object.delete('hello.txt', 'my-new-bucket1')

    ファイルを保存して、エディターを終了します。

27. ファイルを実行可能にします。

    [user@dev ~]$ chmod +x delete_object.rb

28. コマンドを実行します。

    [user@dev ~]$ ./delete_object.rb

    これにより、オブジェクト hello.txt が削除されます。

手順

1. ruby パッケージをインストールします。

   [root@dev ~]# yum install ruby

   注記

   上記のコマンドは ruby と、rubygems、ruby-libs などの基本的な依存関係をインストールします。コマンドによってすべての依存関係がインストールされていない場合は、個別にインストールします。

2. Ruby パッケージ aws-sdk をインストールします。

   [root@dev ~]# gem install aws-sdk

3. プロジェクトディレクトリーを作成します。

   [user@dev ~]$ mkdir ruby_aws_sdk
   [user@dev ~]$ cd ruby_aws_sdk

4. コネクションファイルを作成します。

   [user@ruby_aws_sdk]$ vim conn.rb

5. conn.rb ファイルに以下のコンテンツを貼り付けます。

   構文

   #!/usr/bin/env ruby
   
   require 'aws-sdk'
   require 'resolv-replace'
   
   Aws.config.update(
           endpoint: 'http://FQDN_OF_GATEWAY_NODE:8080',
           access_key_id: 'MY_ACCESS_KEY',
           secret_access_key: 'MY_SECRET_KEY',
           force_path_style: true,
           region: 'us-east-1'
   )

   FQDN_OF_GATEWAY_NODE は、Ceph Object Gateway ノードの FQDN に置き換えます。MY_ACCESS_KEY および MY_SECRET_KEY を、Red Hat Ceph Storage Object Gateway Configuration and Administration Guide に記載されているように、S3 アクセス用の radosgw ユーザーを作成したときに生成された access_key および secret_key に置き換えます。

   例

   #!/usr/bin/env ruby
   
   require 'aws-sdk'
   require 'resolv-replace'
   
   Aws.config.update(
           endpoint: 'http://testclient.englab.pnq.redhat.com:8080',
           access_key_id: '98J4R9P22P5CDL65HKP8',
           secret_access_key: '6C+jcaP0dp0+FZfrRNgyGA9EzRy25pURldwje049',
           force_path_style: true,
           region: 'us-east-1'
   )

   ファイルを保存して、エディターを終了します。

6. ファイルを実行可能にします。

   [user@ruby_aws_sdk]$ chmod +x conn.rb

7. コマンドを実行します。

   [user@ruby_aws_sdk]$ ./conn.rb | echo $?

   ファイルに正しく値を指定した場合は、コマンドの出力は 0 になります。

8. バケットを作成するための新規ファイルを作成します。

   [user@ruby_aws_sdk]$ vim create_bucket.rb

   以下のコンテンツをファイルに貼り付けます。

   構文

   #!/usr/bin/env ruby
   
   load 'conn.rb'
   
   s3_client = Aws::S3::Client.new
   s3_client.create_bucket(bucket: 'my-new-bucket2')

   ファイルを保存して、エディターを終了します。

9. ファイルを実行可能にします。

   [user@ruby_aws_sdk]$ chmod +x create_bucket.rb

10. コマンドを実行します。

    [user@ruby_aws_sdk]$ ./create_bucket.rb

    コマンドの出力が true の場合は、バケット my-new-bucket2 が正常に作成されていることを意味します。

11. 所有されるバケットを一覧表示するために新規ファイルを作成します。

    [user@ruby_aws_sdk]$ vim list_owned_buckets.rb

    以下のコンテンツをファイルに貼り付けます。

    #!/usr/bin/env ruby
    
    load 'conn.rb'
    
    s3_client = Aws::S3::Client.new
    s3_client.list_buckets.buckets.each do |bucket|
            puts "{bucket.name}\t{bucket.creation_date}"
    end

    ファイルを保存して、エディターを終了します。

12. ファイルを実行可能にします。

    [user@ruby_aws_sdk]$ chmod +x list_owned_buckets.rb

13. コマンドを実行します。

    [user@ruby_aws_sdk]$ ./list_owned_buckets.rb

    出力は以下のようになります。

    my-new-bucket2 2022-04-21 10:33:19 UTC

14. オブジェクトを作成するための新規ファイルを作成します。

    [user@ruby_aws_sdk]$ vim create_object.rb

    以下のコンテンツをファイルに貼り付けます。

    #!/usr/bin/env ruby
    
    load 'conn.rb'
    
    s3_client = Aws::S3::Client.new
    s3_client.put_object(
            key: 'hello.txt',
            body: 'Hello World!',
            bucket: 'my-new-bucket2',
            content_type: 'text/plain'
    )

    ファイルを保存して、エディターを終了します。

15. ファイルを実行可能にします。

    [user@ruby_aws_sdk]$ chmod +x create_object.rb

16. コマンドを実行します。

    [user@ruby_aws_sdk]$ ./create_object.rb

    これで、文字列 Hello World! で hello.txt が作成されます。

17. バケットのコンテンツを一覧表示するための新規ファイルを作成します。

    [user@ruby_aws_sdk]$ vim list_bucket_content.rb

    以下のコンテンツをファイルに貼り付けます。

    #!/usr/bin/env ruby
    
    load 'conn.rb'
    
    s3_client = Aws::S3::Client.new
    s3_client.list_objects(bucket: 'my-new-bucket2').contents.each do |object|
            puts "{object.key}\t{object.size}"
    end

    ファイルを保存して、エディターを終了します。

18. ファイルを実行可能にします。

    [user@ruby_aws_sdk]$ chmod +x list_bucket_content.rb

19. コマンドを実行します。

    [user@ruby_aws_sdk]$ ./list_bucket_content.rb

    出力は以下のようになります。

    hello.txt    12    Fri, 22 Apr 2022 15:54:52 GMT

20. 空のバケットを削除するために新規ファイルを作成します。

    [user@ruby_aws_sdk]$ vim del_empty_bucket.rb

    以下のコンテンツをファイルに貼り付けます。

    #!/usr/bin/env ruby
    
    load 'conn.rb'
    
    s3_client = Aws::S3::Client.new
    s3_client.delete_bucket(bucket: 'my-new-bucket2')

    ファイルを保存して、エディターを終了します。

21. ファイルを実行可能にします。

    [user@ruby_aws_sdk]$ chmod +x del_empty_bucket.rb

22. コマンドを実行します。

    [user@ruby_aws_sdk]$ ./del_empty_bucket.rb | echo $?

    バケットが正常に削除されると、コマンドは 0 を出力として返します。

    注記

    create_bucket.rb ファイルを編集し、空のバケットを作成します (例: my-new-bucket6、my-new-bucket7)。次に、空のバケットの削除を試みる前に、上記の del_empty_bucket.rb ファイルを適宜編集します。

23. 空でないバケットを削除する新規ファイルを作成します。

    [user@ruby_aws_sdk]$ vim del_non_empty_bucket.rb

    以下のコンテンツをファイルに貼り付けます。

    #!/usr/bin/env ruby
    
    load 'conn.rb'
    
    s3_client = Aws::S3::Client.new
    Aws::S3::Bucket.new('my-new-bucket2', client: s3_client).clear!
    s3_client.delete_bucket(bucket: 'my-new-bucket2')

    ファイルを保存して、エディターを終了します。

24. ファイルを実行可能にします。

    [user@ruby_aws_sdk]$ chmod +x del_non_empty_bucket.rb

25. コマンドを実行します。

    [user@ruby_aws_sdk]$ ./del_non_empty_bucket.rb | echo $?

    バケットが正常に削除されると、コマンドは 0 を出力として返します。

26. オブジェクトを削除する新しいファイルを作成します。

    [user@ruby_aws_sdk]$ vim delete_object.rb

    以下のコンテンツをファイルに貼り付けます。

    #!/usr/bin/env ruby
    
    load 'conn.rb'
    
    s3_client = Aws::S3::Client.new
    s3_client.delete_object(key: 'hello.txt', bucket: 'my-new-bucket2')

    ファイルを保存して、エディターを終了します。

27. ファイルを実行可能にします。

    [user@ruby_aws_sdk]$ chmod +x delete_object.rb

28. コマンドを実行します。

    [user@ruby_aws_sdk]$ ./delete_object.rb

    これにより、オブジェクト hello.txt が削除されます。

手順

1. php パッケージをインストールします。

   [root@dev ~]# yum install php

2. PHP 用に aws-sdk の zip アーカイブを ダウンロード し、展開します。

3. プロジェクトディレクトリーを作成します。

   [user@dev ~]$ mkdir php_s3
   [user@dev ~]$ cd php_s3

4. 展開した aws ディレクトリーをプロジェクトのディレクトリーにコピーします。以下に例を示します。

   [user@php_s3]$ cp -r ~/Downloads/aws/ ~/php_s3/

5. コネクションファイルを作成します。

   [user@php_s3]$ vim conn.php

6. conn.php ファイルに以下のコンテンツを貼り付けます。

   構文

   <?php
   define('AWS_KEY', 'MY_ACCESS_KEY');
   define('AWS_SECRET_KEY', 'MY_SECRET_KEY');
   define('HOST', 'FQDN_OF_GATEWAY_NODE');
   define('PORT', '8080');
   
   // require the AWS SDK for php library
   require '/PATH_TO_AWS/aws-autoloader.php';
   
   use Aws\S3\S3Client;
   
   // Establish connection with host using S3 Client
   client = S3Client::factory(array(
       'base_url' => HOST,
       'port' => PORT,
       'key'      => AWS_KEY,
       'secret'   => AWS_SECRET_KEY
   ));
   ?>

   FQDN_OF_GATEWAY_NODE は、ゲートウェイノードの FQDN に置き換えます。MY_ACCESS_KEY および MY_SECRET_KEY を、Red Hat Ceph Storage Object Gateway Configuration and Administration Guide で説明されているように、S3 アクセス用の radosgw ユーザーを作成するときに生成された access_key および secret_key に置き換えます。PATH_TO_AWS は、php プロジェクトディレクトリーにコピーした、展開した aws ディレクトリーへの絶対パスに置き換えます。

   ファイルを保存して、エディターを終了します。

7. コマンドを実行します。

   [user@php_s3]$ php -f conn.php | echo $?

   ファイルに正しく値を指定した場合は、コマンドの出力は 0 になります。

8. バケットを作成するための新規ファイルを作成します。

   [user@php_s3]$ vim create_bucket.php

   新しいファイルに以下の内容を貼り付けます。

   構文

   <?php
   
   include 'conn.php';
   
   client->createBucket(array('Bucket' => 'my-new-bucket3'));
   
   ?>

   ファイルを保存して、エディターを終了します。

9. コマンドを実行します。

   [user@php_s3]$ php -f create_bucket.php

10. 所有されるバケットを一覧表示するために新規ファイルを作成します。

    [user@php_s3]$ vim list_owned_buckets.php

    以下のコンテンツをファイルに貼り付けます。

    構文

    <?php
    
    include 'conn.php';
    
    blist = client->listBuckets();
    echo "Buckets belonging to " . blist['Owner']['ID'] . ":\n";
    foreach (blist['Buckets'] as b) {
        echo "{b['Name']}\t{b['CreationDate']}\n";
    }
    
    ?>

    ファイルを保存して、エディターを終了します。

11. コマンドを実行します。

    [user@php_s3]$ php -f list_owned_buckets.php

    出力は以下のようになります。

    my-new-bucket3 2022-04-21 10:33:19 UTC

12. まず hello.txt という名前のソースファイルを作成するオブジェクトを作成します。

    [user@php_s3]$ echo "Hello World!" > hello.txt

13. 新しい php ファイルを作成します。

    [user@php_s3]$ vim create_object.php

    以下のコンテンツをファイルに貼り付けます。

    構文

    <?php
    
    include 'conn.php';
    
    key         = 'hello.txt';
    source_file = './hello.txt';
    acl         = 'private';
    bucket      = 'my-new-bucket3';
    client->upload(bucket, key, fopen(source_file, 'r'), acl);
    
    ?>

    ファイルを保存して、エディターを終了します。

14. コマンドを実行します。

    [user@php_s3]$ php -f create_object.php

    これにより、バケット my-new-bucket3 でオブジェクト hello.txt が作成されます。

15. バケットのコンテンツを一覧表示するための新規ファイルを作成します。

    [user@php_s3]$ vim list_bucket_content.php

    以下のコンテンツをファイルに貼り付けます。

    構文

    <?php
    
    include 'conn.php';
    
    o_iter = client->getIterator('ListObjects', array(
        'Bucket' => 'my-new-bucket3'
    ));
    foreach (o_iter as o) {
        echo "{o['Key']}\t{o['Size']}\t{o['LastModified']}\n";
    }
    ?>

    ファイルを保存して、エディターを終了します。

16. コマンドを実行します。

    [user@php_s3]$ php -f list_bucket_content.php

    出力は以下のようになります。

    hello.txt    12    Fri, 22 Apr 2022 15:54:52 GMT

17. 空のバケットを削除するために新規ファイルを作成します。

    [user@php_s3]$ vim del_empty_bucket.php

    以下のコンテンツをファイルに貼り付けます。

    構文

    <?php
    
    include 'conn.php';
    
    client->deleteBucket(array('Bucket' => 'my-new-bucket3'));
    ?>

    ファイルを保存して、エディターを終了します。

18. コマンドを実行します。

    [user@php_s3]$ php -f del_empty_bucket.php | echo $?

    バケットが正常に削除されると、コマンドは 0 を出力として返します。

    注記

    create_bucket.php ファイルを編集し、空のバケットを作成します (例: my-new-bucket4、my-new-bucket5)。次に、空のバケットの削除を試みる前に、上記の del_empty_bucket.php ファイルを適宜編集します。

    重要

    空でないバケットの削除は、現在 PHP 2 以降のバージョンの aws-sdk ではサポートされていません。

19. オブジェクトを削除する新しいファイルを作成します。

    [user@php_s3]$ vim delete_object.php

    以下のコンテンツをファイルに貼り付けます。

    構文

    <?php
    
    include 'conn.php';
    
    client->deleteObject(array(
        'Bucket' => 'my-new-bucket3',
        'Key'    => 'hello.txt',
    ));
    ?>

    ファイルを保存して、エディターを終了します。

20. コマンドを実行します。

    [user@php_s3]$ php -f delete_object.php

    これにより、オブジェクト hello.txt が削除されます。

手順

1. awscli パッケージをインストールします。

   [user@dev]$ pip3 install --user awscli

2. AWS CLI を使用して Ceph Object Storage にアクセスするように awscli を設定します。

   構文

   aws configure --profile=MY_PROFILE_NAME
   
   AWS Access Key ID [None]: MY_ACCESS_KEY
   AWS Secret Access Key [None]: MY_SECRET_KEY
   Default region name [None]:
   Default output format [None]:

   MY_PROFILE_NAME を、このプロファイルを識別するために使用する名前に置き換えます。MY_ACCESS_KEY および MY_SECRET_KEY を、Red Hat Ceph Storage Object Gateway Configuration and Administration Guide で説明されているように、S3 アクセス用の radosgw ユーザーを作成するときに生成された access_key および secret_key に置き換えます。

   例

   [user@dev]$ aws configure --profile=ceph
   
   AWS Access Key ID [None]: 12345
   AWS Secret Access Key [None]: 67890
   Default region name [None]:
   Default output format [None]:

3. Ceph Object Gateway ノードの FQDN を指すエイリアスを作成します。

   構文

   alias aws="aws --endpoint-url=http://FQDN_OF_GATEWAY_NODE:8080"

   FQDN_OF_GATEWAY_NODE は、Ceph Object Gateway ノードの FQDN に置き換えます。

   例

   [user@dev]$ alias aws="aws --endpoint-url=http://testclient.englab.pnq.redhat.com:8080"

4. 新しいバケットを作成します。

   構文

   aws --profile=MY_PROFILE_NAME s3api create-bucket --bucket BUCKET_NAME

   MY_PROFILE_NAME を、このプロファイルを使用するために作成した名前に置き換えます。BUCKET_NAME は、新規バケットの名前に置き換えます。

   例

   [user@dev]$ aws --profile=ceph s3api create-bucket --bucket mybucket

5. 所有するバケットを一覧表示します。

   構文

   aws --profile=MY_PROFILE_NAME s3api list-buckets

   MY_PROFILE_NAME を、このプロファイルを使用するために作成した名前に置き換えます。

   例

   [user@dev]$ aws --profile=ceph s3api list-buckets
   {
       "Buckets": [
           {
               "Name": "mybucket",
               "CreationDate": "2021-08-31T16:46:15.257Z"
           }
       ],
       "Owner": {
           "DisplayName": "User",
           "ID": "user"
       }
   }

6. MFA-Delete のバケットを設定します。

   構文

   aws --profile=MY_PROFILE_NAME s3api put-bucket-versioning --bucket BUCKET_NAME --versioning-configuration '{"Status":"Enabled","MFADelete":"Enabled"}' --mfa 'TOTP_SERIAL TOTP_PIN'

   • MY_PROFILE_NAME を、このプロファイルを使用するために作成した名前に置き換えます。
   • BUCKET_NAME を新しいバケットの名前に置き換えます。
   • TOTP_SERIAL を TOTP トークンの ID を表す文字列に置き換え、TOTP_PIN を MFA 認証デバイスに表示されている現在の PIN に置き換えます。
   • TOTP_SERIAL は、S3 の radosgw ユーザーを作成したときに指定した文字列です。
   • MFA TOTP トークンの作成に関する詳細は、Red Hat Ceph Storage Object Gateway Configuration and Administration Guide の Creating a new multi-factor authentication TOTP token セクションを参照してください。

   • oathtool を使用した MFA シードの作成に関する詳細は、Red Hat Ceph Storage 開発者ガイド の oathtool を使用した多要素認証のシードの作成 セクションを参照してください。

     例

     [user@dev]$ aws --profile=ceph s3api put-bucket-versioning --bucket mybucket --versioning-configuration '{"Status":"Enabled","MFADelete":"Enabled"}' --mfa 'MFAtest 232009'

7. バケットバージョン管理状態の MFA-Delete ステータスを表示します。

   構文

   aws --profile=MY_PROFILE_NAME s3api get-bucket-versioning --bucket BUCKET_NAME

   MY_PROFILE_NAME を、このプロファイルを使用するために作成した名前に置き換えます。BUCKET_NAME を新しいバケットの名前に置き換えます。

   例

   [user@dev]$ aws --profile=ceph s3api get-bucket-versioning --bucket mybucket
   {
       "Status": "Enabled",
       "MFADelete": "Enabled"
   }

8. MFA-Delete が有効なバケットにオブジェクトを追加します。

   構文

   aws --profile=MY_PROFILE_NAME s3api put-object --bucket BUCKET_NAME --key OBJECT_KEY --body LOCAL_FILE

   • MY_PROFILE_NAME を、このプロファイルを使用するために作成した名前に置き換えます。
   • BUCKET_NAME を新しいバケットの名前に置き換えます。
   • OBJECT_KEY を、バケット内のオブジェクトを一意に識別する名前に置き換えます。

   • LOCAL_FILE を、アップロードするローカルファイルの名前に置き換えます。

     例

     [user@dev]$ aws --profile=ceph s3api put-object --bucket mybucket --key example --body testfile
     {
         "ETag": "\"5679b828547a4b44cfb24a23fd9bb9d5\"",
         "VersionId": "3VyyYPTEuIofdvMPWbr1znlOu7lJE3r"
     }

9. 特定のオブジェクトのオブジェクトバージョンを一覧表示します。

   構文

   aws --profile=MY_PROFILE_NAME s3api list-object-versions --bucket BUCKET_NAME --key OBJEC_KEY]

   • MY_PROFILE_NAME を、このプロファイルを使用するために作成した名前に置き換えます。
   • BUCKET_NAME を新しいバケットの名前に置き換えます。

   • OBJECT_KEY を、バケット内のオブジェクトを一意に識別するために指定された名前に置き換えます。

     例

     [user@dev]$ aws --profile=ceph s3api list-object-versions --bucket mybucket --key example
     {
         "IsTruncated": false,
         "KeyMarker": "example",
         "VersionIdMarker": "",
         "Versions": [
             {
                 "ETag": "\"5679b828547a4b44cfb24a23fd9bb9d5\"",
                 "Size": 196,
                 "StorageClass": "STANDARD",
                 "Key": "example",
                 "VersionId": "3VyyYPTEuIofdvMPWbr1znlOu7lJE3r",
                 "IsLatest": true,
                 "LastModified": "2021-08-31T17:48:45.484Z",
                 "Owner": {
                     "DisplayName": "User",
                     "ID": "user"
                 }
             }
         ],
         "Name": "mybucket",
         "Prefix": "",
         "MaxKeys": 1000,
         "EncodingType": "url"
     }

10. MFA-Delete が有効なバケット内のオブジェクトを削除します。

    構文

    aws --profile=MY_PROFILE_NAME s3api delete-object --bucket BUCKET_NAME --key OBJECT_KEY --version-id VERSION_ID --mfa 'TOTP_SERIAL TOTP_PIN'

    • MY_PROFILE_NAME を、このプロファイルを使用するために作成した名前に置き換えます。
    • BUCKET_NAME を、削除するオブジェクトを含むバケットの名前に置き換えます。
    • OBJECT_KEY を、バケット内のオブジェクトを一意に識別する名前に置き換えます。
    • VERSION_ID を、削除するオブジェクトの特定のバージョンの VersionID に置き換えます。

    • TOTP_SERIAL を TOTP トークンの ID を表す文字列に置き換え、TOTP_PIN を MFA 認証デバイスに表示されている現在の PIN に置き換えます。

      例

      [user@dev]$ aws --profile=ceph s3api delete-object --bucket mybucket --key example --version-id 3VyyYPTEuIofdvMPWbr1znlOu7lJE3r --mfa 'MFAtest 420797'
      {
          "VersionId": "3VyyYPTEuIofdvMPWbr1znlOu7lJE3r"
      }

      MFA トークンが含まれていない場合、リクエストは次のエラーで失敗します。

      例

      [user@dev]$ aws --profile=ceph s3api delete-object --bucket mybucket --key example --version-id 3VyyYPTEuIofdvMPWbr1znlOu7lJE3r
      An error occurred (AccessDenied) when calling the DeleteObject operation: Unknown

11. オブジェクトのバージョンを一覧表示して、MFA 削除が有効なバケットからオブジェクトが削除されたことを確認します。

    構文

    aws --profile=MY_PROFILE_NAME s3api list-object-versions --bucket BUCKET_NAME --key OBJECT_KEY

    • MY_PROFILE_NAME を、このプロファイルを使用するために作成した名前に置き換えます。
    • BUCKET_NAME をバケットの名前に置き換えます。

    • OBJECT_KEY を、バケット内のオブジェクトを一意に識別する名前に置き換えます。

      例

      [user@dev]$ aws --profile=ceph s3api list-object-versions --bucket mybucket --key example
      {
          "IsTruncated": false,
          "KeyMarker": "example",
          "VersionIdMarker": "",
          "Name": "mybucket",
          "Prefix": "",
          "MaxKeys": 1000,
          "EncodingType": "url"
      }

手順

1. oathtool パッケージをインストールします。

   [root@dev]# dnf install oathtool

2. qrencode パッケージをインストールします。

   [root@dev]# dnf install qrencode

3. urandom Linux デバイスファイルから 30 文字のシードを生成し、シェル変数 SEED に格納します。

   例

   [user@dev]$ SEED=$(head -10 /dev/urandom | sha512sum | cut -b 1-30)

4. SEED 変数で echo を実行して、シードを出力します。

   例

   [user@dev]$ echo $SEED
   BA6GLJBJIKC3D7W7YFYXXAQ7

5. SEED を oathtool コマンドに入力します。

   構文

   oathtool -v -d6 $SEED

   例

   [user@dev]$ oathtool -v -d6 $SEED
   Hex secret: 083c65a4294285b1fedfc1717b821f
   Base32 secret: BA6GLJBJIKC3D7W7YFYXXAQ7
   Digits: 6
   Window size: 0
   Start counter: 0x0 (0)
   
   823182

   注記

   base32 シークレットは、MFA デバイスのオーセンティケーターアプリケーションにトークンを追加するために必要です。QR コードを使用してトークンを認証アプリケーションにインポートするか、base32 シークレットを使用して手動でトークンを追加できます。

6. オプション: QR コードイメージファイルを作成して、トークンをオーセンティケーターに追加します。

   構文

   qrencode -o /tmp/user.png 'otpauth://totp/TOTP_SERIAL?secret=_BASE32_SECRET'

   TOTP_SERIAL を (TOTP) トークンの ID を表す文字列に置き換え、BASE32_SECRET を oathtool によって生成された Base32 シークレットに置き換えます。

   例

   [user@dev]$ qrencode -o /tmp/user.png 'otpauth://totp/MFAtest?secret=BA6GLJBJIKC3D7W7YFYXXAQ7'

7. 生成された QR コードイメージファイルをスキャンして、トークンを MFA デバイスの認証アプリケーションに追加します。
8. radowgw-admin コマンドを使用して、ユーザーの多要素認証 TOTP トークンを作成します。