安装适用于 Ruby 的 Amazon SDK - 适用于 Ruby 的 Amazon SDK
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

安装适用于 Ruby 的 Amazon SDK

此部分包括针对适用于 Ruby 的 Amazon SDK 的先决条件和安装说明。

先决条件

在使用适用于 Ruby 的 Amazon SDK 之前,必须使用 Amazon 进行身份验证。有关设置身份验证的信息,请参阅使用 Amazon 进行 SDK 身份验证

安装 SDK

您可以像安装任何 Ruby Gem 一样安装适用于 Ruby 的 Amazon SDK。这些 Gem 在 RubyGems 中提供。适用于 Ruby 的 Amazon SDK 采用模块化设计,并按照 Amazon Web Service各自独立。整个 aws-sdk Gem 较大,安装过程可能需要一个多小时。

我们建议仅安装您使用的 Amazon Web Services的相应 Gem。这些 Gem 的命名形式为 aws-sdk-service_abbreviation,完整列表见适用于 Ruby 的 Amazon SDK 自述文件的支持的服务表格。例如,用于与 Amazon S3 服务交互的 Gem 可直接从 aws-sdk-s3 中获得。

Ruby 版本管理器

我们建议不要使用系统 Ruby,而是使用如下所示的 Ruby 版本管理器:

例如,如果您使用的是 Amazon Linux 2 操作系统,则可以使用以下命令更新 RVM,列出可用的 Ruby 版本,然后选择想要在开发工作中与适用于 Ruby 的 Amazon SDK 配合使用的版本。要求的最低 Ruby 版本为 2.3。

$ rvm get head $ rvm list known $ rvm install ruby-3.1.3 $ rvm --default use 3.1.3

Bundler

如果使用 Bundler,则使用以下命令安装 Amazon S3 的适用于 Ruby 的 Amazon SDK Gem:

  1. 安装 Bundler 并创建 Gemfile

    $ gem install bundler $ bundle init
  2. 打开创建的 Gemfile,然后为代码将使用的每个 Amazon 服务 Gem 添加一个 gem 行。要按照 Amazon S3 示例进行操作,请将以下行添加到文件底部:

    gem "aws-sdk-s3"
  3. 保存 Gemfile。

  4. 安装 Gemfile 中指定的依赖项:

    $ bundle install