As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Instalando o AWS SDK para Ruby
<a name="setup-install"></a>

Esta seção inclui pré-requisitos e instruções de instalação do AWS SDK para Ruby.

## Pré-requisitos
<a name="aws-ruby-sdk-prerequisites"></a>

Antes de usar o AWS SDK for Ruby, você deve se autenticar com. AWS Para obter informações sobre a configuração da autenticação, consulte [Autenticação com o AWS uso do AWS SDK for Ruby](credentials.md).

## Instalar o SDK
<a name="installing-the-sdk"></a>

Você pode instalar o AWS SDK for Ruby como faria com qualquer gem do Ruby. As joias estão disponíveis em. [RubyGems](https://rubygems.org/gems/aws-sdk/) O AWS SDK para Ruby foi projetado para ser modular e é separado por. AWS service (Serviço da AWS) A instalação de todo o gem `aws-sdk` é grande e pode levar mais de uma hora. 

Recomendamos instalar apenas as gemas Serviços da AWS que você usa. Eles são nomeados como `aws-sdk-service_abbreviation` e a lista completa é encontrada na tabela [Serviços suportados](https://github.com/aws/aws-sdk-ruby/#supported-services) do arquivo README do AWS SDK for Ruby. Por exemplo, o gem para interface com o serviço Amazon S3 está disponível diretamente em [https://rubygems.org/gems/aws-sdk-s3](https://rubygems.org/gems/aws-sdk-s3).

### Gerenciador de versões do Ruby
<a name="installing-rvm"></a>

Em vez de usar o sistema Ruby, recomendamos usar um gerenciador de versões do Ruby, como o seguinte: 
+ [RVM](http://rvm.io/)
+ [chruby](https://github.com/postmodern/chruby)
+ [rbenv](https://github.com/rbenv/rbenv)

Por exemplo, se você estiver usando um sistema operacional Amazon Linux 2, os comandos a seguir podem ser usados para atualizar o RVM, listar as versões disponíveis do Ruby e, em seguida, escolher a versão que você deseja usar para desenvolvimento com o SDK for AWS Ruby. A versão mínima exigida do 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>

 Se você usa o [Bundler](http://bundler.io/), os comandos a seguir instalam a gem AWS SDK for Ruby para Amazon S3:

1. Instale o Bundler e crie o `Gemfile`:

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

1. Abra o criado `Gemfile` e adicione uma `gem` linha para cada gem AWS de serviço que seu código usará. Para acompanhar o exemplo do Amazon S3, adicione a seguinte linha ao final do arquivo:

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

1. Salve o Gemfile.

1. Instale as dependências especificadas em seu `Gemfile`:

   ```
   $ bundle install
   ```