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

# 安装适用于 Ruby 的 S AWS DK
<a name="setup-install"></a>

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

## 先决条件
<a name="aws-ruby-sdk-prerequisites"></a>

在使用适用于 Ruby 的 AWS SDK 之前，必须使用进行身份验证 AWS。有关设置身份验证的信息，请参阅[AWS 使用 AWS 适用于 Ruby 的 SDK 进行身份验证](credentials.md)。

## 安装 SDK
<a name="installing-the-sdk"></a>

你可以像安装任何 Ruby gem 一样安装适用于 Ruby 的 AWS SDK。这些宝石可在以下网址购买[RubyGems](https://rubygems.org/gems/aws-sdk/)。 AWS 适用于 Ruby 的 SDK 采用模块化设计，并由以下部分隔开 AWS 服务。整个 `aws-sdk` Gem 较大，安装过程可能需要一个多小时。

我们建议仅安装供 AWS 服务 您使用的宝石。它们命名为 like`aws-sdk-service_abbreviation`，完整列表可在 AWS SDK for Ruby 自述文件的 “[支持的服务](https://github.com/aws/aws-sdk-ruby/#supported-services)” 表中找到。例如，用于与 Amazon S3 服务交互的 Gem 可直接从 [https://rubygems.org/gems/aws-sdk-s3](https://rubygems.org/gems/aws-sdk-s3) 中获得。

### Ruby 版本管理器
<a name="installing-rvm"></a>

我们建议不要使用系统 Ruby，而是使用如下所示的 Ruby 版本管理器：
+ [RVM](http://rvm.io/)
+ [chruby](https://github.com/postmodern/chruby)
+ [rbenv](https://github.com/rbenv/rbenv)

例如，如果您使用的是 Amazon Linux 2 操作系统，则可以使用以下命令更新 RVM，列出可用的 Ruby 版本，然后选择要使用适用于 Ruby 的 AWS SDK 进行开发的版本。所需的最低 Ruby 版本为 2.5。

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

### Bundler
<a name="bundler"></a>

 如果你使用 [Bundler](http://bundler.io/)，则使用以下命令安装适用于 Amazon S3 的 Ruby S AWS DK gem：

1. 安装 Bundler 并创建 `Gemfile`：

   ```
   $ gem install bundler
   $ bundle init
   ```

1. 打开创建`Gemfile`的，为你的代码将使用的每个 AWS 服务 Gem 添加一`gem`行。要按照 Amazon S3 示例进行操作，请将以下行添加到文件底部：

   ```
   gem "aws-sdk-s3"
   ```

1. 保存 Gemfile。

1. 安装 `Gemfile` 中指定的依赖项：

   ```
   $ bundle install
   ```