开发人员指南

流程

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]

   以下是请求参数：

   • 端点 ：发送通知的端点 URL。
   • OpaqueData: 不透明数据在主题配置中设置，并添加到该主题触发的所有通知。

   • HTTP 端点：

     • URL: http[s]://FQDN[: PORT ]
     • port defaults to: 分别为 HTTP[S] 使用 80/443。
     • verify-ssl ：指示服务器证书是否由客户端验证。默认情况下，它是 true。

   • AMQP0.9.1 端点：

     • URL: amqp://[USER : PASSWORD @] FQDN [: PORT][/VHOST].
     • 用户和密码分别默认为： guest 和 guest。
     • 用户和密码只能通过 HTTPS 提供。否则，主题创建请求将被拒绝。
     • 端口默认为 : 5672。
     • vhost 默认为："/"
     • AMQP-exchange ：交换必须存在，并可基于主题路由消息。这是用于 AMQP0.9.1 的强制参数。指向同一端点的不同主题必须使用相同的交换。

     • AMQP-acklevel: 不需要最终确认，因为消息可能会在代理中存入最终目的地。有三个确认方法：

       • none ：当发送到代理，则消息被视为已发送。
       • broker ：默认情况下，如果代理确认，则消息会被视为已发送。

       • routable ：如果代理可路由到使用者，则消息被视为已发送。

         注意

         特定参数的键和值不必驻留在同一行中，或者以任何特定顺序使用，但必须使用相同的索引。属性索引不需要是连续的，或从任何特定值开始。

         注意

         topic-name 用于 AMQP 主题。

   • Kafka 端点：

     • URL: kafka://[USER: PASSWORD @] FQDN[: PORT].
     • 如果 use-ssl 默认设为 false。如果将 use-ssl 设置为 true，则与代理的连接会使用安全的连接。
     • 如果提供了 ca-location，并且使用安全连接，则会使用指定的 CA 而不是默认的端口来验证代理。
     • 用户和密码只能通过 HTTP[S] 提供。如果没有，则topic 创建请求将被拒绝。
     • 只能通过 use-ssl 来提供用户和密码，如果不是，则与代理的连接会失败。
     • 端口默认为: 9092。

     • kafka-acklevel: 不需要结束确认，因为信息可能会在代理中被传送到最终目的地前保留。存在两个确认方法：

       • none ：当发送到代理，则消息被视为已发送。
       • broker ：默认情况下，如果代理确认，则消息将被 发送。

2. 以以下格式创建响应：

   语法

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

   注意

   响应中的 Amazon 资源名称(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 进行请求。如果没有，则主题的 get 请求将被拒绝。
   • 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 包含用户和密码信息，在任何主题中，则必须通过 HTTPS 进行请求。如果没有，则主题列表请求将被拒绝。

流程

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. 获取 所有内容 标头。
2. 删除除 content-type 和 content-md5 外的所有 content- 标头。
3. 确保 content- 标头名称是小写。
4. 以字典顺序对 content- 标题排序。
5. 确保带有 Date 标头，并确保指定的日期使用 GMT 而不是偏移量。
6. 获取以 x-amz- 开头的所有标题。
7. 确保 x-amz- 标头都是小写。
8. 适当地对 x-amz- headers 进行排序。
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. 如对象网关配置和管理指南中所述，为网关使用的 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. 如对象网关配置和管理指南 中所述，为 S3 访问创建 radosgw 用户，并复制生成的 access_key 和 secret_key。您需要这些密钥进行 S3 访问和随后的 bucket 管理任务。

流程

1. 安装 ruby 软件包：

   [root@dev ~]# yum install ruby

   注意

   以上命令将安装 ruby，它是 rubygems 和 ruby-libs 等基本依赖项。如果某种方式命令没有安装所有依赖项，请单独安装它们。

2. 安装 aws-s3 Ruby 软件包：

   [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 对象网关节点的 FQDN。将 MY_ACCESS_KEY 和 MY_SECRET_KEY 替换为您在为 S3 创建 radosgw 用户进行 S3 访问时生成的 access_key 和 secret_key，如 Red Hat Ceph Storage Object Gateway Configuration and Administration Guide 中所述。

   示例

   #!/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，这表示 bucket 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. 安装 aws-sdk Ruby 软件包：

   [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 对象网关节点的 FQDN。将 MY_ACCESS_KEY 和 MY_SECRET_KEY 替换为您在为 S3 创建 radosgw 用户进行 S3 访问时生成的 access_key 和 secret_key，如 Red Hat Ceph Storage Object Gateway Configuration and Administration Guide 中所述。

   示例

   #!/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，这表示 bucket 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。按照 Red Hat Ceph Storage Object Gateway Configuration 和 Administration Guide 所述，将 MY_ACCESS_KEY 和 MY_SECRET_KEY 替换为创建 S3 访问时生成的 access_key 和 secret_key。使用您复制到 php 项目目录的提取的 aws 目录替换 PATH_TO_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

    这将在 bucket 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. 配置 awscli 以使用 AWS CLI 访问 Ceph 对象存储：

   语法

   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 替换为您要用来识别此配置集的名称。按照 Red Hat Ceph Storage Object Gateway Configuration 和 Administration Guide 所述，将 MY_ACCESS_KEY 和 MY_SECRET_KEY 替换为创建 S3 访问时生成的 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 对象网关节点的 FQDN：

   语法

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

   将 FQDN_OF_GATEWAY_NODE 替换为 Ceph 对象网关节点的 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 和 Administration Guide 中创建新的多因素身份验证 TOTP 令牌 部分。

   • 有关使用 oathtool 创建 MFA seed for multi-factor authentication 部分，请参阅 Red Hat Ceph Storage Developer Guide 中的 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 替换为唯一标识 bucket 中对象的名称。
    • 将 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-Delete 启用存储桶中删除：

    语法

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

    • 将 MY_PROFILE_NAME 替换为您创建使用此配置集的名称。
    • 将 BUCKET_NAME 替换为存储桶的名称。

    • 将 OBJECT_KEY 替换为唯一标识 bucket 中对象的名称。

      示例

      [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 个字符，并将其存储在 shell 变量 SEED 中：

   示例

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

4. 通过在 SEED 变量中运行 echo 来打印 seed:

   示例

   [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 secret 需要在您的 MFA 设备的 authenticator 应用程序中添加令牌。您可以使用 QR 代码将令牌导入到验证器应用程序，或使用 base32 机密手动添加它。

6. 可选：创建一个 QR 代码镜像文件，将令牌添加到验证器中：

   语法

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

   将 TOTP_SERIAL 替换为代表(TOTP)令牌 ID 的字符串，并将 BASE32_SECRET 替换为 oathtool 生成的 Base32 secret。

   示例

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

7. 扫描生成的 QR 代码镜像文件，将令牌添加到 MFA 设备的验证器应用程序中。
8. 使用 radowgw-admin 命令为用户创建多因素身份验证 TOTP 令牌。